One or more immutable files are preventing cPanel and WHM from updating on your serve

SoftDux

Well-Known Member
May 27, 2006
1,024
5
168
Johannesburg, South Africa
cPanel Access Level
Root Administrator
Interestingly, 4 of our servers gave me this error message this morning:



The find-immutable-files script, run by the cPanel & WHM update process (/scripts/upcp), found 3 files distributed by cPanel marked as immutable on your server.

cPanel & WHM cannot update until you make these files mutable. The list of immutable files is located on your server at "/var/cpanel/immutable_files".

The files found are:

/usr/local/cpanel/base/frontend/x/mail/email.html
/usr/local/cpanel/base/frontend/xmail/index.html
/usr/local/cpanel/base/frontend/xmail/mail/email.html

The find-immutable-files script was run, because there was no record of it ever having run before..


Did anyone else get it?

And WHY does this happen? Please don't tell me I messed up the server, cause unlike you we don't go into folder like /usr/local/cpanel/base to change stuff we know nothing about.

The way I see it this is a cPanel bug, and they should fix it.
 

cPanelMichael

Administrator
Staff member
Apr 11, 2011
47,910
2,212
363
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

Hello :)

Immutable files are files with an additional file attribute set to prevent their deletion/modification. The message you received indicates that cPanel found files on your system that should not have the immutable flag. The script was implemented into the cPanel update because immutable files have the potential to disrupt cPanel operability.

It does not indicate a problem with your system, but rather it indicates the immutable flag should be removed from the listed files to avoid future problems on your system.

You can remove the immutable flag from these files using the "chattr -i" command. EX:

Code:
chattr -i /usr/local/cpanel/base/frontend/x/mail/email.html
chattr -i /usr/local/cpanel/base/frontend/xmail/index.html
chattr -i /usr/local/cpanel/base/frontend/xmail/mail/email.html
Thank you.
 

SoftDux

Well-Known Member
May 27, 2006
1,024
5
168
Johannesburg, South Africa
cPanel Access Level
Root Administrator
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

Michael,

I know very well what Immutable files are, thank you.


BUT, I don't see why I should fix your problems. Your actually saying "you changed those files, so you need to fix them" - which is BS. cPanel suddenly introduces this new security check, which now causes new problems again.

So YOU, as cPanel, need to sort this out.
 

cPanelDon

cPanel Quality Assurance Analyst
Staff member
Nov 5, 2008
2,545
12
268
Houston, Texas, U.S.A.
cPanel Access Level
DataCenter Provider
Twitter
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

Interestingly, 4 of our servers gave me this error message this morning:

Did anyone else get it?

And WHY does this happen? Please don't tell me I messed up the server, cause unlike you we don't go into folder like /usr/local/cpanel/base to change stuff we know nothing about.

The way I see it this is a cPanel bug, and they should fix it.
The files mentioned are not set immutable by cPanel & WHM. If you believe there is a bug involved, please submit a support request so that the issue can be thoroughly investigated.

I recommend checking the timestamps on the files involved to determine when they were last changed or modified, in an attempt to determine when the immutable attribute may have been applied; the following is an example using "stat" followed by "lsattr" to display the current file attributes (of which a lowercase "i" indicates the problematic immutable bit):
Code:
# stat /path/to/file
# lsattr /path/to/file
To make a file mutable, simply remove the immutable attribute; the following example shows how to accomplish this task:
Code:
# chattr -V -i /path/to/file
 

cPanelDon

cPanel Quality Assurance Analyst
Staff member
Nov 5, 2008
2,545
12
268
Houston, Texas, U.S.A.
cPanel Access Level
DataCenter Provider
Twitter
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

Michael,

I know very well what Immutable files are, thank you.

BUT, I don't see why I should fix your problems. Your actually saying "you changed those files, so you need to fix them" - which is BS. cPanel suddenly introduces this new security check, which now causes new problems again.

So YOU, as cPanel, need to sort this out.
When available, please let us know your support ticket ID number so that we may follow-up internally; please keep in mind that to accurately investigate the issue it will require root access to the affected system.
 

9xlinux

Well-Known Member
Verifed Vendor
Dec 20, 2009
185
0
66
cPanel Access Level
Root Administrator
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

I have received the same Alert email where Whmsonic is installed and reported files are whmsonic shoutcast cpanel plugin files.
It's very difficult to do it at all servers if someone has many servers.
 

InterServed

Well-Known Member
Jul 10, 2007
268
14
68
cPanel Access Level
DataCenter Provider
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

The find-immutable-files script, run by the cPanel & WHM update process (/scripts/upcp), found 3 files distributed by cPanel marked as immutable on your server.

cPanel & WHM cannot update until you make these files mutable. The list of immutable files is located on your server at "/var/cpanel/immutable_files".

The files found are:

/usr/local/cpanel/base/frontend/x/mail/email.html
/usr/local/cpanel/base/frontend/xmail/index.html
/usr/local/cpanel/base/frontend/xmail/mail/email.html

The find-immutable-files script was run, because there was no record of it ever having run before..
We did get the same report , so it seems that It's not something changed/altered by our/customer(s) end.
 

cPanelTristan

Quality Assurance Analyst
Staff member
Oct 2, 2010
7,607
40
248
somewhere over the rainbow
cPanel Access Level
Root Administrator
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

Files are not set immutable by any cPanel configurations or scripts. Are the files in question set to be immutable currently or is it improperly reporting them as such?

Code:
lsattr /usr/local/cpanel/base/frontend/x/mail/
Please let us see the output of that command. If they are set to immutable, cPanel would not have made that change, but something else installed might have done so.
 

InterServed

Well-Known Member
Jul 10, 2007
268
14
68
cPanel Access Level
DataCenter Provider
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

Files are not set immutable by any cPanel configurations or scripts. Are the files in question set to be immutable currently or is it improperly reporting them as such?

Code:
lsattr /usr/local/cpanel/base/frontend/x/mail/
Please let us see the output of that command. If they are set to immutable, cPanel would not have made that change, but something else installed might have done so.
Code:
[email protected] [~]# lsattr /usr/local/cpanel/base/frontend/x/mail/
-------A----- /usr/local/cpanel/base/frontend/x/mail/dodelblock.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/doaddfwd.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/boxtrapper.css.gz
-------A----- /usr/local/cpanel/base/frontend/x/mail/main.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dodellist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dospamassassinconfig.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/addfwd.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/passwdpop.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/editquota.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/spamassassinconfig.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/showroute.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/queuesearch.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/def.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dosetmx.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/delfwd.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dosetdef.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/addblock.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/boxtrapper.css
-------A----- /usr/local/cpanel/base/frontend/x/mail/conf.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/side.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/delspambox.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/autores.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/pops.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dopasswdpop.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/doadddfwd.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/manage.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/clearspambox.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/multimsgaction.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/showpops.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/aging.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/addlist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/realdodellist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/addpop2.html
----i--A----- /usr/local/cpanel/base/frontend/x/mail/email.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/doaddars.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/blacklist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/doaddblock.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/webmailform.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/saveconf.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/editmsgs.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/doaging.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/adddfwd.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/addspam.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/delpop.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/delspam.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dodeldfwd.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/clientconf.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/addspambox.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/doaddlist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/passwdlist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dodelfwd.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/showlog.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/showq.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/saveforwardlist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/route.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/spam.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/delblock.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dodelpop.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/editlists.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/addars.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/addspamfilter.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/forwardlist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/filtertest.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dfwd.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dodelautores.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/mx.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/lists.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/showpop.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/setmx.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/fwds.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/ignorelist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/doaddpop.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/editmsg.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/doeditquota.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/addpop.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/changestatus.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/dopasswdlist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/whitelist.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/resetmsg.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/setdef.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/msgaction.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/boxtrapper.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/blocks.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/showmsg.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/realdelpop.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/savefile.html
 

cPanelTristan

Quality Assurance Analyst
Staff member
Oct 2, 2010
7,607
40
248
somewhere over the rainbow
cPanel Access Level
Root Administrator
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

Someone or something other than cPanel has set this file to immutable on the system:

Code:
----i--A----- /usr/local/cpanel/base/frontend/x/mail/email.html
It is not normally set to immutable:

Code:
[~]# lsattr /usr/local/cpanel/base/frontend/x/mail/email.html
-------A----- /usr/local/cpanel/base/frontend/x/mail/email.html
This is definitely not cPanel switching the flag to immutable on the files in question. The purpose of the immutable file check utility is to ensure core files are able to be updated. The proper method to prevent a file from update is not to set it immutable but to add it to the cpanel exclusion file:

Code:
echo "/usr/local/cpanel/base/frontend/x/mail/email.html" >> /etc/cpanelsync.exclude
Going forward, whenever a file needs to be kept from update, it should be excluded from update rather than set to immutable, although I recommend against changing core files anyway, since the purpose of branding and theme creation would be to revise the files in another style or theme.
 

SHaRKTooTH

Registered
May 31, 2003
1
0
151
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

I have the same 3 files listed. Could this be due to an assp install/mod?

I am hesitant to remove the immutable attribute until I know how/why it was set in the first place since this doesn't seem to be a one off issue.
 

shortfork

Well-Known Member
Sep 4, 2006
63
0
156
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

I also received the alert message from my cPanel box..

"One or more immutable files are preventing cPanel and WHM from updating on your server.‏"

with a bit different list than the previous posters..

Code:
/usr/local/cpanel/cgi-sys/helpdesk.cgi
/usr/local/cpanel/cgi-sys/formmail.cgi
/usr/local/cpanel/cgi-sys/formmail.pl
/usr/local/cpanel/cgi-sys/signup.cgi
/usr/local/cpanel/cgi-sys/FormMail-clone.cgi
/usr/local/cpanel/cgi-sys/realsignup.cgi
/usr/local/cpanel/cgi-sys/FormMail.pl
/usr/local/cpanel/cgi-sys/FormMail.cgi
/usr/local/cpanel/cgi-sys/realhelpdesk.cgi
/usr/local/cpanel/cgi-sys/cgiemail
I can "Fix" this but would like you cPanel guys to have a look before I make these files usable... I'll put in a TT

Wayne
 

SoftDux

Well-Known Member
May 27, 2006
1,024
5
168
Johannesburg, South Africa
cPanel Access Level
Root Administrator
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

why was this never a problem for cPanel upgrades, until now?

And why would anyone login to a server and change those very specific files? I bet most people who use cPanel didn't even know those files existed on the server.



Interestingly I'm not getting these reports from some of our other servers as well.
 

SoftDux

Well-Known Member
May 27, 2006
1,024
5
168
Johannesburg, South Africa
cPanel Access Level
Root Administrator
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

It looks like ASSP Deluxe (ASSP Deluxe for cpanel : ASSP how to for cpanel , cpanel antispam and antivirus , WHM addon , vps antispam solution, smtp proxy antispam, email antivirus) messed up the permissions on those files.

Here's Radio_Head's PM to me:


Hello

following files are chattr +i by ASSP Deluxe to avoid changes in ASSP Deluxe when cPanel executes a cpanel update.

You can ignore the cPanel message . Or simply execute this

# chattr -i /usr/local/cpanel/base/frontend/x/mail/email.html
# chattr -i /usr/local/cpanel/base/frontend/xmail/index.html
# chattr -i /usr/local/cpanel/base/frontend/xmail/mail/email.html


You was not receiving this warning in the past , because now cPanel alert you
that some file can't be updated when a "chattr +i" to prevent a change is applied.

If you have any other question please write to [email protected]

Regards
Gabriel

He refuses to comment here though and feel that it's cPanel's fault:

I have nothing to comment , cPanel should comment about it , they did this new email notification.


so it looks like we're at the mercy of 2 parties blame-shifting and not taking responsibility for their own actions, on either side.




The fact of the matter, either way around, is that cPanel updates can't be performed:
The find-immutable-files script, run by the cPanel & WHM update process (/scripts/upcp), found 3 files distributed by cPanel marked as immutable on your server.

cPanel & WHM cannot update until you make these files mutable. The list of immutable files is located on your server at "/var/cpanel/immutable_files".

The files found are:

/usr/local/cpanel/base/frontend/x/mail/email.html
/usr/local/cpanel/base/frontend/xmail/index.html
/usr/local/cpanel/base/frontend/xmail/mail/email.html

The find-immutable-files script was run, because one or more immutable files found on a previous run (Sun May 15 04:36:20 2011) still remained, and had not been made mutable.



The way I see it, either ASSP Deluxe needs to update their code to change the file permissions back, OR cPanel has to "relax" their script a bit and allow for files with such permissions to exist with existing upgrades. Although, I suspect that could be a problem if cPanel actually needs to replace those folders with newer scripts?
 
Last edited:

Radio_Head

Well-Known Member
Verifed Vendor
Feb 15, 2002
2,051
1
343
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

>
Interestingly I'm not getting these reports from some of our other servers as well.
>

you are not receiving these reports in other servers because the chattr was applied about 3 years ago
and only for cPanel x theme . In x3/rvskin it is not more required , so you will not receive the email notification for these themes.

However I do not think these immutable files are blocking cpanel update process , am I correct ?
If I am not correct I can remove the "chattr +i" from x theme since it's no more required too.
 
Last edited:

SoftDux

Well-Known Member
May 27, 2006
1,024
5
168
Johannesburg, South Africa
cPanel Access Level
Root Administrator
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

>
Interestingly I'm not getting these reports from some of our other servers as well.
>

you are not receiving these reports in other servers because the chattr was applied about 3 years ago
and only for cPanel x theme . In x3/rvskin it is not more required , so you will not receive the email notification for these themes.


Sorry, that was a typo, I actually meant:

Interestingly I'm now getting these reports from some of our other servers as well.


However I do not think these immutable files are blocking cpanel update process , am I correct ?
If I am not correct I can remove the "chattr +i" from x theme since it's no more required too.
According to the email, it is blocking the updates:


The find-immutable-files script, run by the cPanel & WHM update process (/scripts/upcp), found 3 files distributed by cPanel marked as immutable on your server.

cPanel & WHM cannot update until you make these files mutable. The list of immutable files is located on your server at "/var/cpanel/immutable_files".

The files found are:

/usr/local/cpanel/base/frontend/x/mail/email.html
/usr/local/cpanel/base/frontend/xmail/index.html
/usr/local/cpanel/base/frontend/xmail/mail/email.html

The find-immutable-files script was run, because one or more immutable files found on a previous run (Sun May 15 04:36:20 2011) still remained, and had not been made mutable.
 

cPanelTristan

Quality Assurance Analyst
Staff member
Oct 2, 2010
7,607
40
248
somewhere over the rainbow
cPanel Access Level
Root Administrator
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

This is the x theme as was mentioned and that theme is deprecated now for x3 theme. The immutable flags need to be taken off the files for the update to proceed.

You are certainly welcome to submit a feature request to request that the utility be allowed to proceed upon finding these files. The feature request area is the following:

Feature Requests for cPanel and WHM
 

Radio_Head

Well-Known Member
Verifed Vendor
Feb 15, 2002
2,051
1
343
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

ASSP Deluxe 4.7.7 will remove immutable flags from (It should be available today)

/usr/local/cpanel/base/frontend/x/mail/email.html
/usr/local/cpanel/base/frontend/xmail/index.html
/usr/local/cpanel/base/frontend/xmail/mail/email.html
 
Last edited:

cPanelKenneth

cPanel Development
Staff member
Apr 7, 2006
4,608
77
308
cPanel Access Level
Root Administrator
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

The email states the immutable bit blocks cPanel & WHM from upgrading. This is erroneous and is in the process of being changed. The message should really state something like "cPanel & WHM cannot update these files until...." This change is being handled in case 49604.
 

Radio_Head

Well-Known Member
Verifed Vendor
Feb 15, 2002
2,051
1
343
Re: One or more immutable files are preventing cPanel and WHM from updating on your s

The email states the immutable bit blocks cPanel & WHM from upgrading. This is erroneous and is in the process of being changed. The message should really state something like "cPanel & WHM cannot update these files until...." This change is being handled in case 49604.
Thank you I supposed it (an immutable file in a cpanel theme is not a valid reason to block a cpanel update).