It is assumed that readers are familiar with the SimbaEngine SDK. Use this only for versions 9.5 and earlier.
You can run SimbaServer as a Windows service, which can be much more convenient for your customer because you can configure it to start automatically when Windows starts. Note that all commands need to be run from a command line that has administrative privileges or is ‘Run as Administrator’ (for Windows Vista or later).
Using the Quickstart sample server as an example, these are the steps to configure the server to run as a service:
- Open a command line with administrative privileges.
- Navigate to the directory that contains QuickstartDSIIServer.exe.
- From the command line, execute “QuickstartDSIIServer.exe -Install”. This will configure the Quickstart SimbaServer as a Windows Service on your local machine. If you want your installer to perform the configuration simply have it run the same command line.
- The service as configured is called “SimbaQuickstartService”, and it is set up to start automatically when Windows starts.
- You can reconfigure it or manually start it immediately from the Services Administrative Control Panel.
- You can also start and stop it from a command line by executing “net start SimbaQuickstartService” to start it and “net stop SimbaQuickstartService” to stop it
- To uninstall SimbaQuickstartService, execute “QuickstartDSIIServer.exe -Uninstall” from a command prompt or have your installer execute the same command line.
NOTE: To allow for SimbaServer to be installed as a service, your DSIDriverFactory() implementation will need to call Simba::Server::SetServiceName() with the name of the service. Refer to Quickstart for an example. This is the name that will be displayed for the service, and in the case of Quickstart this is set to “SimbaQuickstartService”.
For more information on SimbaEngine SDK client and server, please see the Client-Server User Guide.