I.8 Troubleshooting the Configuration Service

After Test Cutover or Cutover, an error occurs on the target VM because of non-specific Configuration Service issues. The common error message is:

Configuration service in the target machine does not seem to have started

Troubleshooting tips in this section explain common Configuration Service issues and some alternative ways to resolve them.

I.8.1 Understanding What Is Causing the Problem

The Configuration Service error indicates that the PlateSpin Server is unable to communicate with the Configuration Service on the Target VM. Analyze your system to determine the possible root cause of the problem.

Target VM Fails to Boot

The operating system must be loaded in the target VM in order for the Configuration Service to start up normally. A failure to boot indicates that there could be a driver conflict, a boot loader error, or possible disk corruption.

We recommend that you open a service ticket with Micro Focus Customer Care if the operating system fails to boot on the target VM.

Network Is Not Set Up Correctly

The network must be set up correctly in order for the Configuration Service on the target workload to communicate with the PlateSpin Server.

Ensure that you have configured your network in a way that the target workload can communicate with the PlateSpin Server.

Unable to Read or Write Status Messages to Floppy Devices

The Configuration Service must be able to communicate with the floppy devices for VMware VMs in order to read and write status messages for the PlateSpin Server.

On the target VM, verify that the machine is able to communicate with the floppy devices:

  1. On the VM, open the log file (C:\windows\platespin\configuration\data\log.txt).

  2. Any of the following messages might be an indication that the floppy is inaccessible:

    Failed (5) to write to file \\?\Volume{<guid-number>}\log.zip
    
    CopyFile \\?\Volume{<guid-number>}\windows\platespin\configuration\data\result.txt 
    to \\?\Volume{<guid-number>}\result.txt failed
    
    The output floppy was not accessible after the timeout period

I.8.2 What Can Be Done to Resolve the Problem

To resolve a Configuration Service error, you can try any of the solutions in this section.

Skip the Target VM Reboot Optimizations

Migrate tries to minimize the number of reboots that occur on the target VM by default in order to speed up the Cutover process. It is possible that allowing the additional reboots will improve the target VM’s ability to communicate with the PlateSpin Server.

To skip reboot optimizations:

  1. Log in as Administrator to the PlateSpin Migrate Web Interface, then open the PlateSpin Server Configuration page at:

    https://Your_PlateSpin_Server/PlateSpinConfiguration/

  2. Search for the parameter ConfigurationServiceValues.

  3. Edit the ConfigurationServiceValues parameter and set the SkipRebootOptimization option to true.

  4. Click Save.

  5. Run an incremental or full replication.

    The replication also propagates the modified configuration settings to the target VM.

  6. Run the Test Cutover or Cutover again for affected workloads.

Reduce the Read/Write Traffic to Floppy Devices

You can decrease the number of times the PlateSpin Server attempts to read from and write to the VMware input or output floppy devices if the diagnostic log shows the following error:

Information:1:Attempting floppy download

followed by

Verbose:1:Failed to copy file from remote URL

-or-

Exception: The remote server returned an error: (500) Internal Server Error

This error is caused by VMware locking the resource. It indicates that the PlateSpin Server is detaching and reattaching the floppy each time it checks the status. Locking can cause the target VM to fail to read and write to the floppy device. See Using the VMware vCenter Server 4.x,5.x and 6.0 Datastore Browser to Download or Copy a Powered-On Virtual Machine's .vmx and .nvram Files Fails (1019286).

If you experience floppy device locking issues, you can increase values for the Configuration Service polling settings on the PlateSpin Server:

vmwareConfigServicePollStartDelay

This parameter determines how long to wait before the PlateSpin Server starts polling for target workload status. The default value is 120 seconds (2 minutes).

vmwareConfigServicePollIntervalInMilliseconds

This parameter determines how frequently the PlateSpin Server attempts to communicate with the target workload and to read or write to the VMware floppy devices. The poll interval default is 30000 ms (30 seconds).

vmwareConfigServicePollStartTimeout

This parameter determines how long the PlateSpin Server waits after it starts the target VM before it displays an error in the Web Interface. The default value is 420 seconds (7 minutes).

vmwareConfigServicePollUpdateTimeout

This parameter determines how long the PlateSpin Server waits after each polling interval before displaying an error in the Web Interface. The default value is 300 seconds (5 minutes).

Higher values for these parameters reduce the frequency that the PlateSpin Server attempts to read from and write to the VMware floppy devices on target VMs.

To reduce read and write traffic for VMware floppy devices:

  1. Log in as Administrator to the PlateSpin Migrate Web Interface, then open the PlateSpin Server Configuration page at:

    https://Your_PlateSpin_Server/PlateSpinConfiguration/

  2. Search for the Configuration Service polling parameters, modify their settings as appropriate, then click Save.

    For example:

    vmwareConfigServicePollStartDelay = 180 (3 minutes)
    vmwareConfigServicePollIntervalInMilliseconds = 300000 (5 minutes)
    vmwareConfigServicePollStartTimeout = 1200 (20 minutes)
    vmwareConfigServicePollUpdateTimeout = 900 (15 minutes)

    or

    vmwareConfigServicePollStartDelay = 300 (5 minutes)
    vmwareConfigServicePollIntervalInMilliseconds = 480000 (8 minutes)
    vmwareConfigServicePollStartTimeout = 1200 (20 minutes)
    vmwareConfigServicePollUpdateTimeout = 900 (15 minutes)
  3. Run an incremental or full replication.

    The replication also propagates the modified configuration settings to the target VM.

  4. Run the Test Cutover or Cutover again for affected workloads.

Change the Startup Type to Increase the Delay

The Configuration Service might be coming up before resources are accessible. You can change the Configuration Service startup type to have increase the delay.

To change the startup type:

  1. Log in as Administrator to the PlateSpin Migrate Web Interface, then open the PlateSpin Server Configuration page at:

    https://Your_PlateSpin_Server/PlateSpinConfiguration/

  2. Search for the parameter windowsConfigServiceStartType.

  3. Change the windowsConfigServiceStartTypevalue to AutoDelay.

    Options for windowsConfigServiceStartType are:

    • GroupDelay is the default value and adds the Configuration Service to the end of the ServiceGroupOrder in the registry.

    • AutoDelay will maximize the amount of time the service waits before starting (2 minutes after boot). Also modify the ServicesPipeTimeoutForWindowsConfigService parameter value in Step 4.

    • NoDelay is the most efficient option and starts the service as soon as Windows can. However, it is not recommended because of the potential issues connecting to resources.

  4. (AutoDelay) Change the ServicesPipeTimeoutForWindowsConfigService parameter setting to 180 seconds to account for the 120 seconds that the service will take to start up after boot when AutoDelay is set for windowsConfigServiceStartType in Step 3.

  5. Click Save.

  6. Run an incremental or full replication.

    The replication also propagates the modified configuration settings to the target VM.

  7. Run the Test Cutover or Cutover again for affected workloads.

Configure Conflicting Services to Not Run Automatically at Startup

During a Cutover action, a Windows service interferes with the mounting of floppy drivers.

Determine which Windows Services are configured to start up at reboot. Some services are known to interfere with the Configuration Service writing to a floppy, such as Wireless Configuration and some antivirus software. You should configure these services to not run automatically on Test Cutover or Cutover, then run the Test Cutover or Cutover again.

You can also try to disable all non-essential services for Test Cutover and Cutover on the Configuration page, then run the Test Cutover or Cutover again.

I.8.3 Additional Troubleshooting Tips

If the Configuration Service cannot contact the PlateSpin Server, diagnostics will tell only part of the picture. You must also get logs from the target VM:

  • Windows workloads: The Configuration Service logs are found in the C:\windows\platespin\configuration\data folder.

    • The log.txt file contains all of the logging information, but the Config.ini file is useful in understanding what is to be configured.

    • The result.txt file contains the status of the Configuration Service run.

    • If the target VM cannot read from the input floppy device, it will not have the merged Config.ini file, which might include custom network configuration information for the test Cutover network environment.

    • If the Config.ini file has no network related information (such as a [NIC0], the target VM network adapter might have special characters in the name.

      It is a known issue that the Config.ini file might not be accurate until it is merged with the one from the floppy device.

    • The target VM tries a reboot if it cannot connect to either the output floppy or input floppy (one time only). You will see a config.ini.floppyreboot file if this is the case.

  • Linux workloads: The Configuration Service logs are found in the /tmp folder.

    • The main log files are named file*.platespin.fileLogger.

      We recommend examining any configuration folders in /tmp. Tar the configuration folders along with the file*.platespin.fileLogger files to send to Micro Focus Customer Care.

    • Other config files to check for include the following:

      • /tmp/Ofx.RunCommand.Output*
      • /tmp/*DiskHelper*
      • /tmp/*VmTools*
    • The configuration file is /usr/lib/psconfigservice/data/config.conf.

    • The end result log file is /usr/lib/psconfigservice/data/result.txt.