Menu

Scenario 2.0 to 2.0.1 Single Server Upgrade Guide for Windows

Overview

In this article, are instructions to upgrade qTest Scenario from 2.0 to 2.0.1 on a single Windows machine. Please read the instructions thoroughly before starting your installations.

Release notes for this version can be found here.

To request assistance with upgrading or obtain the self-upgrade links, complete the Upgrade Request Form and reference the OnPremise Upgrades Guide.

Note: If you are performing a fresh install, use the OnPremise New Install Form and reference the OnPremise Install Guide.

Before You Begin

Read the following:

Install and Configure MongoDB

qTest Scenario requires MongoDB 3.4 to be installed. Skip this step if you have already installed MongoDB 3.4. Otherwise, make sure you follow these instructions to:

  • Install MongoDB 3.4
  • Configure MongoDB
  • Create a root user to access to qTest Scenario database
  • Install MongoDB as a Windows service

Upgrade to qTest Scenario 2.0.1

Please be aware that Scenario uses the Pulse database. Therefore, you will see several mentions of Pulse within this document.

Stop qTest Scenario

  1. Open the Command Prompt as an Administrator.
  2. Execute the command below to stop qTest Scenario.
> net stop qtest

stop-qtest-service.png

Collect Current qTest Scenario Configurations

  1. Access the qtestctl folder where qTest Scenario 2.0 is located and running.
    Example: c:\qtestctl
  2. Open the qtest.config file.
  3. Collect the information as highlighted below, in blue.
external {
mongo {
host = '[MongoDB Server's IP or hostname]:[MongoDB Server Port]'
replSet = 'rs0'
auth {
db = 'admin'
user = '[MongoDB user name]'
pass = '[MongoDB user password]'
ssl = false
}
}
...
pulse {
port: [qTest Pulse Running Port]
...
qtest {
host = '[http or https]://[qTest Manager server's IP or hostname]:[HTTP port]'
}
...
}

}

Download qtestctl

Note: 

  • If you are upgrading qTest Scenario in the same server with other qTest application(s), e.g. qTest Manager, then you do not need to re-download this installation package but use the one you downloaded when you installed qTest Manager. Otherwise, if you plan to upgrade qTest Scenario on a separate server, follow the steps below to download qTest Scenario.
  • To learn more about qtestctl, refer to this article qTest OnPremise - Technical detail about qtestctl

1. Download qtestctl from the link provided by our Implementation team.

2. Extract the downloaded file to a folder on disk.
Example: C:\qtestctl-4.0.1

Configure qTest Scenario 2.0.1

Navigate to the extracted folder at C:\qtestctl-4.0.1 and edit ‘qtest.config’ file in your favorite text editor.

Configure the Application List

  • If you are upgrading qTest Scenario 2.0 on a separate server, make sure there is 'pulse' in the apps list.
apps = ['pulse']
  • If you are upgrading qTest Scenario on the same server with other qTest application(s), e.g. qTest Manager, append pulse to the app list.
apps = ['manager', 'pulse']

Configure the Database

Navigate to the external section in qtest.config file as shown below then replace blue text with the actual values you collected the current qTest Scenario configurations.

  • IMPORTANT: Replace the blue text in the brackets with your custom values. Only the information listed below in blue should be updated, all other data should remain unchanged. 
external {
mongo {
host = '[MongoDB Server's IP or hostname]:[MongoDB Server Port]'
replSet = 'rs0'
auth {
db = 'admin'
user = '[MongoDB user name]'
pass = '[MongoDB user password]'
ssl = false
}
}
}

Configure SSL

If you want to upgrade qTest Scenario with SSL, navigate to the section common in qTest.config file as shown below then replace the blue text with actual values

  • IMPORTANT: Replace the blue text in the brackets with your custom values. Only the information listed below in blue should be updated, all other data should remain unchanged. 
    • enable: set to true to enable secured connection (HTTPS) between user browser and the server. Default value is false.
    • cert: absolute path to the certificate file on this server. Please use \\ or / in the path. It is mandatory if enable is set to true.
    • key: absolute path to the private key file on this server. Please use \\ or / in the path. It is mandatory if enable is set to true.
    • pass: passphrase of your certificate. This field is optional (default value is empty).
    • strict: set this to false to allow self-signed SSL certificate.
common {
ssl {
enabled = false
cert = "${path}/server.crt"
key = "${path}/server.key"
pass = ""
strict = false
}
}

Configure qTest Scenario Application

Navigate to section pulse as shown below to configure qTest Scenario. Replace blue text with the actual values you collected the current qTest Scenario configurations.

  • IMPORTANT: Replace the blue text in the brackets with your custom values. Only the information listed below in blue should be updated, all other data should remain unchanged. 
    • port: configure server port that qTest Scenario will be listening
    • qtest: configure qTest Manager application URL
      • host: qTest Manager URL
...
pulse {
port: [qTest Pulse Running Port]
...
qtest {
host = '[http or https]://[qTest Manager server's IP or hostname]:[HTTP port]'
}
...
}

Backup Data

  1. Open a Command Prompt if you haven't done so, navigate to the C:\qtestctl-4.0 folder and execute the command below to backup data.
    C:\qtestctl-4.0> qtestctl pulse:backup
    Note: This command might take a while to complete depending on how big the database is.
  2. Once the command is successful, the backup data is stored at:
    C:\qtestctl-4.0\pulse\build\tmp\backup.tgz

Start qTest Scenario

If this step is successful, you can proceed to Install qTest Scenario as a Windows Service.

C:\qtestctl-4.0.1\qtestctl> qtestctl start
<===========> 75% EXECUTING [57m 45s]
> :pulse:start
> IDLE

Troubleshooting: if step above is not successful, you need to rollback qTest Scenario to version 2.0 by following the steps below:

  1. Restore backup data by running below command from the qTest Pulse folder.
    C:\qtestctl-2.1> qtestctl pulse:restore 
    Note: The command might take a while to complete depending on how big your data is.
  2. When restore process completed, execute the command below to start qTest Scenario 2.0.1:
    > net start qtest
  3. Contact Customer Support to troubleshoot the issue with upgrading qTest Scenario.

Install qTest Scenario as a Windows Service

Only proceed to this step when you have successfully started qTest Scenario.

You will install qTest Scenario as a Windows service to enable it to automatically start when Windows starts.

Note: if you plan to upgrade qTest Scenario with other qTest Application(s) in the same server, you only need to execute this step once and only once when you finished all the applications in this server. Refer to this article to learn more about installing qtest service.

  1. If qtestctl is running in the Command Prompt, press `ctl + c` to stop it.
  2. Access the qTest Scenario 2.0 folder.
  3. Remove the qTest Scenario 2.0 Service with the following command:
    C:\qtestctl> Uninstall.bat
    parameters-uninstall.png
  4. Navigate to the folder C:\qtestctl-4.0.1 then execute below command:
    C:\qtestctl-4.0.1> Install.bat
  5. If the service is successfully installed, you'll see it in the Task Manager > Services tab.
    qtest-service-on-task-manager.png
  6. You have finished upgrading qTest Scenario to version 2.0.1, now you can access the qTest Scenario site and verify the new version.

     

 

 

Subscribe To Our Blog
Powered by Zendesk