From f0dfa3f75f9385a5f1c01e41720b1619cded06db Mon Sep 17 00:00:00 2001 From: Joe Brockmeier Date: Sat, 11 Aug 2012 12:02:27 -0700 Subject: [PATCH] fixing licenses for t files, misc fixes --- .../LDAPserver-for-user-authentication.xml | 29 +- docs/en-US/Revision_History.xml | 62 +++-- ...plate-iso-snapshot-usage-record-format.xml | 26 +- docs/en-US/templates.xml | 29 +- docs/en-US/time-zones.xml | 249 ++++++++++-------- docs/en-US/trial-installation.xml | 22 +- docs/en-US/troubleshooting-alerts.xml | 24 +- ...g-dataloss-on-exported-primary-storage.xml | 29 +- docs/en-US/troubleshooting-lb-rules-fails.xml | 23 +- ...aintenance-mode-not-working-on-vCenter.xml | 23 +- ...leshooting-recover-lost-virtual-router.xml | 25 +- .../troubleshooting-unable-to-deploy-vms.xml | 24 +- .../troubleshooting-unable-to-power-on-vm.xml | 26 +- ...oubleshooting-working-with-server-logs.xml | 30 ++- docs/en-US/troubleshooting.xml | 40 ++- docs/en-US/tuning.xml | 24 +- 16 files changed, 488 insertions(+), 197 deletions(-) diff --git a/docs/en-US/LDAPserver-for-user-authentication.xml b/docs/en-US/LDAPserver-for-user-authentication.xml index 3cd4c3ba286..5fcb300af65 100644 --- a/docs/en-US/LDAPserver-for-user-authentication.xml +++ b/docs/en-US/LDAPserver-for-user-authentication.xml @@ -1,16 +1,35 @@ - %BOOK_ENTITIES; ]> + + +
Using an LDAP Server for User Authentication - You can use an external LDAP server such as Microsoft Active Directory or ApacheDS to authenticate CloudPlatform end-users. Just map CloudPlatform accounts to the corresponding LDAP accounts using a query filter. The query filter is written using the query syntax of the particular LDAP server, and can include special wildcard characters provided by CloudPlatform for matching common values such as the user’s email address and name. CloudPlatform will search the external LDAP directory tree starting at a specified base directory and return the distinguished name (DN) and password of the matching user. This information along with the given password is used to authenticate the user.. - To set up LDAP authentication in CloudPlatform, call the CloudPlatform API command ldapConfig and provide the following: + You can use an external LDAP server such as Microsoft Active Directory or ApacheDS to authenticate &PRODUCT; end-users. Just map &PRODUCT; accounts to the corresponding LDAP accounts using a query filter. The query filter is written using the query syntax of the particular LDAP server, and can include special wildcard characters provided by &PRODUCT; for matching common values such as the user’s email address and name. &PRODUCT; will search the external LDAP directory tree starting at a specified base directory and return the distinguished name (DN) and password of the matching user. This information along with the given password is used to authenticate the user.. + To set up LDAP authentication in &PRODUCT;, call the &PRODUCT; API command ldapConfig and provide the following: Hostname or IP address and listening port of the LDAP server Base directory and query filter - Search user DN credentials, which give CloudPlatform permission to search on the LDAP server + Search user DN credentials, which give &PRODUCT; permission to search on the LDAP server SSL keystore and password, if SSL is used @@ -18,4 +37,4 @@ -
+ diff --git a/docs/en-US/Revision_History.xml b/docs/en-US/Revision_History.xml index df57d7f48ee..55d741a64f2 100644 --- a/docs/en-US/Revision_History.xml +++ b/docs/en-US/Revision_History.xml @@ -1,27 +1,45 @@ - %BOOK_ENTITIES; ]> - - Revision History - - - - 0-0 - Tue May 29 2012 - - Jessica - Tomechak - - - - - Initial creation of book by publican - - - - - - + + + + Revision History + + + + 0-0 + Tue May 29 2012 + + Jessica + Tomechak + + + + + Initial creation of book by publican + + + + + + diff --git a/docs/en-US/template-iso-snapshot-usage-record-format.xml b/docs/en-US/template-iso-snapshot-usage-record-format.xml index d3ae8e1191a..3f811a5d777 100644 --- a/docs/en-US/template-iso-snapshot-usage-record-format.xml +++ b/docs/en-US/template-iso-snapshot-usage-record-format.xml @@ -1,3 +1,27 @@ + + +%BOOK_ENTITIES; +]> + + +
Template, ISO, and Snapshot Usage Record Format @@ -15,4 +39,4 @@ size – Size of the template, ISO, or snapshot startdate, enddate – The range of time for which the usage is aggregated; see Dates in the Usage Record -
\ No newline at end of file + diff --git a/docs/en-US/templates.xml b/docs/en-US/templates.xml index a249ded15e5..faecf1b76dc 100644 --- a/docs/en-US/templates.xml +++ b/docs/en-US/templates.xml @@ -1,10 +1,29 @@ - %BOOK_ENTITIES; ]> + + +
- Templates - - -
+ Templates + + + diff --git a/docs/en-US/time-zones.xml b/docs/en-US/time-zones.xml index a886e5f5f46..d6d4bc75df1 100644 --- a/docs/en-US/time-zones.xml +++ b/docs/en-US/time-zones.xml @@ -1,114 +1,137 @@ -
- Time Zones - The following time zone identifiers are accepted by the CloudPlatform API. There are several places that have a time zone as a required or optional parameter. These include scheduling recurring snapshots, creating a user, and specifying the usage time zone in the Configuration table. . - - - - - - - - Etc/GMT+12 - Etc/GMT+11 - Pacific/Samoa - - - Pacific/Honolulu - US/Alaska - America/Los_Angeles - - - Mexico/BajaNorte - US/Arizona - US/Mountain - - - America/Chihuahua - America/Chicago - America/Costa_Rica - - - America/Mexico_City - Canada/Saskatchewan - America/Bogota - - - America/New_York - America/Caracas - America/Asuncion - - - America/Cuiaba - America/Halifax - America/La_Paz - - - America/Santiago - America/St_Johns - America/Araguaina - - - America/Argentina/Buenos_Aires - America/Cayenne - America/Godthab - - - America/Montevideo - Etc/GMT+2 - Atlantic/Azores - - - Atlantic/Cape_Verde - Africa/Casablanca - Etc/UTC - - - Atlantic/Reykjavik - Europe/London - CET - - - Europe/Bucharest - Africa/Johannesburg - Asia/Beirut - - - Africa/Cairo - Asia/Jerusalem - Europe/Minsk - - - Europe/Moscow - Africa/Nairobi - Asia/Karachi - - - Asia/Kolkata - Asia/Bangkok - Asia/Shanghai - - - Asia/Kuala_Lumpur - Australia/Perth - Asia/Taipei - - - Asia/Tokyo - Asia/Seoul - Australia/Adelaide - - - Australia/Darwin - Australia/Brisbane - Australia/Canberra - - - Pacific/Guam - Pacific/Auckland - - - - - -
+ + +%BOOK_ENTITIES; +]> + + +
+ Time Zones + The following time zone identifiers are accepted by the &PRODUCT; API. There are several places that have a time zone as a required or optional parameter. These include scheduling recurring snapshots, creating a user, and specifying the usage time zone in the Configuration table. . + + + + + + + + Etc/GMT+12 + Etc/GMT+11 + Pacific/Samoa + + + Pacific/Honolulu + US/Alaska + America/Los_Angeles + + + Mexico/BajaNorte + US/Arizona + US/Mountain + + + America/Chihuahua + America/Chicago + America/Costa_Rica + + + America/Mexico_City + Canada/Saskatchewan + America/Bogota + + + America/New_York + America/Caracas + America/Asuncion + + + America/Cuiaba + America/Halifax + America/La_Paz + + + America/Santiago + America/St_Johns + America/Araguaina + + + America/Argentina/Buenos_Aires + America/Cayenne + America/Godthab + + + America/Montevideo + Etc/GMT+2 + Atlantic/Azores + + + Atlantic/Cape_Verde + Africa/Casablanca + Etc/UTC + + + Atlantic/Reykjavik + Europe/London + CET + + + Europe/Bucharest + Africa/Johannesburg + Asia/Beirut + + + Africa/Cairo + Asia/Jerusalem + Europe/Minsk + + + Europe/Moscow + Africa/Nairobi + Asia/Karachi + + + Asia/Kolkata + Asia/Bangkok + Asia/Shanghai + + + Asia/Kuala_Lumpur + Australia/Perth + Asia/Taipei + + + Asia/Tokyo + Asia/Seoul + Australia/Adelaide + + + Australia/Darwin + Australia/Brisbane + Australia/Canberra + + + Pacific/Guam + Pacific/Auckland + + + + + +
diff --git a/docs/en-US/trial-installation.xml b/docs/en-US/trial-installation.xml index 9e3e33aee10..8270e579b17 100644 --- a/docs/en-US/trial-installation.xml +++ b/docs/en-US/trial-installation.xml @@ -1,10 +1,28 @@ - %BOOK_ENTITIES; ]> + + +
Trial Installation Coming soon.
- diff --git a/docs/en-US/troubleshooting-alerts.xml b/docs/en-US/troubleshooting-alerts.xml index 9127364bf15..0efeb81dd1e 100644 --- a/docs/en-US/troubleshooting-alerts.xml +++ b/docs/en-US/troubleshooting-alerts.xml @@ -1,8 +1,27 @@ - %BOOK_ENTITIES; ]> + + +
Alerts The following is the list of alert type numbers. @@ -35,5 +54,4 @@ LOCAL_STORAGE = 24; RESOURCE_LIMIT_EXCEEDED = 25; //Generated when the resource limit exceeds the limit. Currently used for recurring snapshots only -
- + diff --git a/docs/en-US/troubleshooting-dataloss-on-exported-primary-storage.xml b/docs/en-US/troubleshooting-dataloss-on-exported-primary-storage.xml index 677bcc33a4b..4a94f60fbd3 100644 --- a/docs/en-US/troubleshooting-dataloss-on-exported-primary-storage.xml +++ b/docs/en-US/troubleshooting-dataloss-on-exported-primary-storage.xml @@ -1,8 +1,27 @@ - %BOOK_ENTITIES; ]> + + +
Data Loss on Exported Primary Storage @@ -17,14 +36,10 @@ Solution When setting up LUN exports, restrict the range of IP addresses that are allowed access by specifying a subnet mask. For example: - echo “/export 192.168.1.0/24(rw,async,no_root_squash)” > /etc/exports + echo “/export 192.168.1.0/24(rw,async,no_root_squash)” > /etc/exports Adjust the above command to suit your deployment needs. More Information - See the export procedure in the "Secondary Storage" section of the CloudPlatform Installation Guide + See the export procedure in the "Secondary Storage" section of the &PRODUCT; Installation Guide - - -
- diff --git a/docs/en-US/troubleshooting-lb-rules-fails.xml b/docs/en-US/troubleshooting-lb-rules-fails.xml index 1808d06b26b..c507178e831 100644 --- a/docs/en-US/troubleshooting-lb-rules-fails.xml +++ b/docs/en-US/troubleshooting-lb-rules-fails.xml @@ -1,8 +1,27 @@ - %BOOK_ENTITIES; ]> + + +
Load balancer rules fail after changing network offering @@ -17,6 +36,4 @@ Solution Create a firewall rule on the virtual router for each of your existing load balancing rules so that they continue to function. -
- diff --git a/docs/en-US/troubleshooting-maintenance-mode-not-working-on-vCenter.xml b/docs/en-US/troubleshooting-maintenance-mode-not-working-on-vCenter.xml index 60d769fa299..c4bf37f6bbe 100644 --- a/docs/en-US/troubleshooting-maintenance-mode-not-working-on-vCenter.xml +++ b/docs/en-US/troubleshooting-maintenance-mode-not-working-on-vCenter.xml @@ -1,8 +1,27 @@ - %BOOK_ENTITIES; ]> + + +
Maintenance mode not working on vCenter @@ -21,6 +40,4 @@ More Information See -
- diff --git a/docs/en-US/troubleshooting-recover-lost-virtual-router.xml b/docs/en-US/troubleshooting-recover-lost-virtual-router.xml index f4699d85929..12a51501379 100644 --- a/docs/en-US/troubleshooting-recover-lost-virtual-router.xml +++ b/docs/en-US/troubleshooting-recover-lost-virtual-router.xml @@ -1,8 +1,27 @@ - %BOOK_ENTITIES; ]> + + +
Recovering a Lost Virtual Router @@ -24,8 +43,4 @@ Recreate the missing router by using the restartNetwork API with cleanup=false parameter. For more information about redundant router setup, see Creating a New Network Offering. For more information about the API syntax, see the API Reference at API Reference. - - -
- diff --git a/docs/en-US/troubleshooting-unable-to-deploy-vms.xml b/docs/en-US/troubleshooting-unable-to-deploy-vms.xml index f1432c4df54..412b9bfc0d8 100644 --- a/docs/en-US/troubleshooting-unable-to-deploy-vms.xml +++ b/docs/en-US/troubleshooting-unable-to-deploy-vms.xml @@ -1,8 +1,27 @@ - %BOOK_ENTITIES; ]> + + +
Unable to deploy VMs from uploaded vSphere template @@ -17,5 +36,4 @@ Solution Remove the ISO and re-upload the template. -
- + diff --git a/docs/en-US/troubleshooting-unable-to-power-on-vm.xml b/docs/en-US/troubleshooting-unable-to-power-on-vm.xml index ba114732354..e037eda08f1 100644 --- a/docs/en-US/troubleshooting-unable-to-power-on-vm.xml +++ b/docs/en-US/troubleshooting-unable-to-power-on-vm.xml @@ -1,8 +1,27 @@ - %BOOK_ENTITIES; ]> + + +
Unable to power on virtual machine on VMware @@ -12,7 +31,7 @@ Unable to open Swap File Unable to access a file since it is locked -  Unable to access Virtual machine configuration + Unable to access Virtual machine configuration Cause @@ -22,6 +41,5 @@ Solution See the following: - VMware Knowledge Base Article + VMware Knowledge Base Article
- diff --git a/docs/en-US/troubleshooting-working-with-server-logs.xml b/docs/en-US/troubleshooting-working-with-server-logs.xml index 9255b5ac2bd..1017bf57252 100644 --- a/docs/en-US/troubleshooting-working-with-server-logs.xml +++ b/docs/en-US/troubleshooting-working-with-server-logs.xml @@ -1,16 +1,35 @@ - %BOOK_ENTITIES; ]> + + +
Working with Server Logs - The CloudPlatform Management Server logs all web site, middle tier, and database activities for diagnostics purposes in /var/log/cloud/management/. The CloudPlatform logs a variety of error messages. We recommend this command to find the problematic output in the Management Server log:. + The &PRODUCT; Management Server logs all web site, middle tier, and database activities for diagnostics purposes in /var/log/cloud/management/. The &PRODUCT; logs a variety of error messages. We recommend this command to find the problematic output in the Management Server log:. When copying and pasting a command, be sure the command has pasted as a single line before executing. Some document viewers may introduce unwanted line breaks in copied text. grep -i -E 'exception|unable|fail|invalid|leak|warn|error' /var/log/cloud/management/management-server.log - The CloudPlatform processes requests with a Job ID. If you find an error in the logs and you are interested in debugging the issue you can grep for this job ID in the management server log. For example, suppose that you find the following ERROR message: + The &PRODUCT; processes requests with a Job ID. If you find an error in the logs and you are interested in debugging the issue you can grep for this job ID in the management server log. For example, suppose that you find the following ERROR message: 2010-10-04 13:49:32,595 ERROR [cloud.vm.UserVmManagerImpl] (Job-Executor-11:job-1076) Unable to find any host for [User|i-8-42-VM-untagged] @@ -18,6 +37,5 @@ grep "job-1076)" management-server.log - The CloudPlatform Agent Server logs its activities in /var/log/cloud/agent/. -
- + The &PRODUCT; Agent Server logs its activities in /var/log/cloud/agent/. + diff --git a/docs/en-US/troubleshooting.xml b/docs/en-US/troubleshooting.xml index c129dc912e1..f3dc7d37da3 100644 --- a/docs/en-US/troubleshooting.xml +++ b/docs/en-US/troubleshooting.xml @@ -1,18 +1,34 @@ - %BOOK_ENTITIES; ]> + + +
- IP Load Balancing - DNS and DHCP - VPN - Configuring VPN - Using VPN with Windows - Using VPN with Mac - Templates - Events - Templates - - + Alert Type Numbers + Data Loss on Exported Primary Storage + Load balancer rules fail after changing network offering + Maintenance mode not working on vCenter + Recovering a Lost Virtual Router + Unable to deploy VMs from uploaded vSphere template + Unable to power on virtual machine on VMware + Working with Server Logs
diff --git a/docs/en-US/tuning.xml b/docs/en-US/tuning.xml index 91b0f0cf15b..bcaaaa1afbe 100644 --- a/docs/en-US/tuning.xml +++ b/docs/en-US/tuning.xml @@ -1,8 +1,27 @@ - %BOOK_ENTITIES; ]> + + +
Tuning This section provides tips on how to improve the performance of your cloud. @@ -11,5 +30,4 @@ -
- +