Upgrading a Single Node from Orchestrator 1.9

The procedure in this topic is only applicable to users upgrading from Orchestrator 1.9.build_version–2.2.build_version to the current release. Orchestrator is now installed with an .rpm file, which makes the upgrade procedure different for users upgrading from earlier versions. For upgrades from Orchestrator 2.3.0, see Upgrading a Single Node from Orchestrator 2.3.0 to the Current Release; for upgrades from Orchestrator 2.3.5, see Upgrading a Single Node from Orchestrator 2.3.5+ to the Current Release.

Because it is likely that the Aspera Common Components installed with earlier versions of Orchestrator are incompatible with the current released version, IBM Aspera recommends that you upgrade the Aspera Common Components before upgrading (instructions for this are given in Step 5.

(Preliminary step) Perform the backup steps described in Upgrading: Requirements to ensure easy rollback in case there are any issues.
After upgrading, previously installed releases of Aspera Orchestrator are still present in /opt/aspera and can be used for rollback operations. For example:
```
/opt/aspera/Orchestrator_2.2.0.build_version/
```
Download the installation files for the new release package (Orchestrator and Aspera Common Components) and copy them to the server.
1. Go to the Aspera downloads website, http://downloads.asperasoft.com/en/downloads/27.
2. Click the Linux icon.
3. Click the drop-down arrow next to Linux - Select Version.
4. Click each of the following, then click Direct download.
  - v2.5.0 - Linux RPM x86_64 (Aspera Orchestrator).
  - v1.2.16Com - Linux RPM x86_64 (Aspera Common Components).
5. Copy both installation files into a local directory, such as /tmp/.
Use SSH or log in to the Linux machine that requires an upgrade and confirm that services are stopped
```
$ asctl all:status
```
If the services are not stopped, run the following commands:
```
$ cd /opt/aspera/orchestrator
$ bin/orchestrator all kill
```
If the version of Common currently installed is different from the one supplied from the downloads website, upgrade the Aspera Common .rpm file using the following command:
```
$ rpm –UvH  aspera-common-1.2.16.build_version-0.x86_64.rpm
```
If orchestrator is a symlink, remove it from /opt/aspera/, which should be pointing to the existing Aspera Orchestrator installation directory.
```
$ rm /opt/aspera/orchestrator
```
Note: If you don’t see a symlink, then move the Orchestrator directory into another location, such as orchestrator_backup.
```
$ mv /opt/aspera/orchestrator /opt/aspera/orchestrator_bkp
```
Install the Aspera Orchestrator .rpm file.
```
$ rpm -ivh aspera-orchestrator-release_number-0.x86_64.rpm
```
See the procedure in Installing Orchestrator for more detailed instructions on the process.
Check status of Aspera Orchestrator service, it should be stopped.
```
$ asctl orchestrator:status
```
Start Aspera Orchestrator service and Restart Apache.
```
$ asctl orchestrator:restart
$ asctl apache:restart
```

Upgrading a Single Node from Orchestrator 1.9–2.2 to the Current Release