How to Upgrade Shares from v.1.0.3 to v.1.5 on Your v.3.2.2 Shares On Demand


This article is for customers who have Aspera On Demand running Shares v1.0.3 and would like to upgrade to Shares v1.5.


Upgrade Procedure

1) Connect to your AMI host from a Terminal/Command Prompt via SSH as root

# ssh -i [customer's pem] -p 33001 [ec2-user]@[ec2 host IP]
# sudo su -

NOTE: make sure the permission of the local pem key is set to 400.  If you have questions about how to connect to your server, please see this article.


2) Download Shares v1.5 and Enterprise Server v.3.3.3 installer from our website 

Use your customer login to download the package.  If you don't know your customer login and password, please contact Aspera Support at to obtain your login credentials.

# wget --user=your-id --password=your-password
# wget --user=your-id --password=your-password


3) Download the two patches and configuration file that are attached at the end of this article and update their permissions

b) shares-1.5.0-entitlements.patch
c) nginx.shod15.conf  (no need to change permissions)

 # chmod 770 shares-1.5.0-entitlements.patch


4) Upgrade Enterprise Server to v.3.3.3

# rpm -Uvh aspera-entsrv-


5) Create a backup directory

# mkdir /tmp/shares-backup


6) Backup Shares configuration and data

# /opt/aspera/shares/script/ backup DIR=/tmp/shares-backup

This will create a new directory with a time stamp naming convention  i.e. /tmp/shares-backup/20130927184254


7) Back up your purchased SSL certificate files (if applicable)

If you have your own purchased SSL certificate, please back up the files to the directory created in Step 6), in this example, /tmp/shares-backup/20130927184254.

# cp /opt/aspera/shares/conf/cert.key /opt/aspera/shares/conf/cert.pem /tmp/shares-backup/20130927184254


8) Stop Shares related services and remove Shares

# /etc/init.d/aspera_shares_nginx stop
# /etc/init.d/aspera_shares_delayed_job stop
# chkconfig --del aspera_shares_nginx
# chkconfig --del aspera_shares_delayed_job

# rm /etc/init.d/aspera_shares_nginx
[root@ip-10-116-123-228 /]# rm /etc/init.d/aspera_shares_nginx
rm: remove regular file `/etc/init.d/aspera_shares_nginx'? y
# rm /etc/init.d/aspera_shares_delayed_job
[root@ip-10-116-123-228 /]
# rm /etc/init.d/aspera_shares_delayed_job
rm: remove regular file `/etc/init.d/aspera_shares_delayed_job'? y
# rpm -e aspera-shares
# mv /opt/aspera/shares /opt/aspera/shares-1.0.3


9)  Install Shares v.1.5 and the patches

# rpm -Uvh aspera-shares- 



NOTE:  Although it prompts you to run /opt/aspera/shares/u/setup/bin/install after you run rpm, DO NOT run the  /opt/aspera/shares/u/setup/bin/install script.  Run the following patches instead

# yum install -y patch
# ./


 copy the username and password for aspera_console database in /opt/aspera/console/config/database.yml and insert in /opt/aspera/shares/u/setup/libexec/lib_mysql_install.  Save /opt/aspera/shares/u/setup/libexec/lib_mysql_install after you make the changes.   NOTE: MUST run shares-1.5.0-entitlements.patch before running /opt/aspera/shares/u/setup/bin/install.

# vi /opt/aspera/shares/u/setup/libexec/lib_mysql_install


# patch -p0 -d /opt/aspera/shares/u/shares/ < shares-1.5.0-entitlements.patch
# mv  /opt/aspera/shares/etc/nginx/nginx.conf  /opt/aspera/shares/etc/nginx/
# cp nginx.shod15.conf  /opt/aspera/shares/etc/nginx/nginx.conf
# /opt/aspera/shares/u/setup/bin/install 


10) Restore Shares

Use the backup data to restore your Shares, in this example, /tmp/shares-backup/20130927184254.

# /opt/aspera/shares/u/setup/bin/restore /tmp/shares-backup/20130927184254


11) Enable Persistent Store 

Edit  /opt/aspera/etc/aspera.conf and insert "<persistent_store>enable</persistent_store>" between the <central_server> and </central_server> tabs



Powered by Zendesk