Troubleshooting file restore operations

You can retrieve diagnostic information to resolve file restore issues, by running Microsoft Windows PowerShell cmdlet commands.

Before you begin

Ensure that Microsoft Windows PowerShell 3 or later is available on the system where Data Protection for VMware is installed. To view which version of PowerShell is installed, enter the following command in a PowerShell session:

PS C:\> $PSVersionTable.PSVersion

The number that displays in the Major column is the PowerShell version.

About this task

Complete these steps on the system where Data Protection for VMware is installed.

Procedure

Start a Microsoft Windows PowerShell or Microsoft Windows PowerShell ISE session with administrator authority. For example:
Start > All Programs > Accessories > Windows PowerShell.
Right-click Windows PowerShell and select Run as administrator.
Verify that execution policy is set to RemoteSigned by issuing the following command:
```
PS C:\> Get-ExecutionPolicy
```
If another policy is shown, set the execution policy to RemoteSigned by issuing the following command:
```
PS C:\> Set-ExecutionPolicy RemoteSigned
```
This policy allows the vetools.psm1 script to run on the system.
Tip: The Set-ExecutionPolicy command must be issued only once.

Import the Data Protection for VMware PowerShell module to make the cmdlets available:

PS C:\> Import-Module C:\ibm\tivoli\tsm\tdpvmware\webserver\usr\servers\veProfile\tsmVmGUI\vetools.psm1

Display log file information in a PowerShell Viewer by issuing the following command:
```
PS C:\> Show-VeFileRestoreLogEntries
```
You can investigate and share log information in the PowerShell Viewer with any of the following actions:
- Enter a term to filter the results.
- Click Add criteria to filter the information by more detailed specifications.
- Click one or more rows to save or copy their content for sharing.
Optional: Display trace information from a trace file by issuing the following command:
```
PS C:\> Show-VeFileRestoreTraceEntries
```
Optional: If you need to gather logs to review detailed diagnostic information (-review) or to send to IBM Support, save the logs in a compressed file by issuing the following command:
```
PS C:\> Get-VeProblemDeterminationInfo -review
```
By default, this command saves the VeProblemDetermination.zip file on the desktop.
Tip: If this command returns an error in the default "PowerShell" interface, start the "PowerShell ISE" interface as an administrator. Then, run the command again.
Optional: Each cmdlet provides parameters. To view parameters, issue the following help command:
```
help cmdlet name -ShowWindow
```