Use the following instructions to upgrade the StorCycle solution to a new version.
IMPORTANT |
Spectra Logic strongly recommends that you create a database backup before upgrading the software. See Database Backup. |
Notes: l | Program data is retained with an upgrade. |
l | Downgrading is not supported. |
Use the following instructions to download and install the new version of software on a Windows server.
1. | Sign in to the server where you want the program to run as a user that is a member of the “Administrators” Local Group. |
2. | Download the Spectra StorCycle solution installer. |
3. | Run the installer, ssc.revision.msi, where revision is the revision number for the software. |
4. | Follow the on-screen instructions to install the software. Leave the Account name and Password fields empty to run the StorCycle service using the previously configured account. |
When upgrading the StorCycle solution, in some cases, you cannot upgrade directly from your current version to the newest version. The StorCycle solution requires that you upgrade to all intermediate StorCycle versions with unique MongoDB versions between your current version and your target StorCycle version. You cannot skip a StorCycle version if the MongoDB version changes between your current and target StorCycle version.
For example, as shown in the table below, you can upgrade from StorCycle 3.6.2 to 3.7.1 directly, skipping version 3.7.0, because the version of MongoDB required for those versions of StorCycle does not change.
However you cannot upgrade directly, from version 4.0.0 to version 4.3.0 as the MongoDB version is not the same between both versions. You would first need to upgrade from StorCycle version 4.0.0 to 4.1.0, then 4.1.0 to 4.2.0, and finally from 4.2.0 to 4.3.0. During each of those upgrades, you also must upgrade the MongoDB repo. You cannot skip upgrading the MongoDB when installing a newer version of the StorCycle solution. Both must be upgraded in sequence to allow for proper database conversion.
Use the following instructions to download and install the new version of software on a Linux server.
1. | Update your MongoDB repository. Use the table below to determine the supported version of MongoDB. |
StorCycle Version Number |
MongoDB Version Number |
3.6.2 |
MongoDB 4.0 |
3.7.0 |
MongoDB 4.0 |
3.7.1 |
MongoDB 4.0 |
4.0.0 |
MongoDB 4.2 |
4.1.0 |
MongoDB 4.4 |
4.2.0 |
MongoDB 5.0 |
4.3.0 |
MongoDB 6.0 |
2. | Open the terminal and sign in as a superuser. |
Note: | The following commands reflect upgrading to StorCycle version 4.3.0. If you are installing a different version of the software, you will need to adjust the values in red below to the appropriate version listed in the table above. |
3. | Create a file named: |
/etc/yum.repos.d/mongodb-org-6.0.repo
4. | Open the file and enter the following: |
[mongodb-org-6.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/releaseversion/mongodb-org/6.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-6.0.asc
5. | Obtain the link for the new version from a Spectra representative. Copy the .rpm file to the server where the StorCycle solution will be installed. |
6. | Navigate to the directory where the .rpm file is located or give the full path to the file. The .rpm must run as root. |
7. | To install the StorCycle .rpm, use the following command: |
sudo yum install -y ssc-production-4.3.0.XXX.XXXXXXXX.rpm
8. | If desired, change the user from root using the following commands: |
sudo chown -R user:group /var/lib/ssc
sudo vi /usr/lib/systemd/system/ssc.service
# User=root - change root to the new user name