Set up Network Virtualization integration in Digital Lab

Before you can perform Network Virtualization testing on your mobile device, you need to configure the Digital Lab server. This section is relevant only for on-premises deployments of Digital Lab.

Set up the Network Virtualization integration

Before running your test with a local NV Test Manager server, your Digital Lab administrator needs to perform the following:

  1. With an admin role, click Administration in the right of the masthead, and choose the SETTINGS tab. Select the Network Virtualization Integration node.

  2. Set Enable NV integration to Yes.

  3. Provide the following information for communicating with the NV Test Manager server:

    Setting Description

    Communication over device

    The following guidelines apply to the Network Virtualization Integration settings:

    If the Digital Lab server cannot communicate directly with the NV Test Manager server, enable this setting to instruct Digital Lab to communicate with NV through a connected device.

    Digital Lab will first attempt to find a device that is not currently running a test. If no idle device is set up for Network Virtualization, Digital Lab will choose a device running a test. This usage may slightly affect the device's performance.

    Note: At least one Android device must be connected. Digital Lab will send the commands to NV through a connected Android device, even if the actual test runs on an iOS device.

    NV Test Manager server

    		The IP address or the server FQDN of the NV Test Manager server.

    NV port

    		The port through which Digital Lab communicates with the local NV Test Manager server. This port is set during the installation of NV Test Manager, and its default value is 8182.

    NV proxy port

    The proxy port as configured in the NV Test Manager server. It is used to send traffic from the mobile devices to the NV Test Manager server. You must configure this port on each mobile device running tests with Network Virtualization. The default value is 8888.

    NV protocol

    The protocol to use to communicate between Digital Lab and the NV Test Manager server. Set this value to HTTPS if the NV Test Manager server is configured to use HTTPS communication. When using HTTPS, you must also install the required certificates. For details, see Install a certificate.

    NV authorization token

    		The NV Test Manager username and password encoded in Base64. For information on how to encode this information, see Encode your credentials.

    Enable NV integration

    Enables the integration with Network Virtualization. Make sure that all the other settings are configured, and select Yes. Then click Verify and Save to send your settings to the server for verification.

    Tip: If you want to save the NV-related settings locally without verification, click Verify and Save before selecting Yes for Enable NV integration. The values are sent to the server for verification only if you save them after enabling the integration.

  4. Click Verify and Save and wait for a confirmation that the settings were saved.

  5. Proceed to Perform exploratory testing with Network Virtualization.

Back to top

Install a certificate

If you are communicating over a secure channel (HTTPS) with the NV Test Manager server, you will need to install the certificate on the Digital Lab server machine.

  1. Get the certificate in one of the following ways:

    • Download the certificate from:

      <http/https>://<NV Test Manager address>:<NV Test Manager port (default 8182)>/mfnv.cer

    • Go to the NV Test Manager server and copy hpenv.cer from the conf folder. By default, in Windows, this folder is C:\Program Files\OpenText\NV\conf (in NV 9.14) or C:\Program Files\HPE\NV\conf (in NV 9.13). In Linux, the default folder is opt/nv-<version.build>/conf.

  2. Copy the certificate to a location on the Digital Lab server machine.

  3. On the Digital Lab server, open a command line prompt at the following location:

    For Linux:

    cd /opt/UFTMobile/jre_ia/bin

    For Windows:

    cd Program Files\Digital Lab Server\jre_ia\bin

  4. Run the importcert command to install the certificate:

    For Linux:

    keytool -importcert -file "<path>/<certificate_file_name>.cer" -alias shunra -keystore "/opt/UFTMobile/server/Security/keystore/trustStoreHpmc"

    For Windows:

    keytool -importcert -file "<path>\<certificate_file_name>.cer" -alias shunra -keystore "Program Files\Digital Lab Server\server\Security\keystore\trustStoreHpmc"

    where <path> is the location of the certificate file you saved earlier.

    • When prompted to enter a password, enter the keystore's password.
    • When prompted to confirm, enter yes.

  5. Verify that the certificate was installed properly:

    For Linux:

    keytool -list -keystore "/opt/UFTMobile/server/Security/keystore/trustStoreHpmc" -v –alias shunra

    For Windows:

    keytool -list -keystore "Program Files\Digital Lab Server\server\Security\keystore\trustStoreHpmc" -v –alias shunra

    When prompted to enter a password, enter the keystore's password, that you defined when installing Network Virtualization.

  6. Run the uploadCertificates script from the server/Security (Linux) or server\Security (Windows) folders. This script adds the certificate information to the database so that the certificate will be available when you restart the server.
  7. Restart the Digital Lab server service.

Back to top

Encode your credentials

When accessing the NV Test Manager server, NV uses HTTP basic authentication, which requires a username and password encoded with Base64. You can encode the username and password using a script or a utility.

Encode the user name and password using a script

  1. Obtain the NV username and password from the NV administrator.

  2. Navigate to the following folder:

    Linux

    <Path to your Digital Lab server installation folder>/server/Security

    Windows

    <Path to your Digital Lab server installation folder>\server\Security

    By default, the path is C:\Program Files\Digital Lab Server\server\Security.

  3. Run the following command to encode the credentials:

    java -jar hp4m-security-jar-with-dependencies.jar nv <NV username> <NV password>

  4. Save the encoded output value. You will use this value as the NV authorization token in Digital Lab's NV Integration settings.

Encode the user name and password using a utility

  1. Make sure you have an Internet connection.
  2. Perform an Internet search for Base64 encode and go to one of the offered sites.
  3. Encode the username and password using the following format: <NV username>:<NV password>.
  4. Save the encoded string. You will use it as the NV authorization token in Digital Lab's NV Integration settings.

Back to top

Next steps: