This page lists all the software requirements and installation instructions on how to install/use the Sage Display Controller application.
Software/Hardware Requirments
- Apache Tomcat Servlet Container (Version 4 & above)
- VNC client/server application. (required for desktop sharing feature only)
- Windows: client and server: http://www.tightvnc.com/
- Mac: server: OSXvnc http://www.macupdate.com/info.php/id/11283
- Mac client: Chicken of the VNC http://www.macupdate.com/info.php/id/9517
- Linux: vncviewer/vncserver package or tightvnc package
You can download a copy of the VNC client/server from the following links specfic to your platform.
Here is the link to common FAQ on Apache Tomcat. Links include how to install Tomcat as service, enable SSL (Security encrpytion)
Installation instructions
Note : You need a working Apache Tomcat installed before you proceed with the installation.
- Download the SAGEUI.WAR file from the downloads page.
- Copy the downloaded file into the webapps directory found under the Apache Tomcat installation root directory
Based on your tomcat installation configuration, sometimes you might have to re-start your tomcat server for the application to work.
Example: APACHE_ROOT_DIRECTORY = /home/user/apache-tomcat
Copy the SAGEUI.WAR file into /home/user/apache-tomcat/webapps directory. Restart the apache tomcat server with the command 'catalina.sh restart'
found in the /home/user/apache-tomcat/bin directory. If the tomcat has been installed on a machine named xyz.uic.edu and running on port 8443,
you should be able to access the application using the URL http://xyz.uic.edu:8443/sageui/index.jsp
Additional instructions
Once the application is installed, you have to run the SageProxyServer script everytime you start the SAGE application.
- Download the SageProxyServer.zip file from the downloads page. Please, make sure that you download the compatible proxy server.
- Extract the zip file contents to your preferred working directory.
- Run the proxy server script with the command 'python SageProxySecure.py host port password'
where host - host name of the machine running SAGE application, port - SAGE application port number, password - SAGE session password that you would like to use.
Note: The SAGE application has to be running before you start the SageProxyServer script.
How to share your desktop ?
Clients Only: To share your desktop you have to install a VNC server on your personal device (e.g., laptop, desktop). Currently, the application does not support NAT addresses, so if you are behind a router you would have to enable port forwarding in your router to share your desktop.
You can download a copy of the VNC client/server from the following links specfic to your platform.
- Windows: client and server: http://www.tightvnc.com/
- Mac: server: OSXvnc http://www.macupdate.com/info.php/id/11283
- Mac client: Chicken of the VNC http://www.macupdate.com/info.php/id/9517
- Linux: vncviewer/vncserver package or tightvnc package
Note: Configure your firewall to allow port 5900 (default VNC port). If the VNC server is running on some other different port, please allow exceptions for that port number on your firewall.