Explanation: The following message is displayed:

Step 2 of 2: Importing Forge Server Contracts

The task failed. "C:\bin\PlateSpin.ForgeUpgrade\11.0.0.5180\PlateSpin.ForgeUpgrade\ForgeUpgrade.zip" Could not be found.

Possible Cause: Exported data is not in the location it should be.

Action: If you are using the /outfolder parameter, make sure that it points to the folder where the backup output is located.

If you are not using the /outfolder parameter, make sure that the backup output is in the same folder as the executable.

Possible Cause: This could be an indication that you are attempting to run the Forge Upgrade utility from a network path. In the ForgeUpgrade.log file, you might see this manifest as:

Type: System.IO.DirectoryNotFoundException

Error Display: You might see the following message:

There are jobs running. Please stop all jobs or wait for them to complete before running the upgrade.

Explanation: The PlateSpin Server is busy with running operations.

Action: Pause all replications and wait for all operations to complete, or abort the running operations.

Explanation: During the validation phase of the Backup or Restore, the authentication is failing although the password you entered is correct.

Possible Cause: This is a symptom of having a firewall on the Forge Server, which is preventing access.

Action: Try one of the following:

Error Display: You might see the following message:

Step 3 of 5: Validating Parameters
The task "Validate user input" failed. Failed to login. Please
check your credentials and try again.

Logs: You might see an exception like this in the stack trace of the main log file:

Message: Multiple connections to a server or shared resource by
the same user, using more than one user name, are not allowed.
Disconnect all previous connections to the server or shared
resource and try again

Other Symptoms: If you run the net use command on the administrative computer, you might see a message formatted like this:

Disconnected        \\<psserver>\d$       Microsoft Windows Network

Where <psserver> represents the value specified for the psserver parameter. For example:

Disconnected        \\10.99.160.72\d$     Microsoft Windows Network

Possible Cause: A net use connection already exists, probably because you attempted to run the utility previously.

Action: Run the net use <connection> command where <connection> contains relevant content. For example:

net use \\10.99.160.72\d$ /d

Error Display: You might see a message like this:

The task "Validate user input" failed. Unable to connect to the
PlateSpin server at '10.99.160.72'.
Verify that the address is correct 

Possible Cause: A domain user is being used to connect to the PlateSpin Server.

Action: Enter the PlateSpin Server credentials of either a non-Domain user or a Domain Administrator.

Error Display: You might see a message like this:

The task "Validate user input" failed. Unable to connect to the
Forge ESX server at '10.99.163.112'.
Please ensure that the address, username, and password are correct
and retry 

Possible Cause: Credentials for forgeuser (or equivalent) are invalid.

Action: Enter the valid ESX Server credentials.

Error Display: You might see the following message:

The task "Validate user input" failed. The user 'administrator'
does not have access to the PlateSpin server at '10.99.160.72'.
Verify that the username and password are correct

Explanation: You entered the wrong password for the administrator.

Action: Enter the correct password.

Error Display: You might see the following message:

The task "Validate user input" failed. An exception occurred while
reading the password file.  Error:  {0}

Explanation: A password file either does not exist or cannot be read.

Action: Check all of the password files.

Error Display: You might see the following message:

The task Back up Forge failover VMs failed. Authentication for
user "root" failed with result: FAILED

Explanation: You entered the wrong password for the superuser or root user.

Action: Enter the correct password for the root user.

Context: The USB drive is relatively new, but was used in previous backup/restore operations.

Possible Cause: USB drive mount status can change to read-only midway through the backup process. This might occur if the USB drive goes bad.

Action: Try the operation again or try a new USB device.

Explanation: Backup fails with an error stating that USB devices not detected. You are prompted to attach the USB devices.

Possible Cause: USB device detection on ESX (in general) is unreliable.

Action: Try these steps:

Explanation: The upgrade utility displays errors that indicate it is not able to import the VMs. For example:

Step 6 of 7: Register VMs on shared storage -
    23 Apr 2014 10:00:14,560 WARN  - Failed to register VM <vm_name>.vmx on NAS datastore <nas_name>|
23 Apr 2014 10:00:14,968 WARN  - Failed to process VM <vm_name>.vmx. Exception: System.ApplicationException: Could not find virtual machine <vm_name>.vmx

Possible Cause: The shared storage was not added prior to the restore.

Action: Follow these steps to import the VMs: