Preliminary documentation for Ice for MATLAB. Do not use in production applications. Refer to the space directory for other releases.

Incorporating everything we discussed previously, we can now configure and start IceBox servers.

On this page:

Starting the C++ IceBox Server

The configuration file for our example C++ service is shown below:

IceBox.Service.Hello=HelloService:create
Hello.Endpoints=tcp -p 10001

Notice that we define an endpoint for the object adapter created by the Hello service.

Assuming these properties reside in a configuration file named config, we can usually start the C++ IceBox server as follows:

icebox++11 --Ice.Config=config
icebox --Ice.Config=config

Additional command line options are supported, including those that allow the server to run as a Windows service or Unix daemon.

32-bit IceBox on 64-bit Linux

On 64-bit Linux, the 32-bit IceBox executables (when provided) are named icebox32 (C++98) and icebox32++11 (C++11).

Starting the Java IceBox Server

Our Java configuration is nearly identical to the C++ version, except for the entry point specification:

IceBox.Service.Hello=HelloServiceI
Hello.Endpoints=tcp -p 10001

Notice that we define an endpoint for the object adapter created by the Hello service.

Assuming these properties reside in a configuration file named config, we can start the Java IceBox server as follows:

$ java -jar icebox-3.7.0.jar --Ice.Config=config
$ java -jar icebox-compat-3.7.0.jar --Ice.Config=config

Starting the C# IceBox Server

The configuration file for our example C# service is shown below:

IceBox.Service.Hello=helloservice.dll:HelloService
Hello.Endpoints=tcp -p 10001

Notice that we define an endpoint for the object adapter created by the Hello service.

Assuming these properties reside in a configuration file named config, we can start the C# IceBox server as follows:

$ iceboxnet --Ice.Config=config

IceBox Server Failures

At startup, an IceBox server inspects its configuration for all properties having the prefix IceBox.Service and initializes each service. If initialization fails for a service, the IceBox server invokes the stop operation on any initialized services, reports an error, and terminates.

See Also

  • No labels