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
- Access to your server and log in as root user on the command shell
$ sudo su
- Download qTest Manager's installation package
# wget https://qtest-storage.s3.amazonaws.com/linux-package/8.4/qtest-linux-8.4.4.tar.gz
- Once the installation is completely downloaded, extract it
# tar -zxf qtest-linux-8.4.4.tar.gz
- Access to the extracted directory
# cd qtest-linux-8.4.4/
- 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
- Check which ports are being used
- Allow network ports to be connected through firewall - For CentOS
- 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]
- Specify information to connect to your PostgreSQL server; including its host, port, credentials to log in and create qTest Manager's schema
- Install qTest Manager
# ./qtest_setup.sh
- After the above command completes successfully, start qTest Manager
# ./qtest_start.sh
- 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.