The Shared Directory is used anytime you are deploying qTest applications on more than one server where you have files that may need to be shared among services. These files can be supported by a distributed file system like NFS or SMB.
Read these instructions on how to set up the NFS Client, which you will need to install on your application node server(s) prior to installing the qtest application(s.)
IMPORTANT: We suggest using SMB for Windows, follow these instructions if you prefer to use SMB.
Setup Shared Server
Access the shared server (whose private IP address is 10.0.10.230) and install the following applications and/or packages.
qTest requires PostgreSQL database engine to be installed. Skip this step if you have already installed PostgreSQL.
Follow the supported PostgreSQL version ranges for the OnPremise Version you are installing/upgrading:
- Q4 OnPremise 2019 : 9.8.3
- Q3 OnPremise 2019 : 9.7.1
- Q2 OnPremise 2019 : 9.6.1
- Q1 OnPremise 2019 : 9.5.3
Go to this page to download PostgreSQL. After downloading, run the installer to install PostgreSQL on the Shared Server.
Make sure you enable remote access to PostgreSQL database server.
- Open file C:\Program Files\PostgreSQL\<version>\data\pg_hba.conf. Note: replace <version> place holder with the actual version that you have installed.
- Look for the following line and if it does not exist, append the line to the file.
host all all 0.0.0.0/0 md5
host all all ::1/0 md5
- Your C:\Program Files\PostgreSQL\<version>\data\pg_hba.conf now looks like below:
- Open the file C:\Program Files\PostgreSQL\<version>\data\postgresql.conf.
- Look for the following line, and if it does not exist, append it to the file:
listen_addresses = '*'
- Save and close the file when you have finished.
Restart PostgreSQL Service
Restart PostgreSQL service for the changes to take effect.
Important: By default, PostgreSQL runs on port 5432. You will configure the firewall for this later.
- Open the Start menu, and locate your Windows System.
- Select Run and type services.msc to open the Services window.
- Assume you have installed PostgreSQL 9.5, therefore, on the Services window look for the service named postgresql-x64-9.5.
- Right-click on the postgresql-x64-9.5 service and select Restart in the popup menu.
Install and Configure NFS Server
Network File System (NFS) is a Windows component that is used to share files across machines. This is used for every deployment model where you have more than one server. Follow the instructions below to install and setup your NFS Server.
- Open Server Manager, and navigate to the Dashboard.
- Select Add Roles and Features.
- Select Next on the 'Before you begin' window.
- On the Select installation type screen, make sure the option 'Role-based or feature-based installation' is selected, then select Next.
- On the Select destination server screen, make sure the option 'Select server from the server pool' is selected, and select Next.
- From the Select server roles screen, locate and expand 'File and Storage Services (2 of 12 installed)' item then expand 'File and iSCSI Services (1 of 11 installed).'
- Select the checkbox for 'Server for NFS.'
- Select 'Add Features' in the popup.
- The 'Server for NFS' is now selected. Click Next.
- On the 'Select features' screen, select Next.
- On the 'Confirm installation selections' screen, select Install.
- On the 'Installation progress' screen, wait for the installation to complete then Close.
Create and Configure the Shared Folder
Next, you are going to create a folder(s) to store data created by multiple qTest application instances and use NFS to share the folder between them. You will need to create folders for both Manager and Sessions and complete the steps below for each applications storage folder.
- Open Fire Explorer and create/name a folder in C:\ drive.
Examples: "sessions-storage" and "manager-storage"
- Right-click on the new folder and select Properties.
- On the 'Properties' window, select the 'NFS Sharing' tab.
- Select the 'Manage NFS Sharing...' button.
- In the NFS Advanced Sharing widget, check the 'Share this folder' checkbox, then select Permissions.
- From the NFS Share Permissions screen, do the following:
- Select 'Read-Write' option in the 'Type of access:' field
- Select the checkbox 'Allow root access.'
- Select OK, then Close, to complete sharing the newly created folder .
Configure Shared Server's Firewall
You need to configure the Firewall on the Shared Server to enable qTest application nodes to access the components you just installed. You need to open the ports of the following components:
- PostgreSQL: the running port is 5432
- NFS: the running port is 2049
- From the Control Panel, open Windows Firewall.
- Select Advanced settings.
- On the Windows Firewall with Advanced Security window, select Inbound Rules from the left panel.
- Select New Rule... in the Inbound Rules from the right panel.
- On the New Inbound Rule Wizard screen, select the option 'Port' and click Next.
- On the Protocol and Ports screen, do the following:
- Select TCP option
- Select Specific local ports option, and enter the port values of PostgreSQL and NFS, separate each value by a comma.
Example: 5432, 2049.
- Click Next when you are done.
- On the Action screen, make sure the option Allow the connection is selected, then click Next.
- In the Profile screen, make sure all the options for Domain, Private and Public are checked, then click Next.
- In Name screen, enter a name for your new rule, e.g. 'Shared Ports for qTest Sessions', then click Finish.
- You have finished setting up the Shared Server.
Important: You need to restart the server for the changes and configurations to take effect, then move on to installing qTest application nodes on a separate server.