Download the java binary distribution at
os-distribution-release_number.zip
The server side of the Java distribution is based on the Tomcat 5.5 implementation. After unpacking os-distribution-releaseFnumber.zip there is a directory os-server-1.0 and a single file os.war. For users that have not installed the Tomcat server, os-server-1.0 contains all of the necessary files for a OS Solver Service. If you do not have a Tomcat server running do the following to setup a Tomcat server with the OS Solver Service on a Unix system:
http://localhost:8080/os/OSSolverService.jwsor
http://127.0.0.1:8080/os/OSSolverService.jwsYou should see a message Click to see the WSDL. Click on the link and you should see an XML description of the various methods available from the OSSolverService.
-serviceLocation http://***.***.***.***:8080/os/OSSolverService.jws -osil /parincLinear.osilwhere ***.***.***.*** is the IP address of the Tomcat server machine. Then, assuming the files testremote.config and parincLinear.osil are in the same directory on the client machine as the OSSolverService execute:
./OSSolverService -config testremote.configYou should get back an OSrL message saying the problem was optimized.
In a Windows environment you may want to start the Tomcat server as a service so you can log off (not shutdown) the machine and have the server continue to run. On a Windows machine do the following:
service.bat installThis will install Tomcat as a Windows service. To remove the service execute
service.bat remove
Note: There are many ways to start the Tomcat server and the exact way you choose may be different. See http://tomcat.apache.org/ and check out Tomcat version 5.5 for more detail. But do remember to properly set the Tomcat Working Directory to the path to os-server-1.0. By default, if you start Tomcat on Windows, the Working Directory is set to the Windows system folder, which will yield unpredictable results.
If you already have a Tomcat server with Axis installed do the following:
In the directory,
os-server-1.0/webapps/os/WEB-INF/code/OSConfigthere is a configuration file OSParameter.xml that can be modified to fit individual user needs. You can configure such parameters as service name, service URL/URI. Refer to the xml file for more detail. Descriptions for all the parameters are within the file itself.
Below is a summary of the common and important directories and files you may want to know.
os-server-1.0/webapps/os/contains the OS Web application. All directories and files outside of this folder are Tomcat server related.
os-server-1.0/webapps/os/WEB-INFcontains private and important os configuration, library, class and executable files to run the Optimization Service. All files and directories outside of this folder but within the /os Web application folder are publicly viewable (e.g. Web pages).
os-server-1.0/webapps/os/WEB-INF/code/OSConfigcontains configuration files for Optimization Services, such as the OSParameter.xml file.
os-server-1.0/webapps/os/WEB-INF/code/tempcontains temporarily saved files such as submitted OSiL/OSoL input files, and OSrL output files. This folder can get bigger as the service starts to run more jobs. For maintenance purpose, you may want to keep an eye on it.
os-server-1.0/webapps/os/WEB-INF/code/logcontains log files from the running services in the current Web application.
os-server-1.0/webapps/os/WEB-INF/code/solvercontains solver binaries that actually carry out the optimization process.
os-server-1.0/webapps/os/WEB-INF/code/backupcontains backup files from some of the above directories. This folder can get bigger as the service starts to run more jobs.
os-server-1.0/webapps/os/WEB-INF/classescontains class files to run the Optimization Services.
os-server-1.0/webapps/os/WEB-INF/libcontains library files needed by the Optimization Services.
os-server-1.0/confcontains configuration files for the Tomcat server, such as http server port.
os-server-1.0/bincontains executables and scripts to start and shutdown the Tomcat server.