source/ui.rst - cloudstack-docs-admin - Git at Google

 .. Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information#
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at
    http://www.apache.org/licenses/LICENSE-2.0
    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.


 User Interface
 ==============

 Log In to the UI
 ----------------

 CloudStack provides a web-based UI that can be used by both
 administrators and end users. The appropriate version of the UI is
 displayed depending on the credentials used to log in. The UI is
 available in popular browsers including IE7, IE8, IE9, Firefox 3.5+,
 Firefox 4, Safari 4, and Safari 5. The URL is: (substitute your own
 management server IP address)

 .. sourcecode:: bash

    http://<management-server-ip-address>:8080/client

 On a fresh Management Server installation, a guided tour splash screen
 appears. On later visits, you’ll see a login screen where you specify
 the following to proceed to your Dashboard:

 Username -> The user ID of your account. The default username is admin.

 Password -> The password associated with the user ID. The password for
 the default username is password.

 Domain -> If you are a root user, leave this field blank.

 If you are a user in the sub-domains, enter the full path to the domain,
 excluding the root domain.

 For example, suppose multiple levels are created under the root domain,
 such as Comp1/hr. The users in the Comp1 domain should enter Comp1 in
 the Domain field, whereas the users in the Comp1/sales domain should
 enter Comp1/sales.

 For more guidance about the choices that appear when you log in to this
 UI, see Logging In as the Root Administrator.


 End User's UI Overview
 ~~~~~~~~~~~~~~~~~~~~~~

 The CloudStack UI helps users of cloud infrastructure to view and use
 their cloud resources, including virtual machines, templates and ISOs,
 data volumes and snapshots, guest networks, and IP addresses. If the
 user is a member or administrator of one or more CloudStack projects,
 the UI can provide a project-oriented view.


 Root Administrator's UI Overview
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 The CloudStack UI helps the CloudStack administrator provision, view,
 and manage the cloud infrastructure, domains, user accounts, projects,
 and configuration settings. The first time you start the UI after a
 fresh Management Server installation, you can choose to follow a guided
 tour to provision your cloud infrastructure. On subsequent logins, the
 dashboard of the logged-in user appears. The various links in this
 screen and the navigation bar on the left provide access to a variety of
 administrative functions. The root administrator can also use the UI to
 perform all the same tasks that are present in the end-user’s UI.


 Logging In as the Root Administrator
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 After the Management Server software is installed and running, you can
 run the CloudStack user interface. This UI is there to help you
 provision, view, and manage your cloud infrastructure.

 #. Open your favorite Web browser and go to this URL. Substitute the IP
    address of your own Management Server:

    .. sourcecode:: bash

       http://<management-server-ip-address>:8080/client

    After logging into a fresh Management Server installation, a guided
    tour splash screen appears. On later visits, you’ll be taken directly
    into the Dashboard.

 #. If you see the first-time splash screen, choose one of the following.

    -  **Continue with basic setup.** Choose this if you're just trying
       CloudStack, and you want a guided walkthrough of the simplest
       possible configuration so that you can get started right away.
       We'll help you set up a cloud with the following features: a
       single machine that runs CloudStack software and uses NFS to
       provide storage; a single machine running VMs under the XenServer
       or KVM hypervisor; and a shared public network.

       The prompts in this guided tour should give you all the
       information you need, but if you want just a bit more detail, you
       can follow along in the Trial Installation Guide.

    -  **I have used CloudStack before.** Choose this if you have already
       gone through a design phase and planned a more sophisticated
       deployment, or you are ready to start scaling up a trial cloud
       that you set up earlier with the basic setup screens. In the
       Administrator UI, you can start using the more powerful features
       of CloudStack, such as advanced VLAN networking, high
       availability, additional network elements such as load balancers
       and firewalls, and support for multiple hypervisors including
       Citrix XenServer, KVM, and VMware vSphere.

       The root administrator Dashboard appears.

 #. You should set a new root administrator password. If you chose basic
    setup, you’ll be prompted to create a new password right away. If you
    chose experienced user, use the steps in :ref:`changing-root-password`.

 .. warning::
    You are logging in as the root administrator. This account manages the
    CloudStack deployment, including physical infrastructure. The root
    administrator can modify configuration settings to change basic
    functionality, create or delete user accounts, and take many actions
    that should be performed only by an authorized person. Please change
    the default password to a new, unique password.

 .. _changing-root-password:

 Changing the Root Password
 ~~~~~~~~~~~~~~~~~~~~~~~~~~

 During installation and ongoing cloud administration, you will need to
 log in to the UI as the root administrator. The root administrator
 account manages the CloudStack deployment, including physical
 infrastructure. The root administrator can modify configuration settings
 to change basic functionality, create or delete user accounts, and take
 many actions that should be performed only by an authorized person. When
 first installing CloudStack, be sure to change the default password to a
 new, unique value.

 #. Open your favorite Web browser and go to this URL. Substitute the IP
    address of your own Management Server:

    .. sourcecode:: bash

       http://<management-server-ip-address>:8080/client

 #. Log in to the UI using the current root user ID and password. The
    default is admin, password.

 #. Click Accounts.

 #. Click the admin account name.

 #. Click View Users.

 #. Click the admin user name.

 #. Click the Change Password button. |change-password.png|

 #. Type the new password, and click OK.


 .. |change-password.png| image:: _static/images/change-password.png
    :alt: button to change a user's password
	.. Licensed to the Apache Software Foundation (ASF) under one
	or more contributor license agreements. See the NOTICE file
	distributed with this work for additional information#
	regarding copyright ownership. The ASF licenses this file
	to you under the Apache License, Version 2.0 (the
	"License"); you may not use this file except in compliance
	with the License. You may obtain a copy of the License at
	http://www.apache.org/licenses/LICENSE-2.0
	Unless required by applicable law or agreed to in writing,
	software distributed under the License is distributed on an
	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	KIND, either express or implied. See the License for the
	specific language governing permissions and limitations
	under the License.


	User Interface
	==============

	Log In to the UI
	----------------

	CloudStack provides a web-based UI that can be used by both
	administrators and end users. The appropriate version of the UI is
	displayed depending on the credentials used to log in. The UI is
	available in popular browsers including IE7, IE8, IE9, Firefox 3.5+,
	Firefox 4, Safari 4, and Safari 5. The URL is: (substitute your own
	management server IP address)

	.. sourcecode:: bash

	http://<management-server-ip-address>:8080/client

	On a fresh Management Server installation, a guided tour splash screen
	appears. On later visits, you’ll see a login screen where you specify
	the following to proceed to your Dashboard:

	Username -> The user ID of your account. The default username is admin.

	Password -> The password associated with the user ID. The password for
	the default username is password.

	Domain -> If you are a root user, leave this field blank.

	If you are a user in the sub-domains, enter the full path to the domain,
	excluding the root domain.

	For example, suppose multiple levels are created under the root domain,
	such as Comp1/hr. The users in the Comp1 domain should enter Comp1 in
	the Domain field, whereas the users in the Comp1/sales domain should
	enter Comp1/sales.

	For more guidance about the choices that appear when you log in to this
	UI, see Logging In as the Root Administrator.


	End User's UI Overview
	~~~~~~~~~~~~~~~~~~~~~~

	The CloudStack UI helps users of cloud infrastructure to view and use
	their cloud resources, including virtual machines, templates and ISOs,
	data volumes and snapshots, guest networks, and IP addresses. If the
	user is a member or administrator of one or more CloudStack projects,
	the UI can provide a project-oriented view.


	Root Administrator's UI Overview
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	The CloudStack UI helps the CloudStack administrator provision, view,
	and manage the cloud infrastructure, domains, user accounts, projects,
	and configuration settings. The first time you start the UI after a
	fresh Management Server installation, you can choose to follow a guided
	tour to provision your cloud infrastructure. On subsequent logins, the
	dashboard of the logged-in user appears. The various links in this
	screen and the navigation bar on the left provide access to a variety of
	administrative functions. The root administrator can also use the UI to
	perform all the same tasks that are present in the end-user’s UI.


	Logging In as the Root Administrator
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	After the Management Server software is installed and running, you can
	run the CloudStack user interface. This UI is there to help you
	provision, view, and manage your cloud infrastructure.

	#. Open your favorite Web browser and go to this URL. Substitute the IP
	address of your own Management Server:

	.. sourcecode:: bash

	http://<management-server-ip-address>:8080/client

	After logging into a fresh Management Server installation, a guided
	tour splash screen appears. On later visits, you’ll be taken directly
	into the Dashboard.

	#. If you see the first-time splash screen, choose one of the following.

	- Continue with basic setup. Choose this if you're just trying
	CloudStack, and you want a guided walkthrough of the simplest
	possible configuration so that you can get started right away.
	We'll help you set up a cloud with the following features: a
	single machine that runs CloudStack software and uses NFS to
	provide storage; a single machine running VMs under the XenServer
	or KVM hypervisor; and a shared public network.

	The prompts in this guided tour should give you all the
	information you need, but if you want just a bit more detail, you
	can follow along in the Trial Installation Guide.

	- I have used CloudStack before. Choose this if you have already
	gone through a design phase and planned a more sophisticated
	deployment, or you are ready to start scaling up a trial cloud
	that you set up earlier with the basic setup screens. In the
	Administrator UI, you can start using the more powerful features
	of CloudStack, such as advanced VLAN networking, high
	availability, additional network elements such as load balancers
	and firewalls, and support for multiple hypervisors including
	Citrix XenServer, KVM, and VMware vSphere.

	The root administrator Dashboard appears.

	#. You should set a new root administrator password. If you chose basic
	setup, you’ll be prompted to create a new password right away. If you
	chose experienced user, use the steps in :ref:`changing-root-password`.

	.. warning::
	You are logging in as the root administrator. This account manages the
	CloudStack deployment, including physical infrastructure. The root
	administrator can modify configuration settings to change basic
	functionality, create or delete user accounts, and take many actions
	that should be performed only by an authorized person. Please change
	the default password to a new, unique password.

	.. _changing-root-password:

	Changing the Root Password
	~~~~~~~~~~~~~~~~~~~~~~~~~~

	During installation and ongoing cloud administration, you will need to
	log in to the UI as the root administrator. The root administrator
	account manages the CloudStack deployment, including physical
	infrastructure. The root administrator can modify configuration settings
	to change basic functionality, create or delete user accounts, and take
	many actions that should be performed only by an authorized person. When
	first installing CloudStack, be sure to change the default password to a
	new, unique value.

	#. Open your favorite Web browser and go to this URL. Substitute the IP
	address of your own Management Server:

	.. sourcecode:: bash

	http://<management-server-ip-address>:8080/client

	#. Log in to the UI using the current root user ID and password. The
	default is admin, password.

	#. Click Accounts.

	#. Click the admin account name.

	#. Click View Users.

	#. Click the admin user name.

	#. Click the Change Password button. \|change-password.png\|

	#. Type the new password, and click OK.


	.. \|change-password.png\| image:: _static/images/change-password.png
	:alt: button to change a user's password