Command-Line Watson Explorer Engine Administration Commands
(ID: API_INVALID_SU_TOKEN) The current session could not be authenticated with a su-tokenoften indicates that the Watson Explorer Engine installation was initialized using a configuration api-url whose hostname or IP address can no longer be resolved from the system on which Watson Explorer Engine is installed. You can eliminate this error message by using the embedded-webserver-config command.
Watson Explorer Engine provides two commands that can be used from any command prompt to start or stop Watson Explorer Engine on a given system. These commands are easily integrated into a system's startup and shutdown procedures to guarantee the availability of Watson Explorer Engine or other applications that use Watson Explorer Engine. These applications are the engine-start and engine-shutdown commands, which are located in the bin subdirectory of your Watson Explorer Engine installation directory.
On Linux and Microsoft Windows systems, you can run the engine-start and engine-shutdown commands as any user that has write access to the data/su-tokens subdirectory of the Watson Explorer Engine installation that you are starting or stopping. This is typically the user that you installed the Watson Explorer Engine software as. The root user on Linux systems and the Administrator user on Microsoft Windows systems should always have write access to this directory.
The next sections provide complete reference information for Watson Explorer Engine command-line startup and shutdown commands. For information about integrating these commands into your system's startup process, see Integrating Watson Explorer Into the System Startup and Shutdown Process. A subsequent section also discusses the embedded-webserver command, which can be used to manually start, stop, and restart the Watson Explorer Engine embedded web server. For information about configuring the embedded web server, see Configuring the Watson Explorer Engine Embedded Web Server.
Watson Explorer Engine provides single commands that enable you to start and stop all of its processes in an orderly fashion. For information about the command that is used to start Watson Explorer Engine, see engine-start. For information about the command that is used to shut down Watson Explorer Engine, see engine-shutdown. For information about integrating these commands into your system's startup process, see Integrating Watson Explorer Into the System Startup and Shutdown Process.