By default, when you install s-Server as a sudo or root user, the installer sets up a service called s-dashboardd.
To start the service:
[sudo] service s-dashboardd start
To stop the service:
[sudo] service s-dashboardd stop
If you installed as a regular user or chose not to create the s-Dashboard service, you can run s-Dashboard manually by taking the following steps.
To run s-Dashboard in the foreground:
Command-line argument | Definition | Default |
---|---|---|
-d | Store dashboards in (overrides $SDASHBOARD_DIR) | …/s-Dashboard/dashboards/ |
-p | Specify port (overrides $SDASHBOARD_PORT) | 5595 |
-s | Server mode, restarts server if it exits | No |
-h -? | Show this help message | No |
-w | WebAgent port or URL. | For example: http://yourhost:5580 where “yourhost” is the name of the server running s-Server. If not specified, s-Dashboard looks for WebAgent on port 5580 of the same server running s-Server. |
To stop s-Dashboard foreground process:
Use the …/s-Dashboard/stopDashboard.sh script.
By default you will see a few demo dashboards that are stored in the …/s-Dashboard/dashboards directory.
When you are developing your own applications, you will want to save your dashboards somewhere else, as part of your application directory structure. This is achieved using the SDASHBOARD_DIR environment variable.
For the foreground process, SDASHBOARD_DIR is set using the -d command line switch.
If you are using the s-Dashboard service, you can set SDASHBOARD_DIR by editing the file /etc/default/s-dashboardd.
By using multiple ports, you can run multiple instances of s-Dashboard. The default port is 5595. You can specify any available port by using the -p command line argument, as in:
./s-dashboard -p 5596
You may also need to specify a dashboard directory for the additional instance by using the -d argument, as in:
./s-dashboard -p 5596 -d /my/other/project/dashboards
To launch s-Dashboard in your browser, open a browser and enter http://<my.server.com>:<port> (often you will be using http://localhost:5595).
This will redirect to http://<my.server.com>:<port>/dashboards where you will see a list of all the dashboards in the directory designated by SDASHBOARD_DIR.