2.2.1 Upgrade to qTest Sessions 3.0.9 on CentOS/Ubuntu Single Machine (non-Docker)

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 this instruction to upgrade PostgeSQL to 9.5 on CentOS/Ubuntu
  • 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

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

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

 

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 [/url/to/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.