Skip to content

Stopping, Starting, and Restarting the Masking Engine

Overview

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.

Note

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.

Note

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.

Note

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.

  1. At the CLI prompt, type system.
  2. 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.
  3. To exit the CLI, type exit.

Note

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 startMasking again. 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