| .. 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 |