Upgrading Aspera Platform On Demand

Upgrade to version 3.9.6 of Aspera Platform on Demand from a previous version.

You can upgrade from these previous versions:

3.7.4
3.7.3
3.6.0

Note: If you are running version 3.5.4, first upgrade to 3.6.0. See Upgrading Aspera Platform On Demand to 3.6.0.

Customers upgrading from earlier releases may also need new product keys.

SSH to your server, and sudo to the root user.
For more information, see https://www.ibm.com/support/pages/node/1126503.
Back up your Console configuration and database. From the Console Web UI, go to Configuration > Database > Backup and click Back Up Now.
Make sure there are no active transfers on your server.

Download the latest software packages for Aspera Platform On Demand.

# wget http://download.asperasoft.com/sw/ondemand/3.9.6/ibm-aspera-common-1.2.27.176566-0.x86_64.rpm
# wget http://download.asperasoft.com/sw/ondemand/3.9.6/ibm-aspera-console-3.4.0.176566-0.x86_64.rpm
# wget http://download.asperasoft.com/sw/ondemand/3.9.6/ibm-aspera-hsts-3.9.6.176292-linux-64.rpm
# wget http://download.asperasoft.com/sw/ondemand/3.9.6/aspera-ondemand-init-apod-sod-3.9.6-177518.x86_64.rpm
# wget http://download.asperasoft.com/sw/ondemand/3.9.6/aspera-ondemand-init-base-3.9.6-177518.x86_64.rpm
# wget http://download.asperasoft.com/sw/ondemand/3.9.6/aspera-ondemand-tools-3.9.6-177518.x86_64.rpm
# wget http://download.asperasoft.com/sw/ondemand/3.9.6/ibm-aspera-shares-1.9.14.174981-1.x86_64.rpm
# wget http://download.asperasoft.com/sw/ondemand/3.9.6/console-396-patch

Back up the Console database:
```
# asctl console:backup_database
```
Stop all Console processes:
```
# asctl all:stop
```
Stop the Shares Nginx web server:
```
# /opt/aspera/shares/sbin/sv stop nginx
```

Upgrade High-Speed Transfer Server and re-run entitlement:

# rpm -Uvh ibm-aspera-hsts-3.9.6.176292-linux-64.rpm 
# /opt/aspera/bin/asnodeadmin --db-update
# /opt/aspera/bin/alee-admin register customer_id entitlement_id

Upgrade Common and Console:

# rpm -Uvh ibm-aspera-common-1.2.27.176566-0.x86_64.rpm
# rpm -Uvh ibm-aspera-console-3.4.0.176566-0.x86_64.rpm

Run the Console upgrade utility (during upgrade, you can answer yes to all defaults by anaswring y):
```
# asctl console:upgrade
```

Upgrade On Demand packages:

# rpm -Uvh aspera-ondemand-init-apod-sod-3.9.6-177518.x86_64.rpm
# rpm -Uvh aspera-ondemand-tools-3.9.6-177518.x86_64.rpm
# rpm -Uvh aspera-ondemand-init-base-3.9.6-177518.x86_64.rpm

Stop the Apache process (automatically started by the Console upgrade):
```
# asctl apache:stop
```
Note: This installation uses Nginx for the web server instead of Apache.
Upgrade Shares:
Note: Do not run: /opt/aspera/shares/u/setup/bin/upgrade.
```
# rpm -Uvh ibm-aspera-shares-1.9.14.174981-1.x86_64.rpm
```

Configure runlevels for Nginx services and restart Shares background services:

# mv /opt/aspera/shares/etc/runit/runlevels/up /opt/aspera/shares/etc/runit/runlevels/up.bak2
# mkdir /opt/aspera/shares/etc/runit/runlevels/up
# ln -s /opt/aspera/shares/etc/runit/services/crond /opt/aspera/shares/etc/runit/runlevels/up/crond
# ln -s /opt/aspera/shares/etc/runit/services/nginx /opt/aspera/shares/etc/runit/runlevels/up/nginx
# /opt/aspera/shares/sbin/runsvchdir up
# service aspera-shares restart

Run Console patch:
```
# sh console-396-patch
```

Your system is now upgraded to APOD 3.9.6. Log in and confirm that everything works as expected.