Building a Sample Service

On Windows, the sample Scribble service is available in C++, C# and Java; the sample Asteroids service is available in Java.

On Linux, only the sample C++ Scribble service is available.

Most sample services are managed services. They must run on the same system node as the PureWeb server, and the server automatically handles the application/process life cycle. The only exception is the Scribble sample service on Windows, which can be deployed as either a managed or an unmanaged service. An unmanaged service does not need to reside on the same system node as the server, but with an unmanaged service you must start and stop the application outside of the PureWeb server.

These steps assume that you have already installed the SDK. See Installation Instructions.

The System Requirements list the development tools that you need to work with the samples, depending on the programming language that you choose for the service and the client.

If the server is already running when you build and deploy a service for the first time, you will need to reload the plug-ins as described in note below. Each procedure on this page will include instructions when this step should be performed.

You must perform a reload or restart the server before server configuration or plug-in file changes take effect.

To perform a reload, navigate to the server's Configuration page and click the Reload button for the section where the file is located within the page (for example, if you edited a plug-in configuration file, click the Reload Plugins button, if you edited a logging configuration file, click the Reload Logging button, and so on).

If you edit a configuration file, the server will display a reload required message beside this file in the Configuration page as a reminder until the changes have been applied.

C++ Service

C# Service

Java Service

These procedures apply to both Scribble and Asteroids, and include additional steps for building Scribble as an unmanaged service.

Starting an Unmanaged Service

If you built a managed service, you do not need to start it separately: the PureWeb server will start it automatically when you launch the client.

If you built an unmanaged service, start it first before launching the client application.