1.5
Table Of Contents
- vCloud Director Installation and Configuration Guide
- Contents
- VMware vCloud Director Installation and Configuration Guide
- Overview of vCloud Director Installation and Configuration
- vCloud Director Architecture
- Configuration Planning
- vCloud Director Hardware and Software Requirements
- Creating a vCloud Director Server Group
- Upgrading vCloud Director
- vCloud Director Setup
- Index
Prerequisites
n
Before you can run the tool on a vCloud Director 1.0 or 1.0.1 server, you must download the tool and
install it. See http://kb.vmware.com/kb/1033575.
n
Verify that you have superuser credentials for the target server.
n
Verify that you have vCloud Director system administrator credentials.
Procedure
1 Log in to the target server as root.
2 Use the cell management tool to gracefully shut down the cell.
a Retrieve the current job status.
The following cell-management-tool command line supplies system administrator credentials and
returns the count of running jobs.
[root@cell1 /opt/vmware/vcloud-
director/bin]# ./cell-management-tool -u administrator -p Pa55w0rd cell --status
Job count = 3
Is Active = true
b Stop the task scheduler to quiesce the cell.
Use a cell-management-tool command of the following form.
[root@cell1 /opt/vmware/vcloud-
director/bin]# ./cell-management-tool -u administrator -p Pa55w0rd cell --quiesce true
This command prevents new jobs from being started. Existing jobs continue to run until they complete
or are cancelled. To cancel a job, use the vCloud Director Web Console or the REST API.
c When the Job count is 0 and Is Active is false, it is safe to shut down the cell.
Use a cell-management-tool command of the following form.
[root@cell1 /opt/vmware/vcloud-
director/bin]# ./cell-management-tool -u administrator -p Pa55w0rd cell --shutdown
What to do next
After the cell management tool stops vCloud Director services on this server, you can upgrade the server's
vCloud Director software.
Cell Management Tool Reference
You can use the cell management tool to suspend the task scheduler so that new tasks cannot be started, to
check the status of active tasks, and to shut down the cell gracefully.
The cell management tool is installed in /opt/vmware/vcloud-director/bin/cell-management-tool. It is the
recommended way to stop services on a cell.
Logging In and Getting Help
The cell management tool requires you to log in with the credentials of the vCloud Director system
administrator. After you log in to the tool, you can use its subcommands to manage the cell.
Chapter 3 Upgrading vCloud Director
VMware, Inc. 37