Stopping, Starting, and Restarting the Masking Engine¶
This article describes how to stop, start, and restart the Delphix Masking Engine. Use cases, troubleshooting tips before a restart, and steps in the CLI are outlined in the following sections.
Use Cases Examples¶
Stopping and starting the Masking Engine may be required when performing:
- Masking Engine maintenance work.
- Backup and Restore.
Restarting the Masking Engine may be required if:
- The Masking Engine is unreachable or unresponsive.
- A Masking Job is in an incorrect state.
Stopping and Starting the Masking Engine will terminate all running jobs; this includes Imports, Inventory Scans, Profiling and Masking Jobs, etc.
Troubleshooting Before a Restart¶
If the Masking Engine is unreachable, the following should always be checked before a restart:
- Verify that the Engine is reachable over the network using ping.
Verify that no jobs are running (unless the job should be terminated). If a root cause investigation is needed, please open a case with Delphix Support and upload a support bundle.
Using the shell or putty, access the Masking Engine and login using the sysadmin user.
The sysadmin password is the password set when the Masking Engine was configured.
# Access CLI using SSH. ssh sysadmin@<yourEngine>
Using the Command-Line Interface (CLI)¶
The CLI provides means to access information and execute commands on the Engine without a GUI; one of which is to stop and start the Delphix Masking Engine. This is done using the system menu.
- At the CLI prompt, type system.
- At the system prompt, do one of the following, depending on the desired action:
a. To enable the engine: type startMasking and then commit.
b. To disable the engine: type stopMasking and then commit.
c. To restart the engine: type stopMasking and commit, then startMasking and commit.
- To exit the CLI, type exit.
If the Masking Engine fails to start, it could be worth waiting a few minutes (2 minutes or so) and then try
stopMasking, followed by
Startup failure could be the masking service entering Maintenance Mode. You cannot clear Maintenance Mode by entering
startMasking; you must use
stopMasking, followed by
startMasking. If this fails, Delphix Support needs to investigate why the service failed.
Restarting the Masking Engine Example¶
Below is an example of how to restart the Delphix Masking Engine using the CLI.
$ ssh sysadmin@yourEngine Password: yourEngine> system yourEngine system> ls startMasking stopMasking yourEngine system> stopMasking yourEngine system stopMasking *> commit yourEngine system> startMasking yourEngine system startMasking *> commit yourEngine system> exit Connection to yourEngine closed