File restore operations limitations

Consider the following known issues and limitations for file restore operations issued from the IBM Storage Protect file restore interface while troubleshooting.

Platform specific issues

You may also consult the following topics for issues particular to your platform: The following areas address limitations related to generic interface operations.

Object number limitations

A maximum of 2,000 objects can be restored from search results in a single operation. To restore more than 2,000 objects from search results in the file restore user interface, you must run multiple restore operations.

File restore interface cannot mount a renamed virtual machine

In this scenario, a virtual machine is backed up to the IBM Storage Protect for Virtual Environments server by using the full VM incremental-forever backup type. After the backup completes, the virtual machine is renamed in the VMware vCenter Inventory. A subsequent attempt to mount the virtual machine backup displays the following error message in the file restore interface:
The system cannot find a backup to load. Contact your administrator and log out.
.The backup cannot be loaded because the IBM Storage Protect for Virtual Environments server does not contain a backup image of the renamed virtual machine.
To address this error, apply either of the following solutions:
  • Interim solution: in the VMware vCenter Inventory, rename the virtual machine to the name that was used in the original backup. Then log in to the file restore interface to access the backup for a file restore operation.
  • Long-term solution: back up the renamed virtual machine by using the full VM incremental-forever backup type. Then log in to the file restore interface to access the backup for a file restore operation. The original virtual machine and the renamed virtual machine both appear in IBM Storage Protect for Virtual Environments server database and storage pool. To prevent any confusion, the IBM Storage Protect for Virtual Environments administrator must delete the file space for the original virtual machine.

Log in attempt with host name or IP address fails

In this scenario, the correct host name or IP address is entered in the login page of the file restore interface. However, the following error message is displayed:
The host cannot be found. Verify the host name and log in again. If the problem persists, contact your administrator.
This scenario occurs when the data mover system and the VMware vCenter Server use different internet protocols. For example, the data mover uses IPv4 and the vCenter Server uses IPv6. For example, the data mover uses IPv4 and the vCenter Server uses IPv6. To avoid a login failure, complete either of the following tasks:
  • Enter the fully qualified domain name in the login page of the file restore interface. For example: myhost.mycompany.com.
  • If IPv4 is not used in your environment, request the domain administrator to remove any IPv4 entries from the domain DNS server for that host name. If IPv6 is not used in your environment, request the domain administrator to remove any IPv6 entries from the domain DNS server for that host name.

Limitations related to interface operations

In this scenario, the correct host name or IP address is entered in the login page of the file restore interface. However, the following error message is displayed:
The host cannot be found. Verify the host name and log in again. 
If the problem persists, contact your administrator.
"
This scenario occurs when the data mover system and the VMware vCenter Server use different internet protocols. For example, the data mover uses IPv4 and the vCenter Server uses IPv6. To avoid a login failure, complete either of the following tasks:
  • Enter the fully qualified domain name in the login page of the file restore interface. For example: myhost.mycompany.com
  • If IPv4 is not used in the environment, request the domain administrator to remove any IPv4 entries from the domain DNS server for that host name. If IPv6 is not used in the environment, request the domain administrator to remove any IPv6 entries from the domain DNS server for that host name.

Log in can take a long time

Logging in to the file restore interface might take a long time depending on the number of guests that are managed by the VMware vCenter server. For example, it can take three minutes to log on for a vSphere environment with 3,000 guests.

Date stamp, time stamp, and version number do not display in Details or Job History views

During a file restore operation, when a file with the same name exists, the restored file's original modification date and time is appended to the file name. Subsequent restores of the same file contain a version number (_N) after the original modification date and time. For example: t2.2015-03-07-07-28-03_1.txt

In this scenario, during a restore operation of a file with the same name as an existing file, the restore operation either fails or is canceled by the user. When viewing information about the failure or cancellation in the Details or Job History view, the file's date stamp, time stamp, and version number do not display. The original file name displays.

To view the most recently restored version of the file on the guest virtual machine, look for the file with the highest version number.

IBM Storage Protect for Virtual Environments file restore login page requires repeat credentials

This scenario occurs when either the login page is inactive for an extended period of time or the client acceptor service is restarted on the data mover system. After the correct credentials are entered, you are prompted to login again, even though the correct credentials were already entered. To resolve this problem, reenter the correct credentials. The interface then loads the backup selection page.

To avoid this issue, refresh the login page after the client acceptor service is restarted on the data mover or the login page has become inactive.

No subtitles are shown in the file restore product videos

Subtitles (captions) are not available in the file restore product videos at this time. To view the file restore product videos with subtitles, go to the following websites: Click the CC button in the video player to display the subtitles in the videos.

No sound in the file restore product videos on a remote computer

If you view the product videos from the file restore interface on a remote computer that does not have a sound card, you will not hear any sound in the videos. A sound card must be installed and enabled on the remote computer in order for you to hear sound in the product videos.

To view the videos with sound, access the file restore interface from a web browser on a computer that has a sound card installed.