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.

Login

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:

1. You can access the console directly by connecting a screen and keyboard to the server. Then you will have to log in with root and the password you have set during the installation.
2. 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 no-deps, keep-required or 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)=2.6.2.1-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