OpenFiler 2.99 Update Guide
I strictly recommend you to do the updating process before doing any other settings, so if anything goes wrong, you can just reinstall the whole system!
Update via the Web Interface
- Navigate to your OpenFiler web interface via https://<IP address or hostname>:446
You can ignore the security certificate warning message, as it only shows up because the certificate is a self signed one. In Firefox you can create an exception rule so you will not get bothered by this warning again.
I assume that you have not changed the default login yet, as this should be a fresh install of OpenFiler 2.99.1. So log in with the user name
openfiler and the password
password. Of course changing this user should be the first thing to do right after the update process.
- Now navigate to "System → System Update"
Next click on "Launch system update". This will take some time, but finally it will show you all the packages that can be updated. If it doesn't, please click here to go on via the CLI.
Update selected Packages only
Now check the tick box next to "Update All Packages". This will select all packages but also the checkbox next to it saying "Background Update". Get sure to uncheck this one!
If you leave this tick box selected, it is difficult to find out when all the updates are finished. You will have to check the logs then, but for me this never worked well.
Next it is very important to deselect all packages that are not able to be installed via the GUI! Your list may look slightly different than mine, but if you have the following packages, do not install them via the web interface:
This is a table I have created after weeks of frustrating tries to find the perfect way for installation. So remove the tick in the checkboxes next to these packages! It is also a very good idea to copy and paste the packages, just to get sure that you don't forget an update. Otherwise it may be difficult to get to the current state und finish the update process.
Afterwards you can press "Install Updates". The screen should then look something like this:
- At the end it will look like this:
- Copy and paste these packages, too
- Now you should do a restart
- Close the update screen and click on "Shutdown/Reboot"
- Select "Reboot" and press "Shutdown"
- Close your web browser
- When the reboot is finished, open the browser and access the OpenFiler web interface again
- Log in and go to "System → System Update"
If you see the screen above now, this is really no problem. It is just a sign that you have installed all updates that can be installed via the GUI already! All other packages have to be updated via the command line interface (CLI) now.
If you see the screen where you can choose packages to install again, it is also OK. In this case you can go on as described above, but do not install the following packages:
These will still not work or even crash your install! So go on with accessing the OpenFiler shell. It may be wise to close the update screen and log out of the GUI first.
Update via the CLI
For the next step you generally have two options, depending on what you prefer:
- You can access the console directly by connecting a screen and keyboard to the server. Then you will have to log in with
rootand the password you have set during the installation.
- The second option is to connect remotely via SSH. As it depends on your operating system, I won't go into much detail.
Login via SSH
As I only have Windows at work, I use PuTTY via mRemote. The security alert belongs to the certificate again, so you can click "Yes" and it will not ask you again.
Install Updates with Conary
Of course you can always try to run a
conary updateall first! This is the normal way of installing all available updates, but is unfortunately quite problematic and does mostly not work. I would recommend you not to try additional options like
replace-files, as this will most likely just crash your system!
If you got referenced here because updating via the web interface didn't work at all, please just try a
conary updateall and copy-paste all packages that do not succeed! Afterwards you can just go on with the next steps here.
Try my way, it may seem a bit circumstantial and complicated, but I have set up several OpenFiler 2.99 installations now and this update process is the only one that simply always worked! Now start installing the missing packages one after another! The command for this is
conary update followed by the name of the package (which you can find in my table or on your own list). Start with the following:
conary update gtk conary update openldap-clients conary update ca-certificates conary update openfiler conary update autofs conary update libgssglue conary update php-cgi conary update php-soap conary update php-xsl
- The output should look something like this:
[root@atsan001 ~]# conary update gtk no new troves were found [root@atsan001 ~]# conary update openldap-clients Applying update job: Update openldap-clients(:runtime) (2.4.19-0.0.3-1 -> 2.4.19-0.0.4-1) Install openldap-clients:doc=2.4.19-0.0.4-1 [root@atsan001 ~]# conary update ca-certificates no new troves were found [root@atsan001 ~]# conary update openfiler Applying update job: Update openfiler(:config :runtime) (r_15ec1bb936e555e65adce24a9b0595124e46b0ee-1-1 -> 4d1fb58-1-1) Install openfiler:supdoc=4d1fb58-1-1 [openfiler] changing group /etc/shadow [openfiler] Stopping openfiler: [ OK ] [openfiler] Starting openfiler: [ OK ] [openfiler] Stopping NetworkManager daemon: [FAILED] [root@atsan001 ~]# conary update autofs Applying update job: Update autofs(:config :lib :runtime) (5.0.5-1-1 -> 5.0.5-2-1) Install autofs:doc=5.0.5-2-1 Install autofs:supdoc=5.0.5-2-1 [root@atsan001 ~]# conary update libgssglue no new troves were found [root@atsan001 ~]# conary update php-cgi Applying update job: Install php-cgi(:doc :runtime)=5.3.8-1-1 [root@atsan001 ~]# conary update php-soap Applying update job: Update php-soap(:config :lib) (5.2.11-1-1 -> 5.3.8-1-1) Install php-soap:devellib=5.3.8-1-1 [root@atsan001 ~]# conary update php-xsl Applying update job: Update php-xsl(:config :lib) (5.2.11-1-1 -> 5.3.8-1-1) Install php-xsl:devellib=5.3.8-1-1
Just a short notice to that:
no new troves were found means that this package is on the most current state already.
Applying update job says what it does: it installs the update.
It is ok that OpenFiler is not able to stop the
NetworkManager daemon, it is not even running (and this is how it should be).
Install missing Packages in correct Order
- Now do another reboot!
- Go on with the following packages:
conary update openldap --resolve --replace-files conary update php conary update php-pam-auth conary update php-ncurses conary update scsi-target-utils=openfileresa.rpath.org@esa:openfileresa-3.0-rhel-devel/1.0.4-3-1 conary update util-linux --resolve --replace-files conary update group-core --no-deps --resolve --replace-files conary update cups --no-deps --resolve --replace-files conary update dbus --resolve --replace-files conary update php-openfiler
The order of the
php packages is very important! Do always install
php first, then
php-pam-auth and finally
php-ncurses, otherwise it will not work. Also
php-openfiler should be the last of these packages installed! The output should look like this:
[root@atsan001 ~]# conary update openldap --resolve --replace-files Applying update job: Update openldap(:config :lib :runtime) (2.4.19-0.0.3-1 -> 2.4.19-0.0.4-1) Install openldap:devel=2.4.19-0.0.4-1 Install openldap:devellib=2.4.19-0.0.4-1 Install openldap:doc=2.4.19-0.0.4-1 Install openldap:supdoc=2.4.19-0.0.4-1 [root@atsan001 ~]# conary update php Applying update job: Update php(:config :data :lib :runtime) (5.2.11-1-1 -> 5.3.8-1-1) Install php:devel=5.3.8-1-1 Install php:devellib=5.3.8-1-1 Install php:doc=5.3.8-1-1 Install php:supdoc=5.3.8-1-1 [root@atsan001 ~]# conary update php-pam-auth Applying update job: Update php-pam-auth(:config :lib) (4.0-4-1 -> 4.0-5-1) Install php-pam-auth:supdoc=4.0-5-1 [root@atsan001 ~]# conary update php-ncurses Applying update job: Install php-ncurses(:lib)=1.0.1-1-1 [root@atsan001 ~]# conary update scsi-target-utils=openfileresa.rpath.org@esa:openfileresa-3.0-rhel-devel/1.0.4-3-1 Applying update job: Install scsi-target-utils(:config :doc :runtime :supdoc)=1.0.4-3-1 [root@atsan001 ~]# conary update util-linux --resolve --replace-files Applying update job: Update util-linux(:config :lib :locale :runtime) (2.18-1-1 -> 2.19.1-3-1) Install util-linux:devel=2.19.1-3-1 Install util-linux:devellib=2.19.1-3-1 Install util-linux:doc=2.19.1-3-1 Install util-linux:supdoc=2.19.1-3-1 [root@atsan001 ~]# conary update group-core --no-deps --resolve --replace-files Applying update job 1 of 2: Install linux-firmware(:lib)=20110731-1-1 Erase slang(:lib)=1.4.9-6-0.1 Applying update job 2 of 2: Update group-core (2.99.1-35-2 -> 2.99.2-5-1) [root@atsan001 ~]# conary update cups --no-deps --resolve --replace-files Applying update job: Update cups(:config :data :lib) (1.4.3-4-1 -> 1.4.8-2-1) Install cups:devel=1.4.8-2-1 Install cups:devellib=1.4.8-2-1 Install cups:doc=1.4.8-2-1 Install cups:locale=1.4.8-2-1 Install cups:runtime=1.4.8-2-1 Removing 2 of 2 (100%)...warning: group sys does not exist - using root [root@atsan001 ~]# conary update dbus --resolve --replace-files Applying update job: Update dbus(:runtime) (1.4.0-0.3-1 -> 1.4.6-0.3-1) Install dbus:config=1.4.6-0.3-1 Install dbus:data=1.4.6-0.3-1 Install dbus:devel=1.4.6-0.3-1 Install dbus:devellib=1.4.6-0.3-1 Install dbus:doc=1.4.6-0.3-1 Install dbus:lib=1.4.6-0.3-1 Install dbus:supdoc=1.4.6-0.3-1 [root@atsan001 ~]# conary update php-openfiler Applying update job: Update php-openfiler(:config :lib) (0.1-2-1 -> 0.1-3-1)
Check for available Updates
For more details about the commands used here please refer to the troubleshooting section! At last do another reboot. Afterwards we can install the last missing package:
conary update group-openfileresa-appliance --keep-required
Finally do a
conary updateall to check if all updates have been applied! The output should look like this:
[root@atsan001 ~]# conary update group-openfileresa-appliance --keep-required warning: keeping dbus-glib:lib - required by at least ModemManager:lib warning: keeping guile:data - required by at least guile:lib warning: keeping guile:lib - required by at least gnutls:lib warning: keeping libidn:lib - required by at least elinks:runtime warning: keeping openslp:config - required by at least openslp:lib warning: keeping openslp:lib - required by at least cups:runtime warning: keeping slib:data - required by at least guile:data Applying update job 1 of 3: Erase dbus(:config :data :devel :devellib :lib)=1.2.4-1-1 Erase libtool(:lib)=1.5.24-3-0.1 Erase libxml2(:python)=2.6.30-3-0.1 Erase libxslt(:python)=1.1.24-2-0.1 Erase portmap(:runtime)=4.0-11-0.1 [initscript] Stopping portmap: [ OK ] Applying update job 2 of 3: Erase python-hashlib(:python)=20081119-1-1 Erase python-multiprocessing(:python)=126.96.36.199-1-1 Applying update job 3 of 3: Update group-openfileresa-appliance (2.99.1-35-2 -> 2.99.2-5-1) [root@atsan001 ~]# conary updateall no new troves were found
Again see the troubleshooting section for more information! Then do a very last reboot. If you then log in through the GUI and go to "System → System Update" again you should be provided with the following screen:
This means that everything was working correctly and you have been able to patch OpenFiler with the most current updates! If you were facing problems during the manual installation or have other packages please check OpenFiler 2.99 Update Troubleshooting