In this guide, we will run you through step by step to install qTest Manager v8.4.4 on a single CentOS/Ubuntu machine. Please go through the guide below thoroughly before starting your installations. It is recommended to use copy & paste for the scripts.

Before you begin

Before you install qTest Manager, make sure following things are done:

• Your machine needs to satisfy qTest Manager's recommended hardware requirements
• Prerequisite applications must be installed and running prior to upgrading qTest
  • PostgreSQL v9.5
  • Java JDK v8

Install Prerequisite Softwares

Please follow these instructions to install to prerequisite app(s) as mentioned above

Install qTest Manager

1. Access to your server and log in as root user on the command shell

   $ sudo su
   		

2. Download qTest Manager's installation package

   # wget https://qtest-storage.s3.amazonaws.com/linux-package/8.4/qtest-linux-8.4.4.tar.gz

3. Once the installation is completely downloaded, extract it

   # tar -zxf qtest-linux-8.4.4.tar.gz
   		

4. Access to the extracted directory

   # cd qtest-linux-8.4.4/
   		

5. View file qtest_env.sh

   # vim qtest_env.sh
   		

   Edit the following information:

   • Specify information to connect to your PostgreSQL server; including its host, port, credentials to log in and create qTest Manager's schema

     DB_HOST=[PostgreSQL server's host name or IP]
     DB_PORT=[PostgreSQL server's port]
     DB_USER=[username to log in to PostgreSQL]
     DB_PASSWD=[password to log in to Postgres]
     DB_NAME=[schema name of qTest database]
     DB_MODE=install
     				

   • Specify information to connect to your PostgreSQL server; including its host, port, credentials to log in and create qTest Manager's schema

     POSEIDON_DB_HOST=[PostgreSQL server's host name or IP]
     POSEIDON_DB_PORT=[PostgreSQL server's port]
     POSEIDON_DB_USER=[username to log in to PostgreSQL]
     POSEIDON_DB_PASSWD=[password to log in to Postgres]
     POSEIDON_DB_NAME=[schema name of Poseidon database]
     POSEIDON_DB_MODE=install
     				

   • Specify your Web configurations include the ports to connect to your qTest through web browsers

       IMPORTANT: You will need to check if the ports are being used by other applications on the server and allow them to be connected through firewall using these instructions

     1. Check which ports are being used
     2. Allow network ports to be connected through firewall - For CentOS
     3. Allow network ports to be connected through firewall - For Ubuntu

     WEB_PORT=[HTTP port]
     WEB_HTTPS_PORT=[HTTPS port]
     WEB_ADMIN_PORT=[HTTP port]
     WEB_ADMIN_AJP_PORT=[HTTPS port]
     				

   • Choose whether you want to enable SSL connection. If SSL is enabled, certificate file and private key file are required

     ENABLE_SSL=true
     CERT_FILE=[required - specify the location of your certificate file]
     CA_CERT_FILE=[optional - specify the location of your chain certificate file]
     PK_FILE=[required - specify the location of your private key]
     PK_PASSWD=[optional - specify your private key password]
     				

   • Configure directories for attachment and search. These directories need to be writable

     ATTACHMENT_DIR=[directory which stores attachment]
     SEARCH_DIR=[directory which stores search index]
     				

6. Install qTest Manager

   # ./qtest_setup.sh
   		

   
7. After the above command completes successfully, start qTest Manager

   # ./qtest_start.sh
   		

   
8. After qTest Manager has been started, you may want to make it an OS service so you will not need to manually start qTest Manager whenever your server is rebooted

   # ./config_qtest_as_service.sh
   		

Configure qTest Manager

After qTest Manager has been installed successfully, you can access it via your browser using the address

• If SSL is disabled: http://[server_ip]:[WEB_PORT]
• If SSL is enabled: https://[server_ip]:[WEB_HTTPS_PORT]

You will need to configure your qTest Manager instance and import your licenses before it is ready for your users. Please follow this guide: Configure Manager.