8ce0d64df3
Some edits as a followup to https://review.openstack.org/#/c/65871 Change-Id: I7a869696b5239f916f3f96677f9cc312778d991f
383 lines
17 KiB
XML
383 lines
17 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE section [
|
|
<!-- Some useful entities borrowed from HTML -->
|
|
<!ENTITY ndash "–">
|
|
<!ENTITY mdash "—">
|
|
<!ENTITY hellip "…">
|
|
]>
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
xmlns:raxm="http://docs.rackspace.com/api/metadata" version="5.0"
|
|
xml:id="log_in_dashboard">
|
|
<?dbhtml stop-chunking?>
|
|
<title>Log in to the dashboard</title>
|
|
<para>The dashboard is available on the node with the
|
|
<literal>nova-dashboard</literal> server role.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Ask the cloud operator for the host name or public
|
|
IP address from which you can access the dashboard,
|
|
and your user name and password.</para>
|
|
</step>
|
|
<step>
|
|
<para>Open a Web browser. Make sure that JavaScript and
|
|
cookies are enabled.</para>
|
|
<note>
|
|
<para>To use the Virtual Network Computing (VNC)
|
|
client for the dashboard, your browser must
|
|
support HTML5 Canvas and HTML5 WebSockets. The VNC
|
|
client is based on noVNC. For details, see <link
|
|
xlink:href="https://github.com/kanaka/noVNC/blob/master/README.md"
|
|
>noVNC: HTML5 VNC Client</link>. For a list of
|
|
supported browsers, see <link
|
|
xlink:href="https://github.com/kanaka/noVNC/wiki/Browser-support"
|
|
xlink:show="embed">Browser
|
|
support</link>.</para>
|
|
</note>
|
|
</step>
|
|
<step>
|
|
<para>In the address bar, type the host name or IP address
|
|
for the dashboard:</para>
|
|
<screen><userinput>https://<replaceable>IP_ADDRESS_OR_HOSTNAME</replaceable>/</userinput></screen>
|
|
<note>
|
|
<title>Certificate warning</title>
|
|
<para>If a certificate warning appears when you try to
|
|
access the URL for the first time, a self-signed
|
|
certificate is in use, which is not considered
|
|
trustworthy by default. Verify the certificate or
|
|
add an exception in the browser to bypass the
|
|
warning.</para>
|
|
</note>
|
|
</step>
|
|
<step>
|
|
<para>On the <guilabel>Log In</guilabel> page, enter your
|
|
user name and password, and click <guibutton>Sign
|
|
In</guibutton>.</para>
|
|
<para>The top-level row shows your user name. You can also
|
|
access <guilabel>Settings</guilabel> or sign out of
|
|
the dashboard.</para>
|
|
<para>The visible tabs and functions in the dashboard
|
|
depend on the access permissions, or <emphasis
|
|
role="italic">roles</emphasis>, of the user you
|
|
are logged in as.</para>
|
|
<para>If you are logged in as an end user, the main screen
|
|
shows the <link linkend="dashboard_project_tab"
|
|
>Project</link> tab.</para>
|
|
<para>If you are logged in as an administrator, the main
|
|
screen shows the <link linkend="dashboard_project_tab"
|
|
>Project</link> tab and <link
|
|
linkend="dashboard_admin_tab">Admin</link>
|
|
tab.</para>
|
|
</step>
|
|
</procedure>
|
|
<section xml:id="dashboard_project_tab">
|
|
<title>OpenStack dashboard—Project tab</title>
|
|
<para>Select a project from the <guilabel>CURRENT
|
|
PROJECT</guilabel> drop-down list on the left side to
|
|
view and manage resources in that project.</para>
|
|
<para>The <guilabel>Project</guilabel> tab displays the
|
|
details of the selected project.</para>
|
|
<figure xml:id="dashboard_project_user">
|
|
<title>Dashboard projects</title>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="figures/dashboard-project-tab.png"
|
|
format="PNG" contentwidth="6in" width="6in"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
</figure>
|
|
<para>Access the following tabs:</para>
|
|
<para><guilabel>Manage Compute</guilabel> tab</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Overview</guilabel></term>
|
|
<listitem>
|
|
<para>View reports for the project.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Instances</guilabel></term>
|
|
<listitem>
|
|
<para>View, launch, create a snapshot from, stop,
|
|
pause, or reboot instances, or connect to them
|
|
through VNC.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Volumes</guilabel></term>
|
|
<listitem>
|
|
<para>View, create, edit, and delete
|
|
volumes.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Images &
|
|
Snapshots</guilabel></term>
|
|
<listitem>
|
|
<para>View images, instance snapshots, and volume
|
|
snapshots created project users, plus any
|
|
images that are publicly available. Create,
|
|
edit, and delete images, and launch instances
|
|
from images and snapshots.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Access &
|
|
Security</guilabel></term>
|
|
<listitem>
|
|
<para>Use the following tabs to complete these
|
|
tasks:</para>
|
|
<formalpara>
|
|
<title><guilabel>Security Groups</guilabel>
|
|
tab</title>
|
|
<para>View, create, edit, and delete security
|
|
groups and security group rules.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>Keypairs</guilabel>
|
|
tab</title>
|
|
<para>View, create, edit, and import keypairs,
|
|
and delete keypairs.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>Floating IPs</guilabel>
|
|
tab</title>
|
|
<para>Allocate an IP address to or release it
|
|
from a project.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>API Access</guilabel>
|
|
tab</title>
|
|
<para>View API endpoints.</para>
|
|
</formalpara>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para><guilabel>Manage Network</guilabel> tab</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Networks</guilabel></term>
|
|
<listitem>
|
|
<para>Create and manage public and private networks.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Routers</guilabel></term>
|
|
<listitem>
|
|
<para>Create and manage subnets.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Network Topology</guilabel></term>
|
|
<listitem>
|
|
<para>View the network topology.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para><guilabel>Object Store</guilabel> tab</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Containers</guilabel></term>
|
|
<listitem>
|
|
<para>Create and manage object storage.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para><guilabel>Orchestration</guilabel> tab</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Stacks</guilabel></term>
|
|
<listitem>
|
|
<para>Use REST API to orchestrate multiple composite cloud
|
|
applications</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
<section xml:id="dashboard_admin_tab">
|
|
<title>OpenStack dashboard—Admin tab</title>
|
|
<para>Enables administrative users to view usage and manage
|
|
instances, volumes, flavors, images, projects, users,
|
|
services, and quotas.</para>
|
|
<figure xml:id="dashboard_admin_project_tab">
|
|
<title>Admin tab</title>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata
|
|
fileref="figures/dashboard-admin-tab.png"
|
|
format="PNG" contentwidth="6in" width="6in"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
</figure>
|
|
<para>Access the following categories to complete these tasks:</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><guilabel>Overview</guilabel></term>
|
|
<listitem>
|
|
<para>View basic reports.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Resource Usage</guilabel></term>
|
|
<listitem>
|
|
<para>Use the following tabs to view the following usages:</para>
|
|
<formalpara>
|
|
<title><guilabel>Global Disk Usage</guilabel>
|
|
tab</title>
|
|
<para>View the global disk usage for all tenants as an
|
|
average over the last 30 days.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>Global Network Traffic Usage</guilabel>
|
|
tab</title>
|
|
<para>View the global network usage for all tenants as
|
|
an average over the last 30 days.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>Global Object Storage Usage</guilabel>
|
|
tab</title>
|
|
<para>View the global object storage usage for all
|
|
tenants as an average over the last 30
|
|
days.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>Global Network Usage</guilabel>
|
|
tab</title>
|
|
<para>View the global network usage for all tenants as
|
|
an average over the last 30 days.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>Stats</guilabel>
|
|
tab</title>
|
|
<para>View the statistics of all resources.</para>
|
|
</formalpara>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Hypervisors</guilabel></term>
|
|
<listitem>
|
|
<para>View the hypervisor summary.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Instances</guilabel></term>
|
|
<listitem>
|
|
<para>View, pause, resume, suspend, migrate, soft
|
|
or hard reboot, and delete running instances
|
|
that belong to users of some, but not all,
|
|
projects. Also, view the log for an instance
|
|
or access an instance through VNC.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Volumes</guilabel></term>
|
|
<listitem>
|
|
<para>View, create, edit, and delete volumes and
|
|
volume types.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Flavors</guilabel></term>
|
|
<listitem>
|
|
<para>View, create, edit, view extra specs for,
|
|
and delete flavors. A flavor is size for an
|
|
instance.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Images</guilabel></term>
|
|
<listitem>
|
|
<para>View, create, edit properties for, and
|
|
delete custom images.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Networks</guilabel></term>
|
|
<listitem>
|
|
<para>View, create, edit properties for, and
|
|
delete networks.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Routers</guilabel></term>
|
|
<listitem>
|
|
<para>View, create, edit properties for, and
|
|
delete routers.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Defaults</guilabel></term>
|
|
<listitem>
|
|
<para>View default quota values. Quotas are
|
|
hard-coded in OpenStack Compute and define
|
|
the maximum allowable size and number of
|
|
resources.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>System Info</guilabel></term>
|
|
<listitem>
|
|
<para>Use the following tabs to view the service info:</para>
|
|
<formalpara>
|
|
<title><guilabel>Services</guilabel> tab</title>
|
|
<para>View a list of the services.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>Compute Services</guilabel> tab</title>
|
|
<para>View a list of all Compute services.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>Availability Zones</guilabel>
|
|
tab</title>
|
|
<para>View the availability zones.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>Host Aggregates</guilabel> tab</title>
|
|
<para>View host aggregates.</para>
|
|
</formalpara>
|
|
<formalpara>
|
|
<title><guilabel>Network Agents</guilabel>
|
|
tab</title>
|
|
<para>View the network agents.</para>
|
|
</formalpara>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Domains</guilabel></term>
|
|
<listitem>
|
|
<para>View domains.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Projects</guilabel></term>
|
|
<listitem>
|
|
<para>View, create, assign users to, remove users
|
|
from, and delete projects.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Users</guilabel></term>
|
|
<listitem>
|
|
<para>View, create, enable, disable, and delete
|
|
users.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Groups</guilabel></term>
|
|
<listitem>
|
|
<para>View, create, enable, disable, and delete
|
|
groups.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><guilabel>Roles</guilabel></term>
|
|
<listitem>
|
|
<para>View, create, enable, disable, and delete
|
|
roles.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
</section>
|