Server Command Line Options

All D3 servers share the following common set of options from the D3Programs directory:

Syntax

d3vme.exe { [ /install | /remove | /debug | /start | /stop | /kill | /unexport { service } | /ping { server } /pdebug | /mds | /restore | /fileload ] }

d3fsi.exe /mds

Parameters

/install

Install the service on the server.

On Windows, the service is added to the Windows Service Database. The control panel Services applet allows you to control the service.

This command also registers the interface to the Microsoft Locator Service, if available.

NOTE—The /install option must be run again when:

  • The server.exe file is moved to a new location. Failure to do so results in the service not being started automatically at boot time.

  • New network protocols are added to the system. Failure to do so prevents the server from using the new protocols.

/remove

Remove the service from the server.

/debug

Start the service in foreground. This option should be used only to perform special operations. The service must be stopped for this command to succeed.

/start

Start the service in background, but not under the control of the Service Control Manager. In other words, the SCM would not show the service as started. Only one instance of the service can run. If another instance is started, it terminates silently (see Error Logging).

/stop

Request to stop the service on the system.

NOTE—The actual service shutdown may not occur immediately. The service waits until all current requests are completed. If the server cannot be reached or if the service is already shut down, this command reports a failure.

/kill

Kill the server running on the system unconditionally. This command should be used with extreme care since current calls will be interrupted and resources may not be released. Use /stop first.

/unexport { service }

Remove from the Name Service all references to the specified service on the current server. If service is not specified, the service implicitly provided by the server is removed. Extreme care must be used if a service is still running when specifying this command, since it makes the service inaccessible. Only the /kill option can terminate a service made inaccessible by this option.

/ping { server }

Test whether the service on the specified server is available. If server is not specified, the service on the current system is checked.

/pdebug

Starts up a VME Service in debug mode as well as starting a d3pdebug process.

/mds

Creates a new FSI database.

/restore

Clears the VME and rebuilds it with the data on the tape. FSI accounts are overlayed if they exist on disk. If records in the file exist on tape, the tape records take precedence. Any records that exist in the file that are not on tape are left untouched.

For Windows Only: If any of your data contains encrypted data, the OpenSSL libraries must be present when restoring a save. Otherwise the restore process will terminate. See the encrypt-file Command topic in the D3 Reference Manual for more information.

/fileload

Clears the VME and the FSI before doing a full file restore with the data on the tape.

For Windows Only: If any of your data contains encrypted data, the OpenSSL libraries must be present when restoring a save. Otherwise the restore process will terminate. See the encrypt-file Command topic in the D3 Reference Manual for more information.

Additional options may be available for the various servers.

See Also

Client Server Architecture

Service Setup

Server Configuration

Client Configuration

Error Logging

Multiple Virtual Machines on D3 Windows