Starting JUnit Selenium adapters

After you configure the JUnit Selenium adapter, you can start the adapter from a command prompt for the first time.

Procedure

  1. Open a command prompt window.
  2. Switch to the directory where the JUnit Selenium adapter is installed.
  3. Complete one of the following steps according to your operating system:
    • Windows icon
      Run the startup batch file with the following command-line arguments:
      C:\ start.bat -repository  https://qmserver:port/qm -user userid -password password [-adapterName adapter-name]
      -projectArea project area [-sleepTime sleep
      time]	[-configFile configuration file]
    • Linux icon
      Unix icon
      Run the shell script with the following command-line arguments:
      $ start.sh -repository  https://qmserver:port/qm -user userid -password password [-adapterName adapter-name] -projectArea project area [-sleepTime sleep time]	[-configFile configuration file]
    Where:
    • qmserver is the host name or IP address of the Quality Management server.
    • port is the port where the Quality Management server is running.
    • userid is a registered user ID for Quality Management that has the license to run an adapter.
    • password is the password of the submitted user ID.
    • adapter name is an adapter name that the user assigned.
    • project area is the name of the project logged in to.
    • sleep time is the polling interval between polling for tasks. The default setting is 5 seconds.
    • configuration file is the file to store and read the settings for this adapter. The default file name is config.ini.
    The adapter generates a configuration file (the config.ini file or the file that is specified in the -configFile option) to contain the registration information. This information is reused when the adapter is restarted.

    When you start the command-line adapter for the first time, you must enter your user ID. The adapter prompts you to enter your password; then, the password is encrypted and stored in the config.ini file.

    You can use a smart card to authenticate a Engineering Test Management server while you start the adapter. Use the following authentication methods:

    • To authenticate by using Kerberos/SPNEGO, pass the values for the following arguments:
      Argument name Argument value
      -authType KERBEROS
      -kerberosConfigPath Absolute path to the Kerberos configuration file. Example: C:/Windows/krb5.conf
    • To authenticate by using a keystore alias, pass the values for the following arguments:
      Argument name Argument value
      -authType SMARTCARD
      -keystoreAlias Keystore alias (friendly name) for the user certificate.
    • To authenticate by using an SSL certificate, pass the values for the following arguments:
      Argument name Argument value
      -authType SSLCERT
      -certificatePath Path to the SSL certificate. Example: C:\SomeDir\userCert.p12
      -certificatePassword Password for the certificate file. This argument is optional.

    For more information about smart card authentication, see the readme file for the adapter.

  4. To restart the JUnit Selenium adapter from a config.ini file, complete one of the following steps:
    • Windows icon
      : Run the batch file without any arguments: C:\ start.bat
    • Linux icon
      and
      Unix icon
      : Run the shell script without the command-line arguments: $ start.sh
    Note: The configuration file is expected to be in the directory that the adapter is started from.

    You can use a smart card to authenticate a Engineering Test Management server while you restart the adapter. Use the following authentication methods:

    • To authenticate by using Kerberos/SPNEGO, pass the values for the following arguments:
      Argument name Argument value
      rqm.authType KERBEROS
      rqm.kerberosConfigPath Absolute path to the Kerberos configuration file. Example: C:/Windows/krb5.conf
    • To authenticate by using a keystore alias, pass the values for the following arguments:
      Argument name Argument value
      rqm.authType SMARTCARD
      rqm.keystoreAlias Keystore alias (friendly name) for the user certificate.
    • To authenticate by using an SSL certificate, pass the values for the following arguments:
      Argument name Argument value
      rqm.authType SSLCERT
      rqm.certificatePath Path to the SSL certificate. Example: C:\SomeDir\userCert.p12
      rqm.certificatePassword Password for the certificate file. This argument is optional.

    For more information about smart card authentication, see the readme file for the adapter.


video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki