Redirect SPECTRUM OneClick users to desired address and/or port

Document ID : KB000050715
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

I have changed the port that OneClick is running on, how can I redirect my clients to the new port without asking them to remember to add the :8080 when calling OneClick from a browser?

Solution:

Configure the OneClick Web Server URL

As described in the OneClick Console User Guide (5130) in the discussion on launching the OneClick Console, the OneClick home page provides a central place where users can launch the OneClick client. By default, all OneClick users must use the following URL to reach the OneClick home page:

http://<OneClick web server>/spectrum

Also by default, the URL http://<OneClick web server> launches a Tomcat web server configuration page. In environments where you would prefer all users to launch the OneClick home page using http://<OneClick web server>, you can configure the OneClick web server to automatically redirect from http://<OneClick web server> to http://<OneClick web server>/spectrum.

To configure the OneClick web server URL

  1. Navigate to the <$SPECROOT>\tomcat\webapps\ROOT directory.

  2. In the text editor of your choice, create a new file named index.html.

  3. Edit the index.html file to contain the following text:

    <html>
    <head>
    <meta http-equiv="refresh" content="0;url=/spectrum">
    </head>
    <body>
    </body>
    </html>
  4. Save the index.html file in the ROOT directory referenced in step 1.

All OneClick users navigating to http://<OneClick web server> will now be redirected automatically to http://<OneClick web server>/spectrum.

**

The example given will redirect hostname to hostname:80.

This file can also be used to redirect to any port or address, such as if you enable ssl and want a seamless login for users, use this file to redirect from http://<OneClick web server> to https://<OneClick web server>:port

This must be written in html manually!

Here is the example:

<html>
<head>
<meta http-equiv="refresh" content="0;url=https://<oneclick web server>:443/spectrum">
</head>
<body>
</body>
</html>
**

For additional reading on this subject see pdf 5166.