Expediting Your Support Request with Important Information

When you submit a request, a Metacloud Support team member reviews it for information that will help him or her troubleshoot it quickly. Missing, inaccurate, or unclear details make it necessary for the team member to take additional investigative steps or to reach out to you with questions, delaying resolution.

Reducing Follow-up Questions with Details

Make sure to provide your request with as much relevant information as possible, and observe some helpful practices to expedite getting your request resolved:

Provide the names of any affected Metacloud Hypervisors (MHVs).

Provide UUIDs for any affected instances, projects, or images. Provide the actual text version of the UUID, not a screen shot, if possible. The Support team uses the text string in searches and other actions.

Include any error message verbatim.

If the issue occurs when you run an API call, include the syntax of the call and any returned output. TIP: If possible, attach a source code file that illustrates or simulates the issue. This can significantly speed up resolution.

If the issue happened, is happening, or will happen within a specific time frame, provide the start and end times, including the time zone. The Support team member may be able to correlate the time of occurrence with a timestamped event noted in a log.

Note any maintenance routine or other hardware- or network-related activity that occurred before or during the issue.

If you observe the issue in your Dashboard, provide the exact Dashboard URL, and attach a screen capture if possible.

Note if you were previously able to execute the action that is currently failing. Also note any conditions that might previously have been different when the action was successful.

Note any troubleshooting measures that you attempted.

If the issue occurs when you run a Command Line Interface (CLI) command, include the exact syntax you used for the command, with all arguments.

Also for a failed command, rerun the command with the --debug argument, and paste the output in the request. The Support team searches logs for the ID of each request. For example, if the failed command isopenstack image list, run:openstack --debug image list

Providing Useful Details on CLI Issues

If you are reporting problems with using the CLI in general, provide the following information:

Indicate what computer you are using when attempting to execute CLI commands. If it is a physical laptop or workstation, indicate which network it is connected to. If it is a virtual machine (VM), indicate which cluster it is in.

Indicate which client you are using, such as Openstack, nova, or cinder, and include the version.

Indicate which version of Python you are using to execute the client and how you installed it. For example, note if you used Homebrew.

Attach the environment file you downloaded from your Dashboard to provide credentials for your CLI. Make sure to redact your password first if the file includes it.