Domino REST API task
On Domino servers, Domino REST API can be loaded using load restapi
in the Domino server console.
To automatically start the Domino REST API on server start, the mode of operation you want for a production system, add restapi
to the values of the notes.ini
entry ServerTasks
.
The launch of the Domino REST API is governed by the notes.ini
key KeepInstallDir
, which is set by the Domino REST API installer.
Caution
If you've configured https
for the Domino REST API, modify the notes.ini
setting KeepManagementURL
to https
. By default, this setting is http://localhost:8889
. Not doing so will prevent the restapi task from starting.
Domino REST API task commands
Once the restapi task is loaded in the Domino console, you can use the following commands to interact:
Command | Effect |
---|---|
load restapi |
Start the Domino REST API. |
tell restapi quit |
End Domino REST API. |
tell restapi reload |
Restart with new configuration. |
tell restapi [show] info |
Show loaded components (geek stuff). |
tell restapi [show] config |
Show current configuration. |
tell restapi [show] status |
Show version information and state. |
tell restapi reload cache [database] [application] |
Reload Domino REST API's database and application cache. Leave off optional parameters for both. |
The following are settings that can be set in the notes.ini
Setting | Requirement | Description |
---|---|---|
KeepInstallDir |
required | Where Domino REST API is installed |
KeepJavaHome |
optional | Use a different Java binary than the one in {dominoBin}/jvm |
KeepManagementURL |
optional | Domino REST API management URL if different than http://localhost:8889 |
KeepNumAttachAttempts |
optional | Number of attempts to get status of Domino REST API launch (default 10) |
KeepLaunchWaitSecs |
optional | Number of seconds to wait before executing java command (default 0) |