IT42854: GVM2019E WHEN TRYING TO LOGIN TO THE TSMVMWAREUI AND THE VCENTER VERSION IS 8.0

APAR status

• Closed as program error.

Error description

• When trying to login into the IBM Spectrum Protect for Virtual
  Environments Data Protection for VMware GUI (TsmVmwareUI)
  version 8.1.17 and the vCenter is at version 8.* the following
  error is displayed:
  
  GVM2019E An error occurred processing user permissions. Contact
  your system administrator.
  
  
  This is because the TSMRequiredPermissionsList.xml is missing
  the required privileges section for vCenter 8.0 on Linux and the
  file needs to be corrected on Windows.
  
  IBM Spectrum Protect Versions Affected:
  IBM Spectrum Protect for Virtual Environments - Data Protection
  for VMware version 8.1.17 on all Supported Linux and Windows
  Platforms.
  
  Additional Keywords: SPVE, TS011591435, TsmVmwareUI, login,
  GVM2019E, vSphere 8, GUI
  

Local fix

• 1- For Linux Platforms:
  
  a. Edit the TSMRequiredPermissionsList.xml located in "/opt/tiv
  oli/tsm/tdpvmware/common/webserver/usr/servers/veProfile/tsmVmG
  UI"
  b. Add the following entries to the file under the
  <RequiredList> entry:
  
  <vCenter version="VMC_8.0">
         <Datacenter>
             <Privilege>Datastore.AllocateSpace</Privilege>
         </Datacenter>
  </vCenter>
  <vCenter version="8.0">
         <Datacenter>
             <Privilege>Datastore.AllocateSpace</Privilege>
             <Privilege>Datastore.Browse</Privilege>
             <Privilege>Datastore.FileManagement</Privilege>
             <Privilege>Extension.Register</Privilege>
             <Privilege>Extension.Unregister</Privilege>
             <Privilege>Extension.Update</Privilege>
             <Privilege>Global.CancelTask</Privilege>
             <Privilege>Global.Licenses</Privilege>
             <Privilege>Global.LogEvent</Privilege>
             <Privilege>Global.ManageCustomFields</Privilege>
             <Privilege>Global.SetCustomField</Privilege>
             <Privilege>Host.Config.Storage</Privilege>
             <Privilege>Network.Assign</Privilege>
             <Privilege>Resource.AssignVMToPool</Privilege>
             <Privilege>Resource.ColdMigrate</Privilege>
             <Privilege>Resource.HotMigrate</Privilege>
             <Privilege>Task.Create</Privilege>
             <Privilege>Task.Update</Privilege>
             <Privilege>VApp.AssignResourcePool</Privilege>
             <Privilege>VApp.AssignVM</Privilege>
             <Privilege>VApp.Create</Privilege>
  
  <Privilege>VirtualMachine.Config.AddExistingDisk</Privilege>
  
  <Privilege>VirtualMachine.Config.AddNewDisk</Privilege>
  
  <Privilege>VirtualMachine.Config.AddRemoveDevice</Privilege>
  
  <Privilege>VirtualMachine.Config.AdvancedConfig</Privilege>
             <Privilege>VirtualMachine.Config.CPUCount</Privilege>
  
  
  <Privilege>VirtualMachine.Config.ChangeTracking</Privilege>
  
  <Privilege>VirtualMachine.Config.DiskLease</Privilege>
  
  <Privilege>VirtualMachine.Config.EditDevice</Privilege>
  
  <Privilege>VirtualMachine.Config.HostUSBDevice</Privilege>
             <Privilege>VirtualMachine.Config.Memory</Privilege>
  
  <Privilege>VirtualMachine.Config.RawDevice</Privilege>
  
  <Privilege>VirtualMachine.Config.ReloadFromPath</Privilege>
  
  <Privilege>VirtualMachine.Config.RemoveDisk</Privilege>
             <Privilege>VirtualMachine.Config.Rename</Privilege>
  
  <Privilege>VirtualMachine.Config.ResetGuestInfo</Privilege>
             <Privilege>VirtualMachine.Config.Resource</Privilege>
  
             <Privilege>VirtualMachine.Config.Settings</Privilege>
  
  
  <Privilege>VirtualMachine.Config.SwapPlacement</Privilege>
             <Privilege>VirtualMachine.Config.UpgradeVirtualHardw
  are</Privilege>
  
  <Privilege>VirtualMachine.GuestOperations.Execute</Privilege>
  
  <Privilege>VirtualMachine.GuestOperations.Modify</Privilege>
  
  <Privilege>VirtualMachine.GuestOperations.Query</Privilege>
  
  <Privilege>VirtualMachine.Interact.PowerOff</Privilege>
  
  <Privilege>VirtualMachine.Interact.PowerOn</Privilege>
  
  <Privilege>VirtualMachine.Inventory.Create</Privilege>
  
  <Privilege>VirtualMachine.Inventory.Delete</Privilege>
  
  <Privilege>VirtualMachine.Inventory.Register</Privilege>
  
  <Privilege>VirtualMachine.Inventory.Unregister</Privilege>
  
  <Privilege>VirtualMachine.Provisioning.Clone</Privilege>
             <Privilege>VirtualMachine.Provisioning.DiskRandomAcc
  ess</Privilege>
             <Privilege>VirtualMachine.Provisioning.DiskRandomRea
  d</Privilege>
  
  <Privilege>VirtualMachine.Provisioning.GetVmFiles</Privilege>
  
  <Privilege>VirtualMachine.State.CreateSnapshot</Privilege>
  
  <Privilege>VirtualMachine.State.RemoveSnapshot</Privilege>
  
  <Privilege>VirtualMachine.State.RenameSnapshot</Privilege>
  
  <Privilege>VirtualMachine.State.RevertToSnapshot</Privilege>
  
  
         </Datacenter>
  </vCenter>
  
  2- For Windows:
  
  a.	Edit the TSMRequiredPermissionsList.xml located in
  C:\IBM\SpectrumProtect\webserver\usr\servers\veProfile\tsmVmGUI
  b.	Change the 8.* to 8.0 in the following entries
  
                 <vCenter version="VMC_8.*">
                 <vCenter version="8.*>
  
  The entries should be:
                 <vCenter version="VMC_8.0">
                 <vCenter version="8.0">
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect for Virtual Environments Data           *
  * Protection for VMware version 8.1.17 on Linux x86_64 and     *
  * Windows platforms                                            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in Data Protection for VMware level    *
  * 8.1.17.2 and 8.1.19.                                         *
  * Note that this is subject to change at the discretion of     *
  * IBM.                                                         *
  ****************************************************************
  

Problem conclusion

• The error 'GVM2019E An error occurred processing user
  permissions. Contact your system administrator. ' will not
  occur.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  TSM FOR VE DP V

• Fixed component ID

  5725TVEVM

Applicable component levels