Creating and Updating an ESP Connection

Connect your RTView projects to ESP. Connection information is stored in an ESPOPTIONS.ini configuration file. Your projects can share a common ESPOPTIONS.ini file in the lib directory or be placed in separate files.

  1. Create a new project or open an existing one.
    For Windows:
    • To create a new project, create a file folder.
    • To open an existing project, select Start > Run > Open and type in cmd to open a command prompt.
    For Unix:
    • To create a new project, create a file folder.
    • To open an existing project, open a terminal window.
  2. Start the project in the RTView Display Builder:
    Windows:
    %RTVIEWADAPTER_HOME%\bin\start_builder.bat <project_filepath> [<rtv_file_name>.rtv]
    UNIX:
    $RTVIEWADAPTER_HOME/bin/start_builder.bat <project_filepath> [<rtv_file_name>.rtv]
    • <project_filepath> is the absolute file path of the project folder.
    • <rtv_file_name> is the name of an existing dashboard project. If you are creating a new .rtv file (project), do not supply a file name as the RTView Display Builder opens into a blank dashboard project called unnamed.rtv. You can then save this file into your newly created dashboard project folder using a name of your choice.
    Note: On Windows, if you type the start builder command by using the project folder argument without a file name, it looks for a file named "<projectfolder>.rtv". If such a file does not exist in the folder, a message displays stating that the file cannot be opened. Click OK to launch the builder. This is a known RTView issue.
  3. In the RTView Display Builder, select Tools > Options.
  4. In the left pane of the Application Options window, choose ESP.
  5. Create a new ESP connection or edit an existing one:
    • To create a new connection, in the ESP Connections tab, click Add.
    • To edit an existing one, double-click the connection.
  6. Fill in the appropriate connection information and click OK.
  7. Click Apply, then Save to save the connection information in the ESPOPTIONS.ini configuration file.
    • Click Yes if you want to save this file under the lib directory of your RTView install and make these options be available for any RTView project.
    • Click No if you want to save this file under the current project's directory make these options be available only for the current project.
Next
Restart either the RTView Display Builder or the ESP project for the changes to take effect.