ETERNUS SF AdvancedCopy Manager V16.9 Operation Guide

1.6.2 Enabling the Volume Lock Error Investigation Function

This section explains how to set the investigation tool used by the volume lock error investigation function.

Point

Read "1.3 Notes When Using User Account Control (UAC)" above, before setting an investigation tool.

1.6.2.1 When to Set Investigation Tool

Since handle.exe does not reduce OS performance, it is recommended to enable this function before operations start (always leave it enabled), so that the cause of "in-use lock errors" can be quickly identified.

And since openfiles.exe does cause OS performance deterioration, it is recommended to enable this function only when an "in-use lock error" has occurred.

1.6.2.2 Setting handle.exe

To use handle.exe, download it from the Microsoft Corporation URL (https://docs.microsoft.com/sysinternals/downloads/handle) and store it in the following directory.

Server Type	Location
Managed Server	workDirectory\var\HandleTool The workDirectory means "Work Directory" specified at the AdvancedCopy Manager's agent installation. "C:\Win32app\AdvancedCopyManager" is the default installation destination directory.
Management Server also serves as a Managed Server	workDirectory\ACM\var\HandleTool The workDirectory means "Work Directory" specified at the ETERNUS SF Manager installation. "C:\ETERNUS_SF" is the default installation destination directory.

In a clustered environment, store handle.exe at all nodes that comprise the clustered system.

Also after handle.exe is stored, perform the following tasks at all nodes where it is stored.

1. Grant a license for the account that executes the AdvancedCopy Manager command.

   1. Log into the operating system using the user account that executes AdvancedCopy Manager commands.

   2. At the command prompt, go to the directory where handle.exe is stored.

   3. Execute handle.exe from the command prompt.

   4. If the "Handle License Agreement" dialog box is displayed, then click Agree if you agree with the conditions of use.

2. Grant a license for the AdvancedCopy Manager COM Service account.

   1. Prepare the service name unused in the target server.
      You can use the following command to confirm whether its service name is used or not.

      > sc qc "service_name_to_confirm"

      Example

      How to confirm whether the service name "ACMHandle" is used or not:

      > sc qc "ACMHandle"

      On later steps, the service name prepared in this step is called "Unused service name".

   2. Enable interactive services of the target server.

      Set the value of "NoInteractiveServices" contained in the registry key "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Windows" to 0. If zero (0) is already set, this registry operation is not needed.

      Note

      If the registry operation is wrong, a serious problem can occur. Take good care to edit the registry.

   3. Execute the following commands.

      > sc create "Unused_service_name" binPath= "%systemroot%\system32\cmd.exe /k <handle.exe stored directory>\handle.exe" type= own type= interact
      > sc start "Unused_service_name"

      Example

      When the Unused service name is "ACMHandle" and the handle.exe stored directory is "C:\Win32app\AdvancedCopyManager\var\HandleTool":

      > sc create "ACMHandle" binPath= "%systemroot%\system32\cmd.exe /k C:\Win32app\AdvancedCopyManager\var\HandleTool\handle.exe" type= own type= interact
      > sc start "ACMHandle"

   4. Display the window by clicking the icon that appears on the task bar.

   5. Click Show me the message or View the message in the window.

   6. If the "Handle License Agreement" dialog box is displayed, then click Agree if you agree with the conditions of use.

   7. Click Return now.

   8. Execute the following command.

      > sc delete "Unused_service_name"

      Example

      When the Unused service name is "ACMHandle":

      > sc delete "ACMHandle"

   9. Disable interactive services of the target server.

      Set the value of "NoInteractiveServices" contained in the registry key "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Windows" to 1.

      Note

      If the registry operation is wrong, a serious problem can occur. Take good care to edit the registry.

Note

If the above tasks are not performed in advance, then commands stop responding when an "in-use lock error" occurs.
At this time, the "Handle License Agreement" dialog box is not displayed.
Use the Task Manager to forcibly end handle.exe processing.

1.6.2.3 Setting openfiles.exe

To use openfiles.exe to track information on files opened locally, perform the following procedure to enable the 'maintain objects list' option. In a clustered environment, perform the following procedure at all nodes that comprise the clustered system.

1. Execute "openfiles /local on" from the command prompt.

2. Restart the operating system.