The PalmOrder Server Windows distribution can be run in the system tray, in the console, or as a Windows service. The service is convenient for an always-on computer: it does not depend on an open application window.
Before starting
- Extract the Windows distribution to a permanent directory, such as
C:\PalmOrderServer. - Edit
config\application.ymland change the default admin password. - Make sure the local server is not running through
run-console.bat. - Log on to Windows with an account with administrator rights.
Running without service
Double-click PalmOrder Server.exe. The server will start and the PalmOrder icon will appear in the system tray. Through its menu, you can open the control panel, the configuration, data and log directories, as well as stop or start the local server.
To run in the console, open run-console.bat. This option is convenient for diagnostics: the server works as long as the console window is open; press Ctrl+C for normal termination.
If necessary, the portable JVM distribution can also be run on Windows. Common requirements and commands are described on the page Portable JVM.
Install the service
- Run PalmOrder Server.exe if the application is not already running.
- Click the PalmOrder icon in the system tray. If the status shows that the server is running as an application, select Stop App Server.
- Select Install Windows Service….
- Confirm the Windows prompt and wait for the installation to complete.
If the application is not available in the system tray, open the PalmOrder Server directory in Explorer, right-click install-service.bat and select Run as administrator.
The script installs and starts a service named PalmOrderServer. It uses the same config, data, logs, and palmorder.sqlite as the system tray app.
Open http://localhost:8888/ui and make sure the control panel is available.
Manage the service
Scripts are available in the distribution directory:
| File | Action |
|---|---|
start-service.bat | Starts the service. |
stop-service.bat | Terminates the service. |
uninstall-service.bat | Stops and removes the service. |
Use administrator rights to install or uninstall. The status of the service can also be checked in the standard Windows console Services (services.msc) under the name PalmOrder Server.
Important The PalmOrder icon in the system tray may remain running with the service. Do not run a service and a local server in application mode at the same time: both will try to use the same port and server data.
Access to data
The service must have write access to data, logs, palmorder.sqlite and all its own directories inbox and outbox. If you store data on a network resource, check the permissions of the account that runs the service.
Before upgrading or moving the server, stop the service via stop-service.bat and create a backup. See Update and Backup.