Trillium TSI Web Server Administration - trillium_quality - 17.2

Trillium TS Web Services Developer Guide

Product type
Software
Product family
Trillium
Product
Trillium > Trillium Quality
Version
17.2
Language
English
Product name
Trillium Quality
Title
Trillium TS Web Services Developer Guide
Topic type
Overview
Installation
How Do I
Configuration
Administration
Reference
First publish date
2008

Trillium’s TSI Web Server Administration allows you to perform various administrative tasks for TS Web Services, such as selecting the Trillium project to be run, modifying the project location and web access keys, starting the project, and viewing a log of TSI activity.

To access TSI Web Server Administration

  1. Open a browser window and navigate to:

    http://host:port/TrilliumSOAP/

    where host:port is the host and port on which the Apache Tomcat web server is running; port 8484 is the default. The TrilliumSOAP URL is case sensitive.

    If Tomcat is running and the information you entered is correct, the log in page, illustrated in the figure below, opens. If the web service is not running or the information is not correct, the message Navigation to the webpage was canceled displays. See Apache Tomcat Startup/Shutdown and Reconfiguring Ports for TrilliumSOAP WSDL for information on starting Tomcat and configuring ports.
    Note: If you have previously logged in to TSI Web Server Administration and your session is still active, the Apache Welcome page will display rather than the Log in page. Click TSI Web Server Administration to continue.
    Figure 1. Log In Page
    Log In Page

  2. Enter the user ID (default is tadmin) and password (default is trillium) and click Login. The Administration Home page opens. 

    You can change the login credentials in the properties file trillium_soapadminconfig.properties, located in your install directory in the ...\Trillium Software\MBSW\17\tsq\Software\apache-tomcat\conf folder.

The Administration Home page contains three tabs:

  • The Environment tab, illustrated in the below figure, displays information about your Web Services processing environment. This information is useful for troubleshooting. Of particular importance is the setting Is TSI Dynamic Library Loaded?, which indicates whether paths to the TSI library files (libtsijni.dll on Windows or libtsiJNI.so on Linux) are correctly set. Access to these files allows Tomcat to communicate with the TSI layer.

If your environment is not correctly configured, the following message displays:

To correct the problem, stop and restart Tomcat. If the problem persists, the most common causes are that Java 8 64-bit is not installed or is configured incorrectly, or that libtsijni.dll or libtsiJNI.so is not in the path.

If you cannot correct the configuration problem, contact Customer Support.
Figure 2. Administration Home - Environment Tab

  • The Property Files tab, illustrated in the below figure, displays the paths to three properties files:

    • project properties, trillium_projects.properties, which contains the directory path to the current project.

    • web access properties, trillium_webaccess.properties, which contains the web access keys you have created.

    • Soap Admin properties, trillium_soapadminconfig.properties, which contains the login credentials for TSI Web Server Administration, as well as the project startup, cleanse count settings, and country support settings.
      Figure 3. Property Files Tab

  • The Settings tab, illustrated in the below figure, allows you to set the following project options:

    • TSI Web Server Logging Level: Determines the level of logging messages (INFO, ERROR, or DEBUG) returned by REST/SOAP calls that will be written to the TSI Web Log. DEBUG provides the most thorough logging. Additional logging levels can be set as described on Log Files.

    • Project Startup Behavior: Determines whether the current project will be started automatically when the Tomcat server is started. If you change projects (that is, remove the current project and add a new project) the newly selected project will be started instead. This setting will take effect when Tomcat is next started.

    • Max Megabytes Log File Display: Determines the maximum size of the log file to be displayed with the View TSI Web Log option, as described on Viewing the TSI Log. The most recent lines in the log file are displayed, up to the specified maximum size.

      If the Cleanse Count option is enabled, the following option display. See Viewing Cleanse Count for information on Cleanse Count

    • Cleanse Country Count Field: Determines the text field that identifies the country to be counted. The default is DR_COUNTRY.

      The following two options are for read-only users. You can create a user name and password with read-only access to the TSI Web Server Administration. Read-only users can login and view the TSI Web Server Administration. They can also refresh the project log (Project Configuration > Project Log) and the TSI Web log file (View TSI Web Log), but they cannot perform any administrative tasks such as modifying the project settings. Multiple users can login using the same user name and password at the same time.

      • Read-Only User Username: Login user name for a read-only user.

      • Read-Only User Password: Login password for a read-only user.

      Click Save Settings to save changes. Your selections are written to the trillium_soapadminconfig.properties file.
      Figure 4. Settings Tab