How to Add an additional web server Port Number

IntraVUE uses port 8765 to view web pages and to communicate internally. Some users may desire a different port number due to proxy servers or when going through a firewall. IntraVUE can be configured to 'listen' or additional port numbers, but will ALWAYS listen on port 8765 which MUST be available for IntraVUE's use.

Below are the steps to configure the Tomcat web server to use port 80, as an example.

1. Make sure that port 80 is not in use already with some other web server (eg IIS, Apache) From a command line, do


   netstat -an

You should NOT see a line like


   TCP    0.0.0.0:80             0.0.0.0:0              LISTENING

If you do, you'll have to find out which web server is using that port and stop it before continuing. Look down the services list and see if there's anything like httpd, apache, IIS, ... The other web server must be configured to use another port or must not run to avoid a race for the port on restarts.

2. Using windows explorer, navigate to the directory C:\Program Files\IntraVUE\AutoIP\tomcat5\conf

3. Make a safety copy of the file server.xml by selecting it, then copy (Ctrl-C) and paste (Ctrl-V)

4. Open the file server.xml with notepad (it's a pretty short file - only about 30 lines long)

5. Add an additional line after the assignment to port 8765. YOU MUST NOT REMOVE THE 8765 LINE. So,


   < Connector port="8765" / >

becomes

   < Connector port="8765" / >
   < Connector port="80" / >

6. In the services list , stop and then start the service 'Apache tomcat etomcat'

7. Confirm you can still talk to the IntraVUE server by pointing your browser at URL


       http://127.0.0.1:8765/iv2/list

8. Confirm it ALSO works on the default port 80 by using URLs


       http://127.0.0.1:80/iv2/list
       http://127.0.0.1/iv2/list

9. You should now be able to see IntraVUE on port 80


       http://127.0.0.1

Note that you cannot remove the port 8765 from the server.xml file, because some internal functions expect to find the server on that port. However, all the applets will use the same port as the original connection, so it should work fine through firewalls which block port 8765.

Although it is possible in principle to accommodate an existing web server on port 80 without stopping it, the procedures for doing this are much more complex, particularly if the goal is to drill through firewalls. I would suggest IntraVUE be installed on a dedicated machine to avoid these issues.