Follow this instruction if you want to upgrade qTest Sessions to version 3.0.9 on separated CentOS/Ubuntu Machine.

IMPORTANT: 

• qTest Sessions 3.0.9 only works with qTest Manager v8.4.4 or later
• qTest Sessions 3.0.9 requires PostgreSQL 9.5. Follow these instructions to Upgrade Postgres to 9.5.
• This guideline is made and verified on CentOS/Ubuntu 16. If you are using other versions and found that some installation commands do not work, please contact our Customer Support.

Before you begin

• Make sure qTest Manager, version 8.4.4 or later, is running and your qTest license file has been imported. If not, go to Install qTest Manager 8.4 on CentOS/Ubuntu Single Machine (non-Docker) for instructions to install and run qTest Manager.
• Make sure your server environment meets recommended hardware requirements

Steps to upgrade to qTest Sessions 3.0.9

1. Open Terminal 

 

2. Make sure you will do all the installation steps as system user by executing following command:

root@ip-[your-ip-address]:/home/ubuntu# sudo su

 

3. If qTest Sessions is running, stop the service before upgrading.

# service explorerd stop

 

4. Execute following command to update and upgrade system packages

On Ubuntu:

root@ip-[your-ip-address]:/home/ubuntu# apt-get update && apt-get upgrade

On CentOS: 

root@ip-[your-ip-address]:/home/ubuntu# yum check-update && yum update

 

5. Download and extract qTest Sessions 3.0.9

root@ip-[your-ip-address]:/home/ubuntu#cd /usr/local
root@ip-[your-ip-address]:/usr/local# wget https://qtest-storage.s3.amazonaws.com/sessions/3.0/sessions-linux-3.0.9.tar.gz
root@ip-[your-ip-address]:/usr/local# tar xzvf sessions-linux-3.0.9.tar.gz
root@ip-[your-ip-address]:/usr/local# cd sessions-linux-3.0.9
root@ip-[your-ip-address]:/usr/local/sessions-linux-3.0.9# ./installer -t install -d /usr/local/sessions-linux-3.0.9
Your Sessions server has setup completely. Please goto /usr/local/sessions-linux-3.0.9 and run configure.sh file to configure your Sessions server.

 

5. Configure qTest Sessions

Edit configurer.properties file with vim

root@ip-[your-ip-address]:/usr/local/sessions-linux-3.0.9# vim conf/configurer.properties 

Update the configuration information as below. Values in bold are important configurations that you must enter correctly.

# database configuration
db.host=52.198.32.183 # YOUR POSTGRES SERVER HOST NAME OR IP ADDRESS
db.port=5432 # POSTGRES SERVER PORT, DEFAULT IS 5432
db.user=postgres # POSTGRES USER NAME
db.password=root # POSTGRES USER PASSWORD
db.schema=sessions # DATABASE NAME
db.action=1 # CHANGE THIS VALUE TO 1 FOR UPGRADE

# redis configuration
redis.host=localhost # Redis SERVER HOST NAME OR IP ADDRESS
redis.port=6379 # Redis SERVER Port

# qtest configuration
qtest.url=https://52.198.32.183:443 # qTest URL specifying IP Address and port with SSL 
qtest.master_token=QToy # qTest Master Token

# elastic search configuration
es.http.host=localhost
es.http.port=9200
es.cluster.name=elasticsearch

es.nodes=1
es.tcp.1.host=localhost
es.tcp.1.port=9300

# application information.
# Note: the port number must be available and not being used by any other application 
web.http.port=9090 
web.https.port=9443 
web.shutdown.port=9005 
web.ajp.port=9009 
web.ssl.required=true # set the value to `true` to enable SSL 

# declare eXplorer API url to use. 
web.url=https://52.198.32.183:9443 # qTest Sessions Web URL. Note: the port number must be available and not being used by any other application 
# storage configuration 
# storage.type suitable value (disk | s3 | riakcs) 
storage.type=disk

# disk storage configuration.
# make sure the directory exists after you're done with this configuration
storage.rootPath=/usr/local/sessions/storage 

When you're done with the configuration, save and close the file.

Next, run below commands to configure and upgrade qTest Sessions. This step will take a while to complete.

root@ip-[your-ip-address]:/usr/local/sessions-linux-3.0.9# ./configurer.sh

Note: if you configured to enable SSL in configurer.properties file, you will be asked for paths to the SSL certificate. Below is an example to specify certificate paths to certificate that is located at /usr/local 

Private key path: /usr/local/server.key
Private key password: [ENTER PRIVATE KEY PASSWORD HERE]
Certificate path: /usr/local/server.crt
Chain certificate path (Optional): [YOU CAN OPTIONALLY ENTER Chain certificate path HERE]

 

6. Configure qTest Sessions service

root@ip-[your-ip-address]:/usr/local/sessions-linux-3.0.9# cd /etc/init.d
root@ip-[your-ip-address]:/etc/init.d# ln -snf /usr/local/sessions-linux-3.0.9/bin/explorerd
root@ip-[your-ip-address]:/etc/init.d# systemctl enable /usr/local/sessions-linux-3.0.9/bin/explorerd.service -f

 

7. Start qTest Sessions service

root@ip-[your-ip-address]:/usr/local# service explorerd start

Now you can access to qTest Sessions and verify that the upgrade was successful.