Eyeglass Isilon Edition Upgrade Procedure 1.3 Patch 3


Pre/Post Upgrade Steps are for upgrades from 1.2 to 1.3.

If Pre-Upgrade Steps have already been executed, you can go directly to the upgrade steps.

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:


  1. Rename the role from eyeglass-role to EyeglassAdmin

This is required as a the R1.3 for ssh access to the Isilon Clusters.


  1. 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:

  1. Go to Eyeglass Main Menu.

  2. Select Notification Center.

  3. Select Manage Email Addresses tab.

  4. Find the email address for update in dropdown list of email recipient addresses.

  5. Check the Enable TLS box.

  6. Type the password.

  7. Select Test Email Setting (optional).

  8. Select Update.

  9. Repeat for email recipient where TLS needs to be enabled.