Configuring the landing page URL

Remote Control provides a default web page that a target user can access to temporarily install the target software. The URL for the web page is http://trcserver/trc/ondemand/index.jsp. The variable trcserver is the host name or IP address of your Remote Control server. The default web page is provided when you have the Remote Control server installed. You can also configure server properties to provide a URL that the target user can access. The defined URL is displayed to the controller user when they start a broker remote control session.

About this task

The property that is used to define the URL is ondemand.url and it is contained in the ondemand.properties file. To configure the property, complete the following steps:
Note: You can also manually edit the properties file. You must click Admin > Reset Application after a manual edit.

Procedure

  1. Log on to the server UI with a valid admin ID and password.
  2. Click Admin > Edit properties files.
  3. Select ondemand.properties.
  4. Set the ondemand.url property to the relevant value.
    Leave the property blank
    When you do not want a URL to be displayed to the controller user, do not enter a value for the property.
    To display a web page

    The ondemand.url property is set to https://localhost/trc/ondemand/index.jsp?conncode=%c by default. Replace localhost with the address of your remote control server. To use a reverse proxy, replace localhost/trc/ondemand with the public fully qualified domain name of the broker that is configured as a reverse proxy. For example, https://broker.example.com/index.jsp?conncode=%c. For more information about configuring a reverse proxy, see On-demand target portal access for internet users. If you do not replace localhost, the value that is defined for the ServerURL property in the trc_broker.properties file is used to create the URL that is displayed to the controller. The %c variable is replaced with the session connection code when the URL is displayed in the controller window. The default page requires the session connection code to be entered.

    You can also set the property to a URL for your own customized web page.
    Table 1. How the URL is displayed to the controller user.
    ondemand.url= ServerURL= URL is displayed as.
    http://localhost/trc/ondemand/index.jsp https://rcserver.com/trc https://rcserver.com/trc/ondemand/index.jsp
    https://mypage.com/trc/ondemand/index.jsp?conncode=%c https://mycompany.com/trc https://mypage.com/trc/ondemand/index.jsp?conncode=1234567

    When the connection code is 1234567.
    https://broker.example.com/index.jsp?conncode=%c https://rcserver.com/trc https://broker.example.com/index.jsp?conncode=1234567

    When the connection code is 1234567.
    Note: In this example there are three hostnames:
    • rcserver.com is the Remote Control Server hostname used when the Server is directly reachable from the Broker
    • mycompany.com is the proxied hostname used to reach the Remote Control Server through an HTTP proxy.
    • broker.example.com is the Remote Control Broker public DNS
    • mypage.com is the public DNS used as virtual hostname to reach the Remote Control Broker through an HTTP proxy
    Not all combinations of the four above are shown in the table.
  5. Click Submit.
  6. Click Admin > Reset Application.

Results

The defined URL is displayed in the Connection Code window when you start a broker remote control session.