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.