Pre-Upgrade Steps (upgrade from 1.2 to 1.3)
Update eyeglass user role in OneFS
If the Isilon clusters on your Eyeglass system have been provisioned using the eyeglass user belonging to the eyeglass-role with minimum privileges, the following updates are required prior to upgrading from Eyeglass Isilon Edition 1.2 to 1.3:
Rename the role from eyeglass-role to EyeglassAdmin
This is required as a the R1.3 for ssh access to the Isilon Clusters.
Update the EyeglassAdmin role with the additional privileges that are required for new R1.3 features as root user from Isilon command line (GUI will on occasion not update privileges for an existing role):
SSH Read-Only
Auth Read/Write
Audit Read/Write
Network Read/Write
SyncIQ Read/Write
Namespace Access Read-Only
Event Read-Only
HDFS Read-Only
Remote Support Read-Only
Snapshot Read-Only
SmartPools Read-Only
WORM Read-Only
Statistics Read-Only
Job Engine Read-Only
For isi command please go to the link here:
System Requirements:
The virtual machine running Eyeglass should be updated for:
4 vCPU
8 GB of RAM
The additional CPU are required to support multi-threading on systems with large number of shares/exports/quotas.
The VM can be upgraded by shutting down the VM edit the VM properties and starting the VM
Upgrade
IMPORTANT:
Eyeglass operation will be interrupted briefly during Upgrade for an Eyeglass service restart
It is recommended to take a VMware snapshot to backup the Eyeglass appliance prior to applying an update.
For Eyeglass updates, when more than one Eyeglass package update is available they all must be applied as there may be dependencies between the packages requiring all updates for Eyeglass to function properly. (Eyeglass packages begin with "eyeglass" in the package name.) If prompted, you must also say yes to external dependencies.
Online Upgrade
To do an online upgrade to 1.3 patch 3:
1. ssh to the Eyeglass appliance and sudo to root (command sudo su -) or login to the appliance as root.
2. Type 'service sca stop' to stop the Eyeglass service.
3. Once the prompt returns, type 'ps aux | grep sca' and confirm that service has indeed stopped and no process is returned.
IMPORTANT: If process has not stopped do not proceed with the upgrade. Please open a ticket at support.superna.net to request assistance.
4. Type ‘zypper refresh’ to refresh the rpm repository on the appliance.
5. Type ‘zypper up’ to apply the updates. In addition to any available OS updates, you should see 5 Eyeglass packages either new or for upgrade.
6. Enter ‘y’ to continue with the update. If prompted, you must also say ‘y’ to external dependencies.
7. Once the update is completed, confirm that the Eyeglass service is running again by typing 'service sca status'.
8. Login to the Eyeglass web page.
IMPORTANT: Refresh any open Eyeglass window to ensure that you have latest changes.
9. Open the About Eyeglass window and verify version numbers are as shown here for Release 1.3 patch 3.
Example:
login as: admin
Using keyboard-interactive authentication.
Password:
Last login: Mon Apr 27 17:08:18 2015 from dorothy-hp.internal.superna.net
Have a lot of fun...
admin@dseyeglass:~> sudo su -
admin's password:
dseyeglass13:~ # service sca stop
dseyeglass13:~ # ps aux | grep sca
root 29905 0.0 0.0 9008 684 pts/1 S+ 15:09 0:00 grep sca
dseyeglass:~ # zypper refresh
Retrieving repository 'eyeglass-1.2' metadata ..................................................................................................[done]
Building repository 'eyeglass-1.2' cache .......................................................................................................[done]
Repository 'openSUSE_13.1_OSS' is up to date.
Retrieving repository 'openSUSE_13.1_Updates' metadata .........................................................................................[done]
Building repository 'openSUSE_13.1_Updates' cache ..............................................................................................[done]
All repositories have been refreshed.
dseyeglass:~ # zypper up
Loading repository data...
Reading installed packages...
The following 5 NEW packages are going to be installed:
eyeglass_cli eyeglass_deps python-protobuf python-setuptools shellinabox
The following 18 packages are going to be upgraded:
DirectFB curl eyeglass_rest eyeglass_sca eyeglass_ui libcurl4 libdirectfb-1_6-0 libgudev-1_0-0 libpcre1 libpcre1-32bit libtasn1 libtasn1-6 libtiff5
libudev1 ntp systemd systemd-sysvinit udev
18 packages to upgrade, 5 new.
Overall download size: 185.5 MiB. After the operation, additional 8.2 MiB will be used.
Continue? [y/n/? shows all options] (y): y
Retrieving package eyeglass_sca-1.3-73.x86_64 (1/23), 168.5 MiB (356.5 MiB unpacked)
Retrieving: eyeglass_sca-1.3-73.x86_64.rpm .........................................................................................[done (3.4 MiB/s)]
Retrieving package python-setuptools-0.9.8-3.1.2.noarch (2/23), 310.5 KiB ( 1.3 MiB unpacked)
Retrieving: python-setuptools-0.9.8-3.1.2.noarch.rpm .............................................................................[done (275.8 KiB/s)]
Retrieving package python-protobuf-2.5.0-4.1.1.x86_64
… many more lines for retrieving and installing packages ...
dseyeglass13:~ # service sca status
sca.service - LSB: Run the SCA
Loaded: loaded (/etc/init.d/sca)
Active: active (running) since Fri 2015-06-05 15:09:57 UTC; 5s ago
Process: 29857 ExecStop=/etc/init.d/sca stop (code=exited, status=0/SUCCESS)
Process: 29921 ExecStart=/etc/init.d/sca start (code=exited, status=0/SUCCESS)
Offline Upgrade
To do an upgrade to 1.3 patch 3 offline:
1. Download the Offline install package from the Eyeglass Isilon release table for R1.3 patch 3 here.
2. SCP the offline package on to the appliance.
3. ssh to the Eyeglass appliance and sudo to root (command sudo su -) or login to the appliance as root.
4. Make the offline package executable: chmod 755 <filename>
5. Type 'service sca stop' to stop the Eyeglass service.
6. Once the prompt returns, type 'ps aux | grep sca' and confirm that service has indeed stopped and no process is returned.
IMPORTANT: If process has not stopped do not proceed with the upgrade. Please open a ticket at support.superna.net to request assistance.
7. Run the installer: ./<filename>
8. In addition to any available OS updates, you should see 5 Eyeglass packages either new or for upgrade.
9. Enter ‘y’ to continue with the update. If prompted, you must also say ‘y’ to external dependencies.
10. Once the update is completed, start the sca service: service sca start
11. Verify sca service is running: service sca status
# service sca status
sca.service - LSB: Run the SCA
Loaded: loaded (/etc/init.d/sca)
Active: active (running) since Tue 2015-05-12 18:52:11 UTC; 2min 32s ago
12. Login to the Eyeglass web page.
IMPORTANT: Refresh any open Eyeglass window to ensure that you have latest changes.
13. Check the About Eyeglass window and verify version numbers are as shown here for Release 1.3 patch 3.
Example:
# chmod 755 eyeglass-offline-1.3-4.run
# service sca stop
# ps aux | grep sca
root 29905 0.0 0.0 9008 684 pts/1 S+ 15:09 0:00 grep sca
# ./eyeglass-offline-1.3-4.run
Verifying archive integrity... All good.
Uncompressing Eyeglass offline installer...........
Ignoring repository 'eyeglass-1.2' because of 'no-remote' option.
Ignoring repository 'openSUSE_13.1_OSS' because of 'no-remote' option.
Ignoring repository 'openSUSE_13.1_Updates' because of 'no-remote' option.
Loading repository data...
Reading installed packages...
Resolving package dependencies...
The following 5 NEW packages are going to be installed:
eyeglass_cli eyeglass_deps python-protobuf python-setuptools shellinabox
The following 3 packages are going to be upgraded:
eyeglass_rest eyeglass_sca eyeglass_ui
3 packages to upgrade, 5 new.
Overall download size: 179.7 MiB. After the operation, additional 8.1 MiB will
be used.
Continue? [y/n/? shows all options] (y): y
...many more lines for retrieving and installing packages….
# service sca start
# service sca status
sca.service - LSB: Run the SCA
Loaded: loaded (/etc/init.d/sca)
Active: active (running) since Tue 2015-05-12 18:00:47 UTC; 1min 5s ago
Post Upgrade (upgrade from 1.2 to 1.3)
Email Server Configuration
In Eyeglass 1.3, the email default setting of TLS has changed from enabled to disabled.
If you have an email server configured and require TLS to be enabled, follow these steps to update your Eyeglass email configuration:
Go to Eyeglass Main Menu.
Select Notification Center.
Select Manage Email Addresses tab.
Find the email address for update in dropdown list of email recipient addresses.
Check the Enable TLS box.
Type the password.
Select Test Email Setting (optional).
Select Update.
Repeat for email recipient where TLS needs to be enabled.
