Install Continuum
Overview
Prerequisites
System Requirements
Before proceeding, please read the Continuum System Requirements page.
Server Connectivity During the Install Process
It may be easiest to enable network access for the Continuum server to pull down the installation files as needed, however, this is not required. If outbound network access to the internet is against organization policy the files can be dropped on the server by downloading to another server or desktop and transferring the files to the target Continuum server as needed.
Create a "continuum" user account
On the Linux machine, create a services account for the Continuum application account named "continuum". This user account will be used to install and own the Continuum application.
sudo useradd -m continuum
Then set a password for the account:
sudo passwd continuum
Verify that shell (/bin/bash or /bin/sh) is set, if not add it:
grep continuum /etc/passwd
Add "continuum" user to sudoers file
echo "continuum ALL=(ALL) NOPASSWD: ALL" | sudo tee -a /etc/sudoers
Verify sudo Capability
The "continuum" user account used to run the install must have sudo capabilities. Add this user to the "sudoers" group by following steps specific to your OS. This can be tested by running the following command as the user account. Switch user account to "continuum" with the command su - continuum
and then test sudo capability with this command:
- Switch user account to "continuum"
su - continuum
- Test sudo capability
sudo echo "helloworld"
An error such as "user not in sudoers file" must be corrected before proceeding.
Curl
"curl" must be installed on the server to download the install script to run and to complete these directions. "wget" is a popular alternative and can be substituted in these instructions where applicable.
Python 2.7
Continuum requires Python 2.7 to run, which is installed by default on RHEL 7.x/CentOS 7.x, but not on Ubuntu 16.04. You can run the following commands to install Python 2.7:
- Update package list
apt-get update
- Install Python 2.7
apt-get install python2.7
Check Time and Timezone Settings
This would be a good time to make sure that your Linux server has NTP (network time protocol) configured properly, the date and time are correct and the timezone is configured properly for the locale of the server. The date and time matter on reports so choose the timezone that most accurately reflects yours organizations primary business operations.
For more information on setting server time zone, see:
Installing VersionOne Continuum
To install the VersionOne Continuum platform perform the following steps on the Linux server. This begins with installing the database servers, then creating running the Continuum installer and configuring the databases.
Refresh System Variables
Ubuntu: source .profile
RHEL/Centos: source .bash_profile
Install MongoDB
Use the following link to perform the installation of MongoDB.
MongoDB version 4.0 is recommended but you must have MongoDB version 3.6 at the least. MongoDB versions later than 4.0 are not supported.
https://docs.mongodb.com/v3.6/administration/install-on-linux/
Pro Tip: Make sure that MongoDB is installed and run as service account and not run as the "root" user. We have found that when the mongodb service is run as root several problems occur.
Download the Latest Continuum Installer
Copy the latest installer (continuum-installer.sh) that was provided by the CollabNet Continuum team to a temporary directory (e.g. /tmp) and run the following command. This file contains both the latest application and the script to perform the install.
In the following command, substitute the url
in the command below with the url that was provided by the VersionOne Continuum support team.
curl -o continuum-installer.sh "url"
mv continuum-installer.sh /tmp/continuum-installer.sh
If the target server is not connected to the internet, download the installation file to an intermediate server then sftp to /tmp.
Make it Executable
Make the script executable and change the script owner to “continuum” user
chmod +x /tmp/continuum-installer.sh
chown -R continuum.continuum /tmp/continuum-installer.sh
Run the Install Script
The following options will NOT start the Continuum services (-p) after the installer completes.
NOTE: Run as the "continuum" user. The user that runs this script will be the owner of the continuum application, files, and directories. This user should not be the root user. A common practice is to create a service account on the Linux machine called "continuum".
NOTE: Do not run the installer using "sudo" or using the root user, the script itself will sudo when it needs to.
/tmp/continuum-installer.sh
Change the Default Installation Directories (Optional)
The Continuum installer script, by default, installs Continuum in these directories—/etc
, /opt
, and /var
. Continuum default installation directories are:
- base_dir—/opt/continuum
- var_dir—/var/continuum
- etc_dir—/etc/continuum
However, you can change the default installation directories (with Continuum 19.2 and later versions) and install Continuum on any directory of your choice.
For example, the following command installs Continuum on custom install directories with the -b, -v, and -e command-line options.
/tmp/continuum-installer.sh -b /myapps/soft/continuum -v /myapps/prod/continuum -e /myapps/app/continuum
When you skip one of the custom paths, the installer falls back to the default. For example, if you ignore the -e option, the installer picks the default etc_dir, which is /etc/continuum.
Logout and return
Log out and log back to the linux server to load environment variables that were added to the profile script of the user. Check that CONTINUUM_HOME is set.
echo $CONTINUUM_HOME
Enable Optional Services
If you are using the Digital.ai Agility Connect features of Continuum, you will need to enable the Agility Connect Services with the following command:
ctm-enable-service ctm-echo_datasync
Start Continuum
Start the Continuum services using the following command.
ctm-start-services
Login
Using a browser, go to the login page for VersionOne Continuum using the address http://serveraddress:8080. On the initial login you will need to scroll down to the bottom of the page to accept the license agreement.
The initial credentials are the user "administrator" and the password "password". You will be required to change the password immediately. This password will need to be at least 8 characters in length.
Next Step
Continue with the next step Initial Configuration