How To Apply a Patch

Patches are small changes that are confined to one or a few pieces of the Access Anywhere Server code. They are almost always issued for the purpose of resolving an issue that is affecting one or a small number of customers. The patches are only provided to the affected customers. Customers who are not affected by the issue that a patch resolves need not concern themselves with the patch.

Nasuni seldom issues patches, preferring to combine sets of changes into service packs which we release frequently. On those occasions when we do see fit to issue a patch, the changes included in the patch are always included in a subsequent service pack. In most cases this will be the next service pack to be released after the patch was developed.

If a patch is appropriate then Nasuni will provide you with a link to a compressed tar file <patch_name>.tgz containing the patch.

• Check the applicability of the patch. Patches are only provided for specific releases.
• Test first on a non-production system if you have one available.
• Patches should be applied to production systems during a service window.
• A backup of the server should be made during the service window and prior to applying the patch.
• If the database is external to the appliance then the database should also be backed up.
• A confidence test of the patched system should be conducted within the service window. If the confidence test exposes an issue and a rollback is required, the appliance backup should be restored. If the database is external, the database backup should be restored.

Note that these steps should be completed for each appliance in a multi-node (HA) system.

Copy the patch file PATCH_FILE.tgz to the appliance using scp or any other tool

Login into the appliance as smeconfiguser

Become root

su - root

cd to var/www/smestorage/patches

cd /var/www/smestorage/patches

move the copied patch file to /var/www/smestorage/patches

mv /home/smeconfiguser/PATCH_FILE.tgz .

change the owner of the file to smestorage

chown smestorage:smestorage PATCH_FILE.tgz

su to smestorage

su - smestorage

cd to patches

cd patches

Apply the patch

./patch -patch PATCH_FILE.tgz

If you encounter any issues during these steps, please contact Support.

Change to the smestorage user by first logging in as smeconfiguser and becoming root

su - root
su - smestorage

cd to patches

cd patches

Roll back the patch

./patch -rollback