PI99809: ADMIN USER LOCKED OUT WHEN LICENSE SERVER UNREACHABLE, RESULTINGIN ''Invalid username or password.' ERRORS ON LOG IN.

APAR status

• Closed as duplicate of another APAR.

Error description

• Currently, the admin user consumes a license from a configured
  license server. When the license server is unreachable, there is
  no way to get into UrbanCode Velocity. Additionally, the error
  displayed is "invalid user name / password", and it is not
  evident that it is actually an error connecting to the license
  server.
  

Local fix

• The current workaround for this issue is to manually remove the
  license server configuration to allow the admin user to log back
  in when the license server is unreachable. This can be done
  through the UrbanCode Velocity server's GraphQL playground. The
  user will need to acquire their bearerToken from their
  settings.json file (located in the user's home directory under
  .ucv).
  
  They can then navigate to
  <ucv-server>/release-events-api/graphiql and enter in the
  following query:
  mutation {
    setLicenseServerUrl(
      settings: {
        url: ""
      }
    )
  }
  
  And the following HTTP Header (where <bearerToken> is the
  bearerToken they acquired from the settings.json file:
  {
    "Authorization": "Bearer <bearerToken>"
  }
  
  Now they will be able to log into Velocity as the admin user and
  fix their license server configuration.
  

Problem summary

Problem conclusion

Temporary fix

Comments

• This APAR is a duplicate of PI99830
  

APAR Information

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

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

Fix information

Applicable component levels