Upgrade Appliance
From Swivel Knowledgebase Wiki
Contents |
Overview
This article explains the step by step process to upgrade the appliance using the latest appliance update, 2.0.3, which will bring the appliance version up to 2.0.12. This patch will upgrade OS packages, the CMI menu system and underlying scripts.
Note that this will not upgrade the PINsafe software version. To upgrade the PINsafe software refer to Upgrade PINsafe. For information on upgrading the proxy software refer to How to upgrade the appliance proxy for PINsafe 3.8. For information on upgrading the reset PIN see ResetPIN upgrade for PINsafe 3.8 How To Guide.
There are two patch files available depending upon which version of the appliance you are upgrading. From appliance version 2.0.9a an automated patch update system was introduced. Should you have an appliance version which is older, the update will require manual command line work.
Refer to the Appliance Versions FAQ article if you need to clarify your appliance version.
Prerequisites
- This update is suitable only for appliances which have a Console Management Interface menu system. Any previous versions of the appliance are not upgradable;
- Please ensure that you have DRAC access available, since this update will include updates to the Console Management Interface scripts, which are an essential element to the SSH login. DRAC is a last resort for access should you encounter any unforeseen issues during the upgrade;
- Incorrect application of the patch has the potential to be service affecting. Please ensure that you conduct the update during UK working hours and involve your PINsafe reseller to minimise risk.
- Before proceeding, login to the appliance and take a screenshot, or copy and paste the entries on the Version Information screen, so that you are able to recall the previous versions if required. To get to the Version Information screen, select: Advanced Menu -> Version Information.
Upgrade Process for appliances 2.0.9a or greater
1. Download the patch here: https://fs.swivelsecure.com/appliance/downloads/patch/patch.p2.0.3.tar.gz
2. Using WinSCP, upload the patch to the /backups/upload directory on the appliance;
3. Login via SSH. From the CMI menu, (Note: these options only appear after the upgrade file is uploaded), select:
- Advanced Menu
- Update Appliance/PINsafe
4. Follow the on-screen instructions;
5. Once the update has completed, exit out of the CMI menu using the "0." option.
6. Login via SSH once more. You will notice a backup take place;
7. The upgrade is now complete. Check the Version Information screen once again to verify that the versions have been updated. From the CMI menu, select:
- Advanced Menu
- Version Information
Upgrade Process for appliances 2.0.9 or older
1. Download the patch here: https://fs.swivelsecure.com/appliance/downloads/patch/swivel-update1-2.0.12r2-1.noarch.rpm
2. Using WinSCP, upload the patch to the /root directory on the appliance;
3. Login via SSH. From the CMI menu, select:
- Advanced Menu
- Command Line
Enter the command line password;
4. Enter the following commands on the command line to install the patch:
cd /root rpm --force -ivh swivel-update1-2.0.12r2-1.noarch.rpm cd /root/update ./update_now.sh
Follow the on-screen prompts;
5. Once the update has completed, exit from the command line by typing the exit command. Then logout of the CMI menu using the "0." option.
6. Login via SSH once more. You will notice a backup take place;
7. The upgrade is now complete. Check the Version Information screen once again to verify that the versions have been updated. From the CMI menu, select:
- Advanced Menu
- Version Information
Alternative Patch Download Options
If you know that the PINsafe appliance has direct access to the Internet, you can use the methods below to download the patch straight to the appliance, without having to use a web browser and then manually upload the patch to the appliance.
For appliances 2.0.9a or greater
Direct on the appliance you can run this command to retrieve the file directly and store it in /backups/upload
wget --no-check-certificate -P /backups/upload https://fs.swivelsecure.com/appliance/downloads/patch/patch.p2.0.3.tar.gz
For appliances 2.0.9 or older
Direct on the appliance you can run this command to retrieve the file directly and store it in /root
wget --no-check-certificate -P /root https://fs.swivelsecure.com/appliance/downloads/patch/swivel-update1-2.0.12r2-1.noarch.rpm
Known Issues
- You may see an error referring to line 60. This can be ignored and is a known issue.
