User Tools

Site Tools


user-guide:additional_interfaces:http

This is an old revision of the document!


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.

user-guide/additional_interfaces/http.1737105176.txt.gz · Last modified: 2025/01/17 10:12 by Tim