Install and Start Spring Insight Dashboard

The Spring Insight Dashboard web application runs on one tc Runtime instance. You connect to the Insight Dashboard server to view the Spring Insight user interface. .

Prerequisites

Download the software as described in Download tc Server and Spring Insight Operations.

Procedure

  1. On the computer that will run the Spring Insight Dashboard, create a directory for tc Server.

    For example: /home/tcserver

  2. Copy or upload the tc Server Standard Edition ZIP or compressed TAR file you downloaded into the directory that you created for tc Server.

  3. Extract the tc Server bundle into the tc Server directory.

    The top-level directory created when you extract the bundle is the tc Server installation directory.

    For example: /home/tcserver/tc-server-standard-edition-2.6.0.RELEASE

    This directory contains the tc Runtime utility scripts, the templates directory, tc Runtime 6 and 7, and so on.

  4. Copy or upload the Spring Insight Dashboard ZIP or compressed TAR file you downloaded into the tc Server directory.

  5. Extract the Spring Insight Dashboard bundle into the templates subdirectory of the tc Server installation directory.

    This action creates a directory with the name insight-dashboard in the templates subdirectory.

  6. Create the tc Server instance that will run Insight Dashboard.

    1. In a Unix terminal window or Windows Command Prompt, change to the tc Server installation directory.

    2. Use the tcruntime-instance.sh or tcruntime-instance.bat command to create the tc Server instance that will run Insight Dashboard.

      For example, to create an instance named myDashboard, enter the following command without line breaks:

      prompt$ ./tcruntime-instance.sh create myDashboard -t insight-dashboard  
         -p insight-dashboard.dashboard.jms.bind.uri=tcp://myDashboardServer:21234

    The table describes the tcruntime-instance command options in the example.

    Table 1. Main Options of the tcruntime-instance Command

    Command OptionDescription
    -t Specifies the template to use to create the instance. It is the name of the insight-dashboard directory you extracted into the templates directory.
    -pSets the property insight-dashboard.dashboard.jms.bind.uri to the URI that Spring Insight Dashboard uses to communicate with the Spring Insight Agent instances. The prefix insight-dashboard is the name of the Dashboard template in the templates directory. The bind URI has three parts: a protocol (tcp in the example); host name or IP number (myDashboardServer in the example); and port number (21234). You supply an identical URI when you create Insight Agent instances.
    -v(Optional) Specifies the version of tc Runtime to use for this instance. By default, tcruntime-instance uses the highest tc Runtime version present in the tc Server installation directory. If you want to use a lower version, you must supply the -v option.

  7. Ensure that the dashboard.jms.bin.uri port specified in the previous step (21234 by default) is open in the firewall to permit Spring Insight Agent instances to connect.

  8. Start the Spring Insight Dashboard instance with the tcruntime-ctl.sh or tcruntime-ctl.bat command.

    • On Unix:

      prompt$ ./tcruntime-ctl.sh myDashboard start
    • On a Windows system, you must first install the instance as a Windows Service and then start it. You have to install the instance only once.

      prompt> tcruntime-ctl.bat myDashboard install
      prompt> tcruntime-ctl.bat myDashboard start

What to do next