Restarting Masking Engine Service and Nonresponsive Issues (KBA5906)
Issue
You need to restart the masking service due to an issue. For example, this can occur when:
- Masking job has terminated but the status was not detected (job still in running state).
- A masking task (job or other) is taking a too long time and needs to be canceled and normal cancel doesn't work.
Masking Job Terminated but the Status was not Detected
It is possible for a job to terminate (for example due to not enough memory) and the job status remain undetected. To clear this state:
- Verify from the logs that no jobs are running.
- Restart the masking service.
Masking Task Needs to be Canceled
If a task was started and it is not completing, you may need to restart the masking service to cancel the task.
Restart is Taking a Long Time
The restart can take a long time if the previous job was a large job with a large Rule Set. Please provide enough time for the masking service to start up.
If you need assistance to verify, please open a support ticket.
This issue is caused by Syncable Objects being cleaned up and on very large Rule Sets this can take over an hour.
Applicable Delphix Versions
- Click here to view the versions of the Delphix engine to which this article applies
-
Major Release All Sub Releases 6.0 6.0.0.0, 6.0.1.0, 6.0.1.1, 6.0.2.0 5.3
5.3.0.0, 5.3.0.1, 5.3.0.2, 5.3.0.3, 5.3.1.0, 5.3.1.1, 5.3.1.2, 5.3.2.0, 5.3.3.0, 5.3.3.1, 5.3.4.0, 5.3.5.0 5.3.6.0, 5.3.7.0, 5.3.7.1, 5.3.8.0, 5.3.8.1, 5.3.9.0 5.2
5.2.2.0, 5.2.2.1, 5.2.3.0, 5.2.4.0, 5.2.5.0, 5.2.5.1, 5.2.6.0, 5.2.6.1
5.1
5.1.0.0, 5.1.1.0, 5.1.2.0, 5.1.3.0, 5.1.4.0, 5.1.5.0, 5.1.5.1, 5.1.6.0, 5.1.7.0, 5.1.8.0, 5.1.8.1, 5.1.9.0, 5.1.10.0
5.0
5.0.1.0, 5.0.1.1, 5.0.2.0, 5.0.2.1, 5.0.2.2, 5.0.2.3, 5.0.3.0, 5.0.3.1, 5.0.4.0, 5.0.4.1 ,5.0.5.0, 5.0.5.1, 5.0.5.2, 5.0.5.3, 5.0.5.4
4.3
4.3.1.0, 4.3.2.0, 4.3.2.1, 4.3.3.0, 4.3.4.0, 4.3.4.1, 4.3.5.0
4.2
4.2.0.0, 4.2.0.3, 4.2.1.0, 4.2.1.1, 4.2.2.0, 4.2.2.1, 4.2.3.0, 4.2.4.0 , 4.2.5.0, 4.2.5.1
4.1
4.1.0.0, 4.1.2.0, 4.1.3.0, 4.1.3.1, 4.1.3.2, 4.1.4.0, 4.1.5.0, 4.1.6.0
Resolution
To restart the masking engine, use the following commands on 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
Related Articles
- Starting, Stopping, and Restarting the Delphix Masking Engine (from version 5.2.6 docs).