Contribute in GitHub:

Installing the Performance Test Harness

Installation procedure

Installing the server

To install the Performance Test Harness server, complete the following steps:

Download the pqc-performance-test_server_<version>.tar file from IBM Passport Advantage.

Important: The file name will have the version number instead of <version>. Use the actual file name where required in the remaining steps.
Open a terminal and create a folder for the server installation in your home directory.
```
mkdir perftest
```
Extract pqc-performance-test_server_<version>.tar into the new directory:
```
tar -xf pqc-performance-test_server_<version>.tar -C perftest
```
Navigate to the perf_server directory and grant the following file permissions for all scripts it contains:
```
cd ~/perftest/pqc-performance-test/test_utils/perf_server/
chmod 744 *.sh
```
Start the server installation script:
```
./build_server.sh
```
You will be prompted to enter a list of fully qualified domain names (FQDNs). This will typically be the DNS hostnames, but if the VMs are on the same private network, you can use the private IP addresses. Enter the hostnames or private IP addresses of each VM, separated by spaces:
```
(TARGET_FQDN_LIST): 10.X.X.X 10.X.X.X 10.X.X.X 10.X.X.X
```
Note: If you are hosting the client and server on a single VM, enter the IP address of this VM once.
Enter the target IP address or addresses when prompted. These are the private IP addresses of the VMs. Enter the IP addresses of all VMs, separated by spaces:
```
(TARGET_IP_LIST): 10.X.X.X 10.X.X.X
```
When prompted, you can enter the private IP address for the TESTFQDN where you are currently executing these scripts:
```
(TESTFQDN): 10.X.X.X 
```
Note: This step is optional.

The script will generate root and server certificates in the perf_certs directory, and will deploy the Performance Test Harness server container.

Installing the client

Download the pqc-performance-test_client_<version>.tar file from IBM Passport Advantage.
Open a terminal and create a folder for the client installation in your home directory. Skip this step if you already did this for the server on the same VM.
```
mkdir perftest
```
Important: The file name will have the version number instead of <version>. Use the actual file name where required in the remaining steps.
Extract pqc-performance-test_client_<version>.tar into the perftest directory:
```
tar -xf pqc-performance-test_client_v1.0.1.tar -C perftest
```
Navigate to the perf_client directory and grant the following file permissions for all scripts it contains:
```
cd perftest/pqc-performance-test/test_utils/perf_client/
chmod 744 *.sh
```
Start the client installation script:
```
./build_client.sh
```
Follow the on-screen instructions to accept the license agreement. The script will then start the client environment.

Repeat steps 1–5 for each client VM.