Dell Cloud Solution for Web Applications User Guide
Notes NOTE: A NOTE indicates important information that helps you make better use of your computer. ___________ Information in this document is subject to change without notice. © 2010 Dell Inc. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden. Trademarks used in this text: Dell™, the DELL, PowerEdge™ and PowerConnect™ are trademarks of Dell Inc.
Contents INTRODUCTION ..................................................................................... 5 Cloud Definition ................................................................................................ 5 Joyent SmartMachine ....................................................................................... 5 Cloud Management ........................................................................................... 6 Solution Components .............................................
Locations .................................................................................................................... 32 Rackables .................................................................................................................. 46 Network ...................................................................................................................... 78 OpenSolaris................................................................................................................
1 Introduction The Dell Cloud Solution for Web Applications (DCSWA) is an optimized private cloud solution for running virtualized web applications, databases, and other compute nodes efficiently. The solution includes hardware, software, and services and is highly scalable from the lab to massive data centers. The solution is offered as a turnkey package containing software, hardware, and core services (i.e., installation and support).
Cloud Management The cloud is managed, maintained, secured, and backed up through software components. The management components provide reporting, monitoring, operating, and diagnostic functions at both the cloud administrator and cloud user levels. The solution defines a maintenance and backup/disaster recovery methodology for both the SmartMachines and the infrastructure components. Wrapped around all of these features are security features and methodologies that allow for secure multi-tenant operations.
Hardware Components The hardware components include: • Administration/Provisioning Server • Compute Nodes • Network Infrastructure. Administration/Provisioning Server The administration/provisioning server provides the multiple cloud control, user portal, and provisioning functions for the solution. Compute Nodes The compute nodes are a collection of client services that run on each physical server except the infrastructure server.
Figure 2. Software Components Cloud Control In DCSWA, the administration portal is referred to as Cloud Control. Cloud Control manages cloud operations, including locations (datacenters), pods, racks, rack-mountable devices (load balancers, servers, console servers, storage devices, switches, appliances and routers), the network (IPs, subnets, and virtual IPs), SmartMachines (zones), and customers. Cloud Control also includes reporting for various objects in the cloud infrastructure.
Figure 3. Cloud Control Cloud Management API This programmatic interface enables system integrators to access Cloud Control’s functionality via a RESTful API. Figure 4.
User Portal With the self-service user portal, you can perform certain tasks: • Create SmartMachines (up to your quota). • Reboot a SmartMachine. • Shutdown a SmartMachine. • Delete a SmartMachine. NOTE: Capacity can be added to an existing SmartMachine by an administrator using Cloud Control, provided that there is available quota. Figure 5.
Telemeter The telemeter measures consumption. All telemeter information is provided in graphical form for each zone in Cloud Control. Figure 6. Sample Telemeter Graphs Measuring Consumption Measuring consumption is important in both private and public clouds. In private clouds, consumption measurement supports departmental charge-backs. In public clouds, consumption measurement supports both the pay in advance (subscriptions) and pay afterwards (invoicing) models.
Cloud Provisioning Clouds must be created. This process, called cloud provisioning, requires several steps. 1 Install the software. 2 Provision the network. 3 Execute the JumpStart. 4 Configure the head node. 5 Set up the global zone. 6 Set up compute node(s). Cloud Control uses the Ubuntu Linux operating system because it is fast and secure. Ubuntu is integrated into the software and is installed automatically.
2 SmartMachines Accessing a New SmartMachine When you provision a SmartMachine, Cloud Control creates several accounts your client can use to access it. The client can choose to receive this login information in a welcome email or access it through the user portal. Both the user portal and Cloud Control display the username, but not the password. If the client changes the passwords, the passwords displayed in the user portal or in Cloud Control will no longer be valid. Figure 7.
Figure 8. Credentials Display in Cloud Control System/Username Descriptions System Username Description root Root The system root user. You cannot log in as root through SSH. Instead, access the SmartMachine through another account, and use su to log in as root: shell admin The system administrator. Use this account to access the SmartMachine through SSH: ssh admin@ mysql root The root MySQL user. This is not the same as the system root user.
Starting and Stopping SmartMachines Use the user portal to start or stop SmartMachines. The Reboot button reboots a SmartMachine. The Shutdown button shuts down the machine. This button displays as the Startup button when shutdown is successful. Figure 9. Available Actions Running Services SmartMachines use Solaris Service Management Facility (SMF) to run services such as the Apache web server and the MySQL server.
Managing Users Every SmartMachine user needs a unique name and must belong to at least one group. To use the sudo command, the user must be a member of the staff group. To manage users and groups, log into your SmartMachine as admin or use su to become the root user. If you log in as admin, run the commands described in this section with sudo. Creating Groups Solaris users are always members of one or more groups. Create groups so that a set of users can share the same permissions across different files.
3 Cloud Control Cloud Control manages all resources relating to a cloud. These include: • Data centers (locations) • Pods (sets of racks) • Racks • Rack-mountable devices (load balancers, servers, console servers, storage devices, switches, appliances and routers) • Network (IPs, subnets, and virtual IPs) • SmartMachines (ZFS datasets and zone configurations) • Customers (users).
Feature Description RESTful API Joyent Cloud Control includes a RESTful private API that connects private clouds with third party services. The private API provides access to the following: Customers: Company or department and their associated zones. Containers: Zones Templates: Predefined templates used to create a new container. Servers: Physical servers where the containers are created. All API calls must use HTTP basic authentication over SSL.
Field Description Format Password The login password associated with the username. Text Minimum length=6 characters NOTE: The administrator username is admin, and the default password is joyadmin. The ports are assigned as follows: Port 8080 = Cloud Control Port 8081 = Cloud Control API Port 8082 = Customer's API Port 8083 = User Portal. Side Menu Use the Side Menu to access the different elements of Cloud Control. Menu options are discussed in the following pages.
Customers The Listing Customers page provides a list of all customers. NOTE: Customers will likely have multiple entries — one for each department within their company. Using a common company name enables Cloud Control to logically group information on reports. Buttons Button Action Search Enter a customer or company name in the field and click to display a subset of names matching the search string. New Customer Open the New Customer page.
Field Description Action Link Delivers Edit customer data Customer details page in edit mode Delete the customer Delete confirmation dialogue box Cloud Control | 21
CustomersNew Customer Use the New Customer page to create customers. Bold field labels indicate required input. NOTE: You cannot create a customer with the same e-mail address or username as an existing or deleted customer. Fields Field Description Format First Name Customer’s first name Text Last Name Customer’s last name Text Email Address Customer’s email address Text Alt.
Field Description Format Automatic Provisioning Enables automatic provisioning of the new customer Checkbox (recommended) RAM Quota in MB Quota of RAM allocated for all of a customer’s provisioned SmartMachines Number The customer can portion the quota as needed, e.g., a 512MB quota can be allocated to one 512MB SmartMachine or two 256MB SmartMachines. A quota of zero indicates unlimited quota. Quotas apply only to zones created through the User Portal.
Field Description Format Password Customer’s password Text Minimum length is 6 characters. Password Confirmation Customer’s password confirmation Text Minimum length is 6 characters, and must match the Password field entry. Role Customer’s role on the system Drop-down list Only Admin account can configure. NOTE: When a customer is successfully created, a green box displays at the top of the page. When there is a problem with customer data, a red box displays at the top of the page.
CustomersNew Customer: Cloud Control Record After a customer is successfully created, the Customer page displays. Buttons Button Action Search Enter a customer or company name in the field and click to display a subset of names matching the search string. Active Zones as CSV Download a comma-separated value file of all active zones for the customer. Extended Active Zones as CSV Download a comma-separated value file of all extended active zones for the customer.
Button Action Cancel Cancel the changes to the customer record. CustomersNew CustomerZone Information The Zone Information section of the New Customer page provides detailed zone information. Columns Column Description Link Delivers Name Zone name Zone details page IP Zone IP address NA Customer Customer name Customer details page. Configuration Template associated with the zone NA Status Zone status (deactivated, assigned, etc.
Column Description Link Delivers Comments Comments relating to the zone NA Action Edit zone information Zone details page in edit mode Confirmation message Send Welcome email to zone owner Delete zone Removes zone from display without prompting for confirmation Buttons Button Action Assign Zone Remove the zone from the current customer and transfer it to the customer listed in the Assign Zone by Name box.
Column Description Link Delivers Period Usage time period NA Average Active Zones Average number of active zones during the time period NA Average Inactive Zones Average number of inactive zones during the time period NA Average Active RAM in MB Average amount of active RAM (in MB) during the time period NA Average Inactive RAM in MB Average amount of inactive RAM (in MB) during the time period NA CustomersNew Customer: Virtual IP’s Columns Column Description Link Delivers Public IP
Button Action Create Create a virtual IP with the address entered in the Public IP address field.
CustomersSold Click Sold in the side menu to display the Sales Report for All Customers page. Buttons Button Action Search Enter a customer or company name in the field and click to display a subset of names matching the search string.
CustomersCompany Click Company in the side menu to display the Report by Company page. Buttons Button Action Search Enter a customer or company name in the field and click to display a subset of names matching the search string. Show RAM Greater Than Select one of the RAM options from this drop-down list to limit the resulting display to those customers meeting the criteria.
CustomersSign Out Click Sign Out in the side menu to log out of Cloud Control and display the Login page. Locations The Locations section contains the details relating to all data centers, pods, and racks in the cloud. Data Centers Click Data Centers in the side menu to display the Listing Data Centers page. Buttons Button Action Search Enter data center information in the field and click to display a subset of data centers matching the search string.
Columns Column Description Link Delivers Company Name Name of the company responsible for the data center Data center details page City City where the data center is located NA State State where the data center is located NA Phone Number Contact phone number for the company responsible for the data center NA Contact Person Contact person for the company responsible for the data center NA Actions Edit data center information. Delete the data center.
Fields Field Description Format Company Name Name of the company responsible for the data center Text City City where the data center is located Text State State where the data center is located Text Phone Number Contact phone number for the company responsible for the data center Text Contact Person Contact person for the company responsible for the data center Text NOTE: When a data center is successfully created, a green box displays at the top of the page.
Button Action Create Create a data center. Cancel Cancel the creation of a data center.
Data CentersSold The Sales Report for Data Centers lists all of the data centers within the cloud. Any servers requiring rack assignment are listed first. Buttons Button Action Search Enter data center information in the field and click to display a subset of data centers matching the search string. Columns Column Description Link Delivers Hostname (#) Server name Hostname details page. IP Server IP address IP details page.
Column Description Link Delivers Setup? True = Server is set up. False = Server is not set up. NA API? True = API is available for use on the server. False = API is not available for use on the server. NA Active Zones Number of active SmartMachines on the server NA NOTE: Totals are provided for each data center. A grand total is provided for all data centers displayed. If the display is delimited by a search, the grand total will reflect only those data centers meeting the search criteria.
Columns Column Description Link Delivers Name Pod name Pod details page. Location Pod location in the data center (e.g., Row 4, Aisle 3) NA Pod details page in edit mode. Actions Edit pod information. Delete the pod. Delete confirmation dialog box. PodsNew Pod Click the New Pod button to display the New Pod entry page. Fields Field Description Format Name Pod name Text Location Physical location of the pod Text (e.g.
Field Description Format Pkgsrc URL URL for an alternate pkgsrc. Overrides the default pkgsrc. If an alternate pkgsrc is used, an alternate nameserver must also be specified. URL or IP address Nameservers Alternate nameserver. Overrides the default DNS nameserver. If an alternate nameserver is used, an alternate pkgsrc must also be specified. URL or IP address Buttons Button Action Create Create a new pod using the information entered on the New Pod page.
Button Action Search Enter pod information in the field and click to display a subset of pods matching the search string. Edit Display the details page in edit mode. PodsPod DetailsRacks The Racks table within the Pod details page lists all racks associated with the pod.
Column Description Link Delivers Total Disk Total disk space in the pod.
PodsEditing Pod Click the Edit button to display the Editing Pod page. Bold field labels indicate required input. Buttons Button Action Search Enter pod information in the field and click to display a subset of pods matching the search string. Update Commit the changes entered in the fields on the Editing Pod page. Cancel Cancel the changes entered in the fields on the Editing Pod page and return to the Pod details page.
Fields Field Description Format Name Pod name Text Location Pod physical location Text (e.g., Row 3, Aisle 2) Data Center Name of the data center where the pod is located Text Pkgsrc URL for an alternate pkgsrc. Overrides the default pkgsrc. If an alternate pkgsrc is used, an alternate nameserver must also be specified. URL or IP address Nameservers Alternate nameserver. Overrides the default DNS nameserver. If an alternate nameserver is used, an alternate pkgsrc must also be specified.
Columns Column Description Link Delivers Name Rack name Rack details page Size Number of units (slots) in the rack NA Pod Name of the pod where the rack is physically located NA Available Number of open units in the rack. “Empty” indicates that there are no rackable devices in the rack. NA Rack details page in edit mode Actions Edit rack information. Delete the rack.
Fields Field Description Format Name Rack name Text Size in Rack Units Number of units in the rack Integer Pod Pod where the rack is physically located Drop-down list Buttons Button Action Create Commit the data and create a new rack. Cancel Cancel the creation of the new rack. RacksRack Details The Rack details page displays information specific to a given rack.
Buttons Button Action Search Enter rack information in the field and click to display a subset of racks matching the search string. Edit Display the Edit Rack page. The Rack details page includes an image representing the actual size of the rack. If components are contained within the rack and entered into the Cloud Control database, the image is modified to represent the amount of physical space occupied by the components and the amount of available space remaining in the rack.
Buttons Button Action Search Enter console server information in the field and click to display a subset of console servers matching the search string. New Console Server Display the New Console Server page. Columns Column Description Link Delivers Name Console server name Console server details page Public IP Console server public IP address NA Rack Position Console server position in the rack (e.g.
Console ServersNew Console Server Click the New Console Server button to display the New Console Server page. Buttons Button Action Search Enter console server information in the field and click to display a subset of console servers matching the search string. Create Create the new console server using the information on the New Console Server page. Cancel Cancel the creation of the console server.
Field Description Format Rack Rack where the console server is physically located Drop-down list Rack Position Position in the rack where the console server is located. Number Rack Height Number of rack units the console server occupies. Drop-down list Servers Click Servers in the side menu to display the Listing Servers All page. ServersListing Servers All The Listing Servers All page provides details about each of the servers in the cloud.
Columns Column Description Link Delivers Hostname Server hostname Hostname details page Rack/Pod/Data Center Rack, pod and data center where the server is located Rack details page Public IP Server public IP NA Sold Percentage of the server that has been sold. NA Server Role Server role. Server role details page Reserved? True = Server is reserved. False = Server is not reserved. NA Setup? True = Server is set up False = Server is not set up. NA Action Edit server information.
ServersHostname Details Click the hostname to display the Hostname details page. Buttons Button Action Search Enter server information in the field and click to display a subset of servers matching the search string. Mark as Setup After the server is physically set up, click to mark the server as ready for use and change the date stamp for the Setup At field. Note that the server must be assigned to a pod and a rack before it can be marked as set up.
Button Action Send Welcome Email to All Zones Click to send a Welcome email to all zones on the server. Release Server Reserved Zones Click to release all reserved zones on the server. When the dialog box displays, click OK to confirm the action. Download Zones as CSV Click to initiate a file download containing a list of all zones on the server in comma-separated value (CSV) format. Telemeter Click to display telemeter data for the server (a username and password are required).
Figure 10. Sample Telemeter Data Display Figure 11.
Field Description Format Interface for Internal Network Physical interface for internal network Text Reserved If server is reserved True = Reserved False = Not reserved API Provisionable If server is set up for access using the API True = API False = No API Crossbow Enabled If server is enabled for Crossbow (network virtualization and resource control) True = Crossbow enabled False = Crossbow not enabled Admin IP SSH Access Preferred Admin access IP True = Allowed Server Role Server role
Field Description Format Full If the server is full True = Server is full False = Server is not full Rack Rack where the server physically resides Text from rack list Rack Position Position of the server within the rack Integer Rack Height Number of rack units the server occupies Integer SSH Access If the server supports or requires SSH access True = SSH Access False = No SSH Access Operating System Server OS Text Comments Special notes about the server Text ServersHostname Details
Columns Column Description Link Delivers IP Address Server IP address IP address details page Addressable IP of corresponding server Hostname details page Pingable? Pingable = Server is pingable Not Pingable! = Server is not pingable NA Reserved? Reserved = Server is reserved Not Reserved = Server is not reserved NA Comments Special notes about the server NA Role Server role NA Actions Edit server information Delete the server Cloud Control | 56 Server details page in edit mode De
ServersHostname DetailsZones This section of the Hostname page displays information about zones related to the server.
Column Description Link Delivers Zones details page Send Welcome email to the zone owner Cloud Control | 58
ServersHostname DetailsDeactivated/Destroyed Zones This section of the Hostname page displays deactivated or destroyed zones. Note: The columns in this section are the same as those for active zones. ServersHostname DetailsJobs This section of the Hostname page lists jobs associated with the server.
Column Description Link Delivers Actions Delete jobs that are checked from the queue Delete confirmation dialog box ServersHostname DetailsZFS Storage Pools This section of the Hostname details page concerns ZFS storage pools.
Fields Field Description Format Assign Console Server Console server assigned to the pool Drop-down list IP KVM URL IP KVM address associated with the pool URL Device Port Device port associated with the IP KVM address Port Number Buttons Button Action Assign Assign the values from the three fields to the ZFS storage pool.
ServersRequiring Setup Click Requiring Setup in the side menu to display a list of servers that require setup. Buttons Button Action Search Enter server information in the field and click to display a subset of servers matching the search string. New Server Create a new server using the information on the New Server page. Download as CSV Initiate a download of a comma-separated value file containing information about the servers displayed.
Column Description Link Delivers Reserved? True = Server is reserved. False = Server is not reserved. NA Setup? True = Server is set up. False = Server is not set up. NA Action Edit server information Delete the server Server details page in edit mode Delete confirmation dialog box ServersSold The Utilization Report for All Servers displays usage data for each server and provides a grand total for all servers in the list.
Columns Column Description Link Delivers Hostname Server hostname Hostname details page IP Server IP address IP details page Sold Percentage of the server that has been sold NA Available RAM Amount of RAM available on the server NA Sold RAM Amount of RAM that has been sold NA Active RAM Amount of active RAM NA Target RAM Maximum sellable RAM NA Operating System Server OS NA Setup? True = Server is set up False = Server is not set up NA API? True = API is available for use on t
ServersAudit IPs Click Audit IPs in the side menu to display the Servers Missing IP(s) page. Buttons Button Action Search Enter server information in the field and click to display a subset of servers matching the search string. Download as CSV Initiate a download of a comma-separated value file containing information about the servers displayed. Filter by Server Role Filter the display by the server role selected.
Column Description Link Delivers Setup? True = Server is set up False = Server is not set up NA Action Edit server information. Delete the server. Server details page in edit mode Delete confirmation dialog box Server Roles Server roles define and restrict which templates can be used for a compute node. For example, Pro is the server role used by Joyent to provision all SmartMachines. Some customers choose to use custom roles.
Column Description Link Delivers Supported Zone Configurations Name of the template associated with the server role NA Actions Edit server role information Delete the server role Server role details page in edit mode Delete confirmation dialog box Server RolesNew Server Role Buttons Button Action Search Enter server role information in the field and click to display a subset of server roles matching the search string. Create Create a new server role using the data on the input form.
Server RolesServer Role Detail Click the name of the server role to display a details page. Buttons Button Action Search Enter server role information in the field and click to display a subset of server roles matching the search string. Make Un-provisionable Server role will become un-provisionable and any existing provision jobs will not be handled automatically for zones of this type. Disallow Non-provision Jobs Server role will not process any non-provision jobs.
Field Description Format Allow Non-Provision Jobs? Allow provision jobs True = Allow non-provision jobs False = Do not allow non-provision jobs Cloud Control | 69
Server RolesServer Role Detail Supported Zone Configurations Columns Column Description Link Delivers Name Supported zone configuration name NA RAM in MB Amount of RAM in the zone configuration NA Load Balancing Available? Yes = Load balancing is available in the zone configuration No = Load balancing is not available in the zone configuration NA Action Delete the zone configuration Delete confirmation dialog box Buttons Button Action Zone Configuration Identify the zone configuration.
Server RolesServer Role DetailPro Servers This part of the details page lists the servers using the specified server role.
Buttons Button Action Search Enter switch information in the field and click to display a subset of switches matching the search string. New Switch Display the New Switch page.
SwitchesNew Switch Click the New Switch button to display the New Switch page. Buttons Button Action Search Enter switch information in the field and click to display a subset of switches matching the search string. Create Create a new switch based on the data on the New Switch page. Cancel Cancel the creation of the new switch.
Fields Field Description Format Name Switch name Text Manufacturer Switch manufacturer Text Model Switch model number Text Vendor Number Manufacturer vendor number Text Comments Notes relating to the switch Text Rack Name of the rack where the switch resides Drop-down list Rack Position Position of the switch in the rack Integer Rack Height Number of rack units the switch occupies Drop-down list Appliances Click Appliances in the side menu to display the Listing Appliances page.
Columns Column Description Link Delivers Name Appliance name Appliance details page Type Appliance type NA Public IP Appliance public IP address NA Rack Position Position of the appliance in the rack NA Rack Height Number of rack units the appliance occupies NA Comments Notes relating to the appliance NA Actions Edit appliance information Delete the appliance Appliance details page in edit mode Delete confirmation dialog box AppliancesNew Appliance Use the New Appliance page to cre
Fields Field Description Format Name Appliance name Text Appliance Type Appliance type Drop-down list Manufacturer Appliance manufacturer Text Model Appliance model number Text Vendor Number Manufacturer vendor number Text Comments Notes relating to the specific appliance Text Rack Name of the rack where the appliance is physically located Drop-down list Rack Position Position of the appliance in the rack Integer Rack Height Number of rack units the appliance occupies Drop-down
Button Action Search Enter appliance information in the field and click to display a subset of appliances matching the search string. Create Create a new appliance based on the data on the New Appliance page. Cancel Cancel the creation of the new appliance.
Network The Network functions involve IPs, routers and subnets. IPs Internet protocol addresses (IPs or IP addresses) are numerical labels assigned to devices participating in a network. Multiple IP addresses make up the subnet. Click IPs in the side menu to display the Listing IPs page. Buttons Button Action Search Enter IP information in the field and click to display a subset of IPs matching the search string. Next Page Display next page of IP addresses.
Column Description Link Delivers Pingable? Pingable = Server is pingable Not Pingable! = Server is not pingable NA Reserved? Reserved = Server is reserved Not Reserved = Server is not reserved NA Comments Notes about the server NA Role Server role NA Actions Edit server information Server details page in edit mode IPsIP Detail Click an IP address to display the IP details page.
Buttons Button Action Search Enter IP information in the field and click to display a subset of IPs matching the search string. Edit Display the IP details page in edit mode. Fields Field Description Format Reserved If the IP is reserved True = IP is reserved False = IP is not reserved Addressable If the IP has been assigned to a device Link to corresponding node. Subnet Range of IP addresses to which the IP belongs IP address range. E.g., 192.168.1.0 – 192.168.1.
IPsEditing IP Click the Edit button to display the Editing IP page. Buttons Button Action Search Enter IP information in the field and click to display a subset of IPs matching the search string. Update Commit the changes entered in the fields on the Editing IP page. Cancel Cancel the changes entered in the fields on the Editing IP page and return to the IP page.
Routers The routers area of Cloud Control is used to define which switches act as routers for a given subnet. Click Routers in the side menu to display the Listing Routers page. Buttons Button Action Search Enter router information in the field and click to display a subset of routers matching the search string. New Router Display the New Router page.
RoutersNew Router Click the New Router button to display the New Router page. Bold field labels indicate required input. Buttons Button Action Search Enter router information in the field and click to display a subset of routers matching the search string. Create Create the router record. Cancel Cancel the creation of the router record.
NOTES: When a router is successfully created, a green box is displayed at the top of the page. When there is a problem with a piece of router data, a red box is displayed at the top of the page. Routers Router Detail Click the router name to display the Router details page. Buttons Button Action Search Enter router information in the field and click to display a subset of routers matching the search string. Edit Display the Router details page in edit mode.
Field Description Format Number of Subnets Number of subnets associated with the router Integer Routers Router DetailSubnets The Subnets section of the Router detail page lists subnets associated with the router. Columns Column Description Link Delivers Start IP address that starts the subnet Subnet details page End IP address that ends the subnet NA Description Subnet description NA Actions Edit subnet information Delete the subnet Subnet details page in edit mode.
Routers Router DetailIPs Click the router name to display the IPs detail page. Columns Column Description Link Delivers IP Address IP address associated with the router IP details page Addressable Router name Displays the top of the router details page Pingable? Pingable = Server is pingable. Not Pingable! = Server is not pingable. NA Reserved? Reserved = Server is reserved. Not Reserved = Server is not reserved.
Subnets Subnets define the IP ranges assigned to public, private, and admin servers. NOTE: Typically, admin servers are used for Intelligent Platform Management Interface (IPMI), which monitors system health as well as manages the system. Admin servers are also used for jumpstarting (i.e., PXE booting). Click Subnets in the side menu to display the Listing Subnets page.
Column Description Link Delivers Sold Percentage of the subnet that has been sold NA Mask Subnet mask NA Router Router associated with the subnet NA Role Subnet role NA Description Subnet description NA Edit subnet information. Subnet details page in edit mode Delete the subnet. Delete confirmation dialog box Actions SubnetsNew Subnet Buttons Button Action Search Enter subnet information in the field and click to display a subset of subnets matching the search string.
Fields Field Description Format Subnet Address Subnet address x.y.z.0 Subnet Mask Subnet mask Drop-down list Default Gateway Address Address used when an IP address does not match any entries in the routing table IP address format Router Router used by the subnet Text Role Subnet role Drop-down list Description Subnet description Text SubnetsSold Buttons Button Action Search Enter subnet information in the field and click to display a subset of subnets matching the search string.
Column Description Link Delivers Total IPs IP addresses in subnet mask NA Sold/Ping Number of IP addresses used NA Unsold/No-ping Number of IP addresses not used or un-pingable NA Free Number of available IP addresses NA Total Memory Total memory available from provisioned systems NA Total Sold Total memory sold NA Total Unsold Total memory available NA Num Servers Number of provisioned servers NA Description Description of network/IPs NA SubnetsBy Server Click By Server under
Button Action Show Subnets in Pod Filters by a given pod. Columns Column Description Link Delivers Hostname Node hostname NA Operating System Node OS NA Pubic IP Node public IP NA Sold Memory sold on node NA Role Category of approved SmartMachine NA Reserved? Currently being used NA Setup? Provisioned and available for use NA OpenSolaris OpenSolaris is the operating system used by Cloud Control.
ZFS Datasets ZFS Datasets are the underlying templates used to create SmartMachines or zones. Three templates are included in Cloud Control: • Pro Template (protemplate-2.3.2zfs.gz) • MySQL (mysql-1.0.2.zfs.gz) • Zeus Load Balancer (zxtm-6.0.4.zfs.gz) Click ZFS Datasets in the side menu to display the Listing ZFS Datasets page. Buttons Button Action Search Enter ZFS dataset information in the field and click to display a subset of ZFS datasets matching the search string.
ZFS DatasetsNew ZFS Dataset Use the New ZFS Dataset page to create new ZFS datasets. Buttons Button Action Search Enter ZFS dataset information in the field and click to display a subset of ZFS datasets matching the search string. Create Create the ZFS dataset record. Cancel Cancel the creation of the ZFS dataset record.
ZFS Datasets ZFS Dataset Details Click the name link to display the dataset details page. Buttons Button Action Search Enter ZFS dataset information in the field and click to display a subset of ZFS datasets matching the search string. Edit Displays the detail page in edit mode. ZFS Datasets ZFS Dataset DetailZones The Zones section of the detail page lists those SmartMachines (zones) built using the ZFS dataset.
Column Description Link Delivers Size Zone size NA Server Server name Server details page Comments Notes relating to the zone NA Action Edit zone information. Zones details page in edit mode Zones details page Action Send Welcome email to the zone owner. ZFS DatasetsZFS Dataset DetailEditing ZFS Dataset Buttons Button Action Search Enter ZFS dataset information in the field and click to display a subset of ZFS datasets matching the search string.
Zone Configurations Click Zone Configuration in the side menu to display the Listing Zone Configurations page. Buttons Button Action Search Enter zone configuration information in the field and click to display a subset of configurations matching the search string. New Zone Configuration Display the New Zone Configuration page. Columns Column Description Link Delivers Name Zone configuration name.
Column Description Delete the zone configuration.
Zone ConfigurationsNew Zone Configuration Use the New Zone Configuration page to create new configurations. Button Button Action Search Enter zone configuration information in the field and click to display a subset of zone configurations matching the search string. Create Create the zone configuration record. Cancel Cancel the creation of the zone configuration record.
Field Description Format RAM in MB Amount of RAM in MB used in the zone configuration Integer CPU Shares Number of CPU shares in the zone configuration Integer CPU Cap Maximum percentage of a single CPU core the zone can use More than 100% — Zone utilizes multiple CPU cores. None specified — Server default is used. Percentage Swap in MB Amount of swap space in MB used by the zone configuration Integer Max.
Zone ConfigurationsZone Configuration Detail Buttons Button Action Search Enter zone configuration information in the field and click to display a subset of zone configurations matching the search string. Edit Display the Zone Configuration details page in edit mode.
Column Description Action Edit zone configuration information Delete the zone configuration Link Delivers Zone configuration details page in edit mode Delete confirmation dialog box Zone ConfigurationsZone Configuration DetailAssign ZFS Dataset Fields Field Description Format Name ZFS dataset name Drop-down list Buttons Button Action Assign Assign the ZFS Dataset selected in the Name field to the zone configuration.
Columns Column Description Link Delivers Name Job name Job output Method Name Name of script/job NA State Success/failure NA Priority Rank of run sequence NA Queue Name Name of node NA Queued At Date of job run-time NA Actions Create/delete Create or delete button Zone ConfigurationsZone Configuration DetailZones (4) Buttons Button Action Show All Displays all zones using the current zone configuration.
Zones Button Button Action Search Enter zone information in the field and click to display a subset of zones matching the search string. New Zone Create a new zone, ready to be provisioned. If you create a zone from this page, it will automatically be assigned to the next customer who requests a zone with the same zone configuration. Filter by Zone Configuration Filter the display by the zone configuration selected.
Column Description Link Delivers Setup At Date the zone was set up NA Size Zone size NA Server Server where the zone resides Comments Notes relating to the zone Action Edit zone information NA Zone details page in edit mode Confirmation message Send Welcome email to zone owner Delete the zone Removes zone from display without prompting for confirmation NOTE: Red column titles indicate that the rows can be sorted. Click the column title to display the rows in ascending order.
Cloud Control | 105
Buttons Button Action Search Enter zone information in the field and click to display a subset of zones matching the search string. Resend Welcome Email Resend the Welcome email to the zone owner. Resend Email to Alternate Address Resend the Welcome email to the alternate address associated with the zone. Mark as Deactivated Mark the zone as deactivated. This button does not initiate deactivation. Use this button if you deactivate a zone outside of Cloud Control.
Field Description Format Server Hostname Zone hostname Text Zone Name Zone name generated by Cloud Control Text DNS DNS associated with the zone (if designated) URL Zone Type Zone type Text Zone Status Zone status Choice: Active Assigned Destroyed ZFS Dataset ZFS dataset (template) associated with the zone Text Virtual IP Zone IP Integer Internal IP Only Internal IP of zone configured True/False CPU Cap Maximum percentage of a single CPU core the zone can use.
Field Description Format Deactivated At Date/time the zone was deactivated YYYY/MM/DD HH:MM Deactivated By User who deactivated zone Text Destroyed At Date/time the zone was destroyed YYYY/MM/DD HH:MM Destroyed By User who destroyed zone Text Disk Usage Amount of disk used by the zone GBs and Percent ZFS Quota Memory allocated to zone Integer ZFS Origin Name of template used Text Comments Notes relating to the zone Text DSA Key Fingerprint DSA Key Text RSA Key Fingerprint RSA
ZonesZone DetailIPs The middle section of the Zones details page lists the IPs associated with the zone.
Fields Field Description Format IP Address IP Address x.y.z.0 Buttons Button Action Assign Assign the IP address to the zone.
Buttons Button Action Remove Remove the credential record. Credentials added here are added only to the Cloud Control database. Fields Field Description Format System Purpose of the credential Text Username Username Text Password Associated password Text Buttons Button Action Add Credentials Create a new set of credentials based on the data in the form. Note that this information appears only in the Cloud Control database. It does not create a new user on the zone.
ZonesZone DetailHostnames Columns Column Description Link Delivers Name Desired hostname NA Action Create hostname NA Field Description Format Name Hostname Text Fields Buttons Button Action Add Hostname Add a hostname using the data in the Name field.
ZonesZone DetailJobs Columns Column Description Link Delivers Name Zone on which the job is running Details of the job Method Name Job name NA State Success or failure of the job NA Priority Priority level of the job NA Queue Name Name of the server on which the job was queued NA Queued At Date/time the job was queued NA Actions Checkbox Remove the job record from the list. (Does not affect running jobs.
ZonesZone DetailSnapshots Columns Column Description Link Delivers Name Snapshot name.
ZonesZone DetailSnapshotsSnapshot Detail Buttons Button Action Queue for Rollback Queue a job for rolling back the state of the zone. A job record will appear on this page. Queue for Destruction Queue a job for destroying the snapshot. A job record will appear on this page. Jobs Buttons Button Action Search Enter job information in the field and click to display a subset of jobs matching the search string. Filter by Method Name Filter the list by the kind of job.
Column Column Description Link Delivers Name Zone name Detailed job record Method Name Job name NA State Job state NA Priority Job priority NA Queue Name Queue name; typically, the name of the server NA Queued At Time the job was queued NA Actions Allows you to delete individual or multiple job records NA Storage Pools Buttons Button Action Search Enter ZFS storage pool information in the field and click to display a subset of storage pools matching the search string.
Column Description Link Delivers Name (Server) Pool and server name Pool detail page Available Disk (GB) Available space in the pool in GB NA Total Disk (GB) Total size of the pool in GB NA Full? Whether the pool is full NA Health Health of the pool (usually Online) NA Mountpoint Mountpoint of the pool in the global zone NA Storage PoolsZFS Storage Pool Detail Buttons Button Action Search Enter ZFS storage pool information in the field and click to display a subset of storage pools
Fields Field Description Format Total Disk (GB) Pool and server name Integer Available Disk (GB) Available space in the pool in GB Integer Server Total size of the pool in GB Link to host node Full? Whether the pool is full Text Health Health of the pool (usually Online) Text Mountpoint Mountpoint of the pool in the global zone Text Common Tasks Setting up a SmartMachine (Zone) Cloud Control | 118
1 Select a customer from the customer list.
2 Scroll to the Create New Zone by Type panel. 3 Select a template from the drop-down list. 4 Click the Create button. The new zone appears in the Zone Information section with the status assigned. 5 Click the zone name to open the Zone page.
6 Click the Queue for Provisioning in Solaris button. 7 A message is displayed indicating that the zone is queued for provisioning. 8 Scroll to the Jobs panel to verify that the provisioning job is queued.
More jobs appear as the provisioning process continues.
9 When the process is complete, the credentials information fields will be filled. 10 Return to the customer page to verify that the new zone is active. Deleting a SmartMachine (Zone) 1 Navigate to the page of the zone you want to delete.
2 Click the Queue for Deactivation in Solaris button.
3 A dialog box appears, asking you to confirm that you want to deactivate the zone. Type deactivate and click the OK button. 4 The deactivation job is queued. Wait a few seconds, and then refresh your browser.
5 Click the Queue for Destruction in Solaris button. 6 A dialog box appears, asking you to confirm that you want to destroy the zone. Type destroy and click the OK button.
7 The destruction job is queued. Wait a few seconds, and then refresh your browser. The zone is destroyed. 8 If you want to remove the zone from the list of customer zones, click the Remove Customer button.
Monitoring a SmartMachine You can monitor the health of a SmartMachine from a zone page two ways. • Click the Status button to see a list of all the running processes. • Scroll to the end of a zone page to see a graph of memory, I/O, and CPU usage.
Cloud Control | 129
4 User Portal The self-service User Portal provides customers the means to perform certain tasks themselves. Through the User Portal, customers can self-provision, restart, shut down, and manage their SmartMachines. Accessing the User Portal Access to the User Portal is achieved using a browser. See the Dell Cloud Solutions for Web Applications Administrator Guide for setup details. User Portal Interface Login To log in to the User Portal, enter your username and password and click the Login button.
Creating SmartMachines The first time you log in to the User Portal the following screen appears. 1 Click the Add SmartMachine button. 2 Create one or more SmartMachines. NOTE: The number of SmartMachines created cannot exceed your total RAM quota. NOTE: In the User Portal, you cannot specify the server on which the zone is created. Select the appropriate configuration from Choose Your Desired SmartMachine Configuration drop-down list and click the Request Now button.
3 The system provisions your SmartMachine. A message displays, indicating that the SmartMachine is being provisioned. During provisioning, the system creates a unique name for your SmartMachine. After provisioning, the User Portal displays basic details about your Smart Machine. Both a public and a private IP address are listed for each SmartMachine. NOTE: The Status column shows the SmartMachine’s status at the time the page was loaded. It does not refresh automatically.
From this page there are three actions you can perform: • Reboot the SmartMachine. • Shutdown the SmartMachine. • Delete the SmartMachine. Customizing the Appearance of the User Portal The appearance of the User Portal can be customized to suit the needs of your enterprise. You can customize the User Portal in the following ways: • Change the title of the User Portal Window. • Provide customized online help. • Use a custom logo.
Providing Customized Online Help To enable a link to a help page, create a file called help.html. In the file, include any help you wish to provide. NOTE: A sample help.html file is included in /opt/joyent/apps/cloud_control_dop/config. Using a Custom Logo To use a custom logo, create a PNG file named logo.
User Portal | 135
5 Glossary | 136
Glossary BMC Baseboard Management Controller. Applies to PowerEdge™ R series servers only; not present in PowerEdge C series servers. CC / Cloud Control The web administration portal for managing the DCSWA operations. This provides the core management functionality of users, SmartMachines and the system in general. Cloud Control API Provides a REST programmatic interface into a subset of the features provided by Cloud Control.
Dell PowerEdge Server PowerEdge C2100; PowerEdge C1100; PowerEdge R710; PowerEdge R610 Dell PowerEdge Rack Enclosure PowerEdge 4220 42U Server Rack Enclosure DNS Server Required by the cloud to operate properly. This can be provided by the customer or as part of the cloud and tied into the customer DNS system. In either case, the customer’s DNS system must be modified to point to the cloud DNS server or host the cloud’s address spaces and name spaces.
MCP Master Control Portal: The legacy acronym for Cloud Control. MySQL A common database used in web applications. NSF Server An optional customer provided hardware component used to provide back-up and disaster recovery support. It can also be a way for the compute nodes to access a shared storage area. It is not intended for cloud user storage. Dell Services may choose to sell a component per pod or Cloud depending on size and scale.
Repository Server Serves Solaris packages to the SmartMachines for update and maintenance. The default set of tools might not be current or contain everything a developer needs. The repository provides tools and updates that can be applied to the SmartMachines after initial installation. The repository server resides on the Infrastructure server. RU Rack unit (1¾ inch). Servers SmartMachines are housed in servers, also called global zones.
6 Getting Help Contacting Dell Customers in the United States can call 800-WWW-DELL (800-9993355). NOTE: If you do not have an active Internet connection, you can find contact information on your purchase invoice, packing slip, bill, or Dell product catalog. Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services may not be available in your area.
Index A Deleting a SmartMachine, 112 Dell Cloud Solution for Web Applications. See DCSWA Acessing a SmartMachine, 13 G C Cloud Control Interface, 18 Appliances, 68 Customers, 19 Jobs, 106 Locations, 30 Network, 71 OpenSolaris, 84 PODs, 34 Racks, 39 Routers, 75 Servers, 44 Storage Pools, 107 Subnets, 80 Switches, 65 ZFS Datasets, 85 Zone Configurations, 89 Cloud Provisioning, 12 Cloud Solution Components Hardware Components, 7 Cloud Solutions Components Software Components, 7 Contacting Dell.
Running Services, 15 Setting Up, 109 Starting and Stopping, 15 Starting and Stopping a SmartMachine, 15 U User Portal, 10, 117 Customizing, 120 Z Zeus Load Balancer, 5
