If the default installation location is used, the engine-tools.sh script location is as follows: /engine_install/resources/tools/engine-tools.sh, where engine_install is the installation directory. Use the following options with the engine-tools.sh command to gather troubleshooting data about your engine. You can change to the directory or use enter the path as part of the command. The options can be used in combination.
If a high availability installation is used, you can use the ha-engine-tools.sh script instead. If the default installation location is used, script location is as follows: /engine_install/resources/tools/ha/ha-engine-tools.sh, where engine_install is the installation directory. Except for the -r option, the following options can be used with the ha-engine-tools.sh command.
| Option | Argument | Description |
|---|---|---|
| -a | None | Store the configuration and log files in a .tar file. Use this option with other options such as -c, -e, -i, -l, and -p. For example, enter ./engine-tools.sh -c -a. |
| -c | None | Collect files and logs for IBM UrbanCode Deploy engine services. |
| -d |
|
Modify or view the heat debug setting. Specify [ on|off|status ]. For example, enter ./engine -d off -s restart. |
| -e | None | Create a backup of the IBM UrbanCode Deploy engine plug-in by copying the contents of the /usr/lib directory |
| -i |
|
Collect system, OpenStack, or database information, such as host names, ports, process limits, and configuration details. Specify [ system|openstack|database|all ]. |
| -l | None | Collect heat engine and Keystone logs. |
| -p | None | Check the performance of the heat engine and redirect the performance output to the heat_performance.#.out file. Before you run this command, you must source the clientrc file that is located in the /root/ directory. |
| -r Restriction: This option is not available with the
ha-engine-tools.sh script.
|
|
Report on, restart, stop, or start all the required services such as MySQL, MariaDB, and RabbitMQ. Specify [ status|restart|stop|start ]. For example, enter ./engine_tool.sh -r status. |
| -s |
|
Check the status of the OpenStack services (engine and Keystone), or restart, stop, or start the services. Specify [ status|restart|stop|start ]. For example, enter ./engine_tool.sh -s restart. |
| -t | None | Tail the heat engine log and view real-time log values. |