This is an old revision of the document!
Table of Contents
HTTP server user guide
It is possible to start GroIMP as a HTTP server to then send model paths via HTTP for GroIMP to execute. After GroIMP executed the model values can be returned to the HTTP client who send the request. It is possible to send several models in series or in parallel.
Execution
The HTTP server is part of every GroIMP release and can be executed as an command through the GUI or as a headless command.
GUI
In the main GroIMP menu under the section Net, the entry Open HTTP Server can be found. This will lead to a popup requesting the port number of the server (for more information about the port see below). After a port was given (usually the default one is fine) a new workbench with only the Messages panel is opened. The server now runs until this workbench is closed.
Headless
The GroIMP headless interface allows the execution of specific commands without starting the GUI by using the -cmd command.
In the case of the http server this command is as following:
java -jar core.jar --headless -- -cmd "/http/server=58080"
The name core.jar can variate debending on the way GroIMP was installed. “58080” is in this case the port, which can be changed if needed.
Commands
Options
Port
A port on a computer is used to define which application is actually meant by a network request. This is very useful to run several applications are using network protocols at the same time. For this to work the port needs to be unique, meaning no two applications can “listen” to the same port at the same time. Therefore in GroIMP it is possible to define which port is suppose to be used, for the case that an other application is already using the default one. Or for the scenario of running two GroIMP http server at the same time.