DominoIQ task status and controls

Use Domino IQ server task status, along with console/tell commands, to help monitor and Domino IQ.

Server thread states

The DominoIQ thread in the server process has the following states to aid in error handling or configuration issues.

Table 1.
Task State Description
DominoIQ : Disabled The current server is not listed as a DominoIQ server. But the thread will poll until either the server exits or the admin configures it as one.
DominoIQ : No Configuration The current server is listed as a DominoIQ server, but there is no active configuration assigned to this server. The thread will poll until the server exist or the admin creates an active configuration.
DominoIQ : Launching : Model - <name> The server has launched the AI angine, but it hasn't confirmed that the model has loaded. This state is rarely seen since the load happens pretty quickly.
DominoIQ: Loading : Model - <name> The server has launched the AI angine, but it hasn't confirmed that the model has loaded. This state is rarely seen since the load happens pretty quickly.
DominoIQ: Running : Model - <name> The AI engine had loaded the model and it ready to receive requests.
DominoIQ: Standby - Failure The AI engine has exited. The AI engine will be re-launched up to 3 times. Each time it will go back to the Launching state. If it is not successful by the 3rd try, it will stop trying and stay in this state. See the 'resume' command.
DominoIQ: Standby - No model The 'unload' tell command was used to unload the model and terminate the AI engine. See the 'resume' command.

Server console/tell commands

  • If the DominoIQ thread has fully terminated due to an error, there will be no "DominoIQ:" status seen on the server. The server console command dominoiq start will relaunch the DominoIQ thread from scratch.
  • The tell command tell dominoiq unload can be used to transition from the DominoIQ: Running state to the DominoIQ: Standby - No Model state, thereby terminating the AI engine. This can be used where the administrator wants to change the configuration to change to a different model.
  • The tell command tell dominoiq resume can be used to transition from the DominoIQ: Standby - No Model/Failure state to the DominoIQ: Running state. This can be used where the administrator wants to change the configuration to change to a different model or correct a configuration option that caused the AI engine to fail to load.