ingstop Command--Stop Actian Analytics Engine Instance
Permission required: Installation owner, privileged user.
IMPORTANT! To use this command, you must be logged into the installation owner account.
The ingstop command shuts down an Actian Analytics Engine installation. It stops the servers in an orderly fashion for reconfiguration or system shutdown. It automatically brings down all or selected server-related processes in the installation. It can shut down servers, the archiver and recovery processes, and deallocate shared memory.
The ingstop command provides a graceful shutdown - the program waits for all traffic to terminate and for all users to exit before shutting down the processes. You can optionally specify a forced shutdown.
Since it is important that processes be brought down in the correct sequence, it is recommended to use ingstop whenever you shut down the entire installation. You can also use ingstop to shut down the locking and logging system.
The ingstop command has the following format:
Linux
ingstop [ -timeout=minutes ] [ -force | -immediate ] [ -kill ]
[ -iigcn ] [ -dmfrcp ] [ -dmfacp ] [ -rmcmd ] [ -mgmtsvr ] [ -iidbms ] [ -iistar ] [ -iigcc ] [ -iigcd ] [ -udf_engine ] [-tensorflow] [-onnx] [ -spark_provider ] [ -help ]
Windows
ingstop [ -timeout=minutes ] [ -force | -immediate ] [ -kill ] [ -show | -check ]
[ -iigcn ] [ -dmfrcp ] [ -dmfacp ] [-client ] [ -rmcmd ] [ -mgmtsvr ] [ -iidbms ] [ -iistar ] [ -iigcc ] [ -iigcd ] [ -iigcb ] [-f ] [ -udf_engine ] [-tensorflow] [-onnx] [ -spark_provider ] [ -help ]
-timeout=minutes
Waits the specified number of minutes for active sessions to terminate before shutting down the installation.
-force
Forces the shutdown of active servers in the installation without waiting for users to disconnect.
-immediate
Shuts down the installation immediately. It does not wait for currently executing transactions to complete. Transaction recovery will be required when the installation is restarted.
-kill
Shuts down the installation without waiting for currently executing transactions to complete. Transaction recovery will be required when the installation is restarted. Any processes that cannot be shut down by conventional means are terminated.
This parameter is usually used with the –f parameter.
-show | -check
(Windows only) Displays a list of currently running processes, but does not shut them down.
-iigcn
Stops the Name server.
-dmfrcp
Stops the recovery process.
-dmfacp
Stops the archiver process.
-client
(Windows only) Stops a client service by stopping only the Name server and Communications server.
-rmcmd
Stops the Remote Command server required by Visual DBA.
‑mgmtsvr
(For Linux) Stops the Management server used by the Actian Director.
(For Windows) Stops the Remote Manager service, which controls the shutdown of the Management server.
-iidbms
Stops the DBMS server.
Note: If any DBMS server has connected sessions, issuing ingstop –iidbms will not result in a graceful shutdown. The shutdown of the DBMS and Star servers will be aborted, and these active servers will be re-opened for connections.
-iistar
Stops the Star server.
-iigcc
Stops the Communications server.
-iigcd
Stops the Data Access server.
-iigcb
(Windows only) Stops the Bridge server.
-f
(Windows only) Forces immediate shutdown. It initially quiesces all Net and DBMS servers. If active sessions remain after 30 seconds, a "STOP SERVER" forcible shutdown is issued to the DBMS server, and equivalent hard stops are issued to all Net servers. Ingstop then waits indefinitely for the logging system to stop before completing the shutdown.
To ensure shutdown within a reasonable amount of time, use –f with the –kill parameter, which uses a graduated approach:
• Tries a quiescent shutdown.
• Attempts a STOP SERVER.
• Executes a “kill -9” hard kill of the servers.
If STOP SERVER succeeds in shutting down the DBMS, but the logging system remains active after 100 seconds, the logging system is forced to stop immediately (rcpconfig -imm_shutdown) or killed if it does not stop. Therefore, ingstop -f -k is appropriate for use in a system shutdown procedure.
-udf_engine
Shuts down the UDF engine processes.
-tensorflow
Stops active Actian Analytics Engine Tensorflow containers.
-onnx
Stops active Actian Analytics Engine ONNX containers.
-spark_provider
Shuts down the Spark Connector container.
-help
Displays command syntax online.