Menu

Manager 8.1.5 to 8.4.4 Single Server Upgrade Guide for Linux (non-Docker)

In this guide, we will run you through step by step to upgrade qTest Manager from v8.1.5 to 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 upgrade qTest Manager, make sure following things are done:

  • Your machine needs to satisfy qTest Manager's recommended hardware requirements
  • Please follow these instructions back up your data prior to the upgrade process
  • Upgrade your PostgreSQL DB server from v9.4 to v9.5 using these instructions
  • Upgrade your Java JDK to v8
  • Prerequisite packages must be running prior to upgrading qTest
    • PostgreSQL v9.5

Upgrade qTest Manager

  1. Access to your qTest Manager server. Log in as root user on your command shell
    $ sudo su
    		
  2. Access to the installation directory of your current qTest (v8.1.5). In this example, we use /usr/local/qtest-linux-8.1.5
    # cd /usr/local/qtest-linux-8.1.5
    		
  3. Shut down qTest Manager
    # ./qtest_shutdown.sh
    		
  4. Download qTest Manager's installation package
    # wget https://qtest-storage.s3.amazonaws.com/linux-package/8.4/qtest-linux-8.4.4.tar.gz
  5. Once the installation is completely downloaded, extract it
    # tar -zxf qtest-linux-8.4.4.tar.gz
    		
  6. Access to the extracted directory
    # cd qtest-linux-8.4.4/
    		
  7. View file qtest_env.sh
    # vim qtest_env.sh
    		

    Edit the following information. Please input the same information as you configured qTest Manager v8.1.5. You can refer to file qtest_env.sh under v8.1.5's installation directory

    • Specify information to connect to your PostgreSQL server; including its host, port, credentials to log in and create qTest Manager's schema. Remember to set DB_MODE=upgrade
      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=upgrade
      				
    • Specify information to connect to your PostgreSQL server; including its host, port, credentials to log in and create qTest Manager's schema. Remember to set POSEIDON_DB_MODE=upgrade
      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=upgrade
      				
    • Specify your Web configurations include the ports to connect to your qTest through web browsers
      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]
      				
  8. Upgrade qTest Manager
    # ./qtest_setup.sh
    		
    Build Complete
  9. After the above command completes successfully, start qTest Manager
    # ./qtest_start.sh
    		
    Start
  10. To verify if qTest Manager has been successfully upgraded, 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]
Subscribe To Our Blog
Powered by Zendesk