Moving your Shares server to a new machine

Description

This article describes how to move your Shares installation to a new system.

You must move to the same version of Shares. For example, if you have Shares 1.9.3 on your old system, your new system must also have Shares 1.9.3.

Instructions

1. Backup the database from your original Shares installation.

Run the following command, which will save a backup to a directory of your choice:

Linux
# /opt/aspera/shares/u/setup/bin/backup /path/to/backup_dir

Windows
> cd C:\shares\www
> rake backup DIR=C:\path\to\backup_dir

2. Move files to the new machine

You are now ready to move files from your old machine to the new one. Copy the following files from your old machine:

  • Database backup directory

Note: You cannot use the same Shares license on multiple systems as this is a violation of your license terms.

You may use the Shares license from your original system on your new system if you will be uninstalling Shares on the original system right away. For more information on where your license is located, see this article.

If your original Shares installation needs to stay up and running for a short period, you may ask your account manager for a temporary license to use on your new installation.

3. Prepare your new system

The rest of the instructions apply to the new machine.

On the new machine, ensure Shares is installed. Make sure you install the same version of Shares that you had on your old system.

4. (Windows only step) Stop Shares

Navigate to Control Panel > System and Security > Administrative Tools > Services.

Right click and select Stop for the following services:

  • Aspera Nginx Service
  • Aspera Delayed Job Service
  • Aspera Web Services
  • Aspera Stats Collector

5. Restore the database

Restore the database with the backup directory:

Linux
# /opt/aspera/shares/u/setup/bin/restore /path/to/backup_dir

Windows
> cd C:\shares\www
> rake restore DIR=C:\path\to\backup_dir
> rake db:migrate  
> rake init  
> rake aspera:stats_collector:add_all_nodes
Note: The restore script restores your SSL certificate and key which were also backed up with Shares. If you have a purchased SSL certificate/key, be sure to double check they have been restored successfully:
  • Linux: /opt/aspera/shares/etc/nginx/cert.key and /opt/aspera/shares/etc/nginx/cert.pem
  • Windows: C:\Shares\nginx\conf\cert.key and C:\Shares\nginx\conf\cert.pem

6. (Linux only step for Shares 1.9.3+) Clear the transfer_reporters table so the new Shares sends out notifications properly

/opt/aspera/shares/u/shares/bin/run mysql -e 'delete from transfer_reporters'

7. (Windows only step) Start Shares

Navigate to Control Panel > System and Security > Administrative Tools > Services.

Right click and select Start for the following services:

  • Aspera Nginx Service
  • Aspera Delayed Job Service
  • Aspera Web Services
  • Aspera Stats Collector

8. Modify local node storage if necessary

If you had a node on the same system as your previous Shares system, you may need to modify the host information (unless you moved the node to your current system).

On the Shares UI, click the previously local node and select edit. For Host, replace 127.0.0.1 or localhost with the publicly accessible hostname of the node.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk