Managing the CSS Service

Commerce Server 2009 Staging (CSS) runs as a Windows service that communicates with other servers to deploy site updates. The CSS service runs on each CSS server.

The CSS service starts automatically when your server starts. You can start, pause, resume, or stop the service at any time from the CSS Microsoft Management Console (MMC), the Windows command-line interface, or by using the staging API.

You use the CReplicationServer object to programmatically manage the CSS service.

Setting and Retrieving Global Properties for the CSS Service

You use the CReplicationServer.Put method to set and change a global property for the Commerce Server 2009 Staging (CSS) service that runs on a server. You use the CReplicationServer.Get method to retrieve a global property that is defined for a CSS service.

To retrieve all global properties, you use the CReplicationServer.Enum method. For a list of the global properties that you can set or retrieve, see the CReplicationServer.Put method.

Pausing and Continuing the CSS Service

You use the CReplicationServer.Pause and CReplicationServer.Continue methods to pause and continue the CSS service.

When you pause the CSS service, the CSS service rejects requests to start new replications. It does not stop any currently running replications. You should pause the CSS service before stopping the service. As soon as you pause the CSS service, the service will stay paused until you tell it to continue. If you try to deploy a project from or to a paused server, you will receive an error message.

After you pause the CSS service, wait five minutes before continuing the service to make sure that the CSS service is in the paused state.

Stopping and Starting the CSS Service

You use the CReplicationServer.Stop and CReplicationServer.Start methods to start and stop the service. You must call these methods whenever you modify a global property for the CSS service.

If you stop the CSS service abruptly you could destroy currently running projects. If you plan to stop CSS and still have projects running, pause the service first. Pausing the service before you stop the service causes the receiving server not to accept any more projects but to finish processing those that are already in progress.

After you stop the CSS service, wait five minutes before you restart the service to make sure that the CSS service is in the stopped state.

See Also

Other Resources

How to Set, Modify, and Retrieve Global Properties for a CSS Service

How to Pause, Continue, Start, and Stop the CSS Service

Managing CSS Servers

CReplicationServer Class

Managing the CSS Service Using the Staging API

What are the Staging API Concepts?