blob: 96ab7aab25753966c21b86b8c8c03cf589bddb59 [file] [log] [blame]
# SOME DESCRIPTIVE TITLE.
# Copyright (C)
# This file is distributed under the same license as the Apache CloudStack Administration Documentation package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Apache CloudStack Administration Documentation 4\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2014-06-30 12:52+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../management.rst:18
# 36cc316d379647279da05d191cf9e9b5
msgid "Managing the Cloud"
msgstr ""
#: ../../management.rst:21
# 0dc09dfbe9e34a9cb51831005d8fc025
msgid "Using Tags to Organize Resources in the Cloud"
msgstr ""
#: ../../management.rst:23
# 3ead5d7ddceb4d98a278abeeed0683c2
msgid "A tag is a key-value pair that stores metadata about a resource in the cloud. Tags are useful for categorizing resources. For example, you can tag a user VM with a value that indicates the user's city of residence. In this case, the key would be \"city\" and the value might be \"Toronto\" or \"Tokyo.\" You can then request CloudStack to find all resources that have a given tag; for example, VMs for users in a given city."
msgstr ""
#: ../../management.rst:30
# 6388318fab6c44f58fd92b854f510717
msgid "You can tag a user virtual machine, volume, snapshot, guest network, template, ISO, firewall rule, port forwarding rule, public IP address, security group, load balancer rule, project, VPC, network ACL, or static route. You can not tag a remote access VPN."
msgstr ""
#: ../../management.rst:35
# 87e95cabe82f4b7f86c2cd1cc303b912
msgid "You can work with tags through the UI or through the API commands createTags, deleteTags, and listTags. You can define multiple tags for each resource. There is no limit on the number of tags you can define. Each tag can be up to 255 characters long. Users can define tags on the resources they own, and administrators can define tags on any resources in the cloud."
msgstr ""
#: ../../management.rst:42
# c2db56ab546245ec9d37ccf72573c16c
msgid "An optional input parameter, \"tags,\" exists on many of the list\\* API commands. The following example shows how to use this new parameter to find all the volumes having tag region=canada OR tag city=Toronto:"
msgstr ""
#: ../../management.rst:55
# 0d735394ca9f48f8a4ef3c5d0a25741d
msgid "The following API commands have the \"tags\" input parameter:"
msgstr ""
#: ../../management.rst:57
# 6d986331aa5d4971bab13111a8471d36
msgid "listVirtualMachines"
msgstr ""
#: ../../management.rst:59
# b0e2702f6aed49a8831ae5c2983a18c9
msgid "listVolumes"
msgstr ""
#: ../../management.rst:61
# 97c53594680a4cecb64e3f1a5ea2a2f3
msgid "listSnapshots"
msgstr ""
#: ../../management.rst:63
# 0217180a24604d579084142d07f11299
msgid "listNetworks"
msgstr ""
#: ../../management.rst:65
# dcf958a652304820818033fc441226e7
msgid "listTemplates"
msgstr ""
#: ../../management.rst:67
# 296660956a3b4ce5b02c4c7f1272e889
msgid "listIsos"
msgstr ""
#: ../../management.rst:69
# 69e88bee17394199a778180f3304fbf0
msgid "listFirewallRules"
msgstr ""
#: ../../management.rst:71
# 7954e7afc0334bc7bfcf16492195bb49
msgid "listPortForwardingRules"
msgstr ""
#: ../../management.rst:73
# d273e10141d84eecbdc74ec901700d11
msgid "listPublicIpAddresses"
msgstr ""
#: ../../management.rst:75
# b3e40262a34d4590bed84b8d5fc62798
msgid "listSecurityGroups"
msgstr ""
#: ../../management.rst:77
# e8f6e365e1da4b499d6b852d6c3e1162
msgid "listLoadBalancerRules"
msgstr ""
#: ../../management.rst:79
# 3c8faeeede5147fb911f022fd5858210
msgid "listProjects"
msgstr ""
#: ../../management.rst:81
# a9805315805e4d75b977c3428bcde48a
msgid "listVPCs"
msgstr ""
#: ../../management.rst:83
# bfab0c32d8364cd9a3e762e7992888f1
msgid "listNetworkACLs"
msgstr ""
#: ../../management.rst:85
# 46fab81fefa1469eb87698342b0f045e
msgid "listStaticRoutes"
msgstr ""
#: ../../management.rst:89
# 489808dcb1c9407cbe2bd271c02ce89a
msgid "Reporting CPU Sockets"
msgstr ""
#: ../../management.rst:91
# 7d8f4e987714451e9db1c9e749f8b1ca
msgid "PRODUCT manages different types of hosts that contains one or more physical CPU sockets. CPU socket is considered as a unit of measure used for licensing and billing cloud infrastructure. PRODUCT provides both UI and API support to collect the CPU socket statistics for billing purpose. The Infrastructure tab has a new tab for CPU sockets. You can view the statistics for CPU sockets managed by PRODUCT, which in turn reflects the size of the cloud. The CPU Socket page will give you the number of hosts and sockets used for each host type."
msgstr ""
#: ../../management.rst:100
# dec087784ccd48c49189c3f0ed1811a9
msgid "Log in to the PRODUCT UI."
msgstr ""
#: ../../management.rst:102
# 012d9d141d8745a48fd182b1cab1f8f1
msgid "In the left navigation bar, click Infrastructure."
msgstr ""
#: ../../management.rst:104
# 991d040f4ccc467f87019591608beea8
msgid "On CPU Sockets, click View all."
msgstr ""
#: ../../management.rst:106
# 1f3a30df3d8746f291bc00e761d59f3e
msgid "The CPU Socket page is displayed. The page shows the number of hosts and CPU sockets based on hypervisor types."
msgstr ""
#: ../../management.rst:111
# 3d662bf06abc42bd951d16844faada76
msgid "Changing the Database Configuration"
msgstr ""
#: ../../management.rst:113
# 638ca3cbc00844789edafb4eb0e60df5
msgid "The CloudStack Management Server stores database configuration information (e.g., hostname, port, credentials) in the file ``/etc/cloudstack/management/db.properties``. To effect a change, edit this file on each Management Server, then restart the Management Server."
msgstr ""
#: ../../management.rst:119
# a0530bddfe5a47a69ac27ef0a2c38a2e
msgid "Changing the Database Password"
msgstr ""
#: ../../management.rst:121
# 6ede044a32ac422baed2cd80afc2e114
msgid "You may need to change the password for the MySQL account used by CloudStack. If so, you'll need to change the password in MySQL, and then add the encrypted password to ``/etc/cloudstack/management/db.properties``."
msgstr ""
#: ../../management.rst:126
# 803fea7347b74457808913e8d34560e4
msgid "Before changing the password, you'll need to stop CloudStack's management server and the usage engine if you've deployed that component."
msgstr ""
#: ../../management.rst:135
# 83b051e006ce4a898817788447a54253
msgid "Next, you'll update the password for the CloudStack user on the MySQL server."
msgstr ""
#: ../../management.rst:142
# a6ed0f9a1e5f41d9883e8ab8e6ed7157
msgid "At the MySQL shell, you'll change the password and flush privileges:"
msgstr ""
#: ../../management.rst:150
# 5042ed8fa23b4aa6bf244fb7e8d21d0b
msgid "The next step is to encrypt the password and copy the encrypted password to CloudStack's database configuration (``/etc/cloudstack/management/db.properties``)."
msgstr ""
#: ../../management.rst:160
# 08fe5ba4a2844019b7c34948af80d3e9
msgid "File encryption type"
msgstr ""
#: ../../management.rst:162
# a985e48a20754561ae6daee44e6d79a8
msgid "Note that this is for the file encryption type. If you're using the web encryption type then you'll use password=\"management\\_server\\_secret\\_key\""
msgstr ""
#: ../../management.rst:166
# 41348185b9bc4aa59d47266350f37bea
msgid "Now, you'll update ``/etc/cloudstack/management/db.properties`` with the new ciphertext. Open ``/etc/cloudstack/management/db.properties`` in a text editor, and update these parameters:"
msgstr ""
#: ../../management.rst:175
# 3224048da0604d5e8ff7b22550451ce5
msgid "After copying the new password over, you can now start CloudStack (and the usage engine, if necessary)."
msgstr ""
#: ../../management.rst:185
# b42158e718f44c4ab881833d2dbc0929
msgid "Administrator Alerts"
msgstr ""
#: ../../management.rst:187
# f35a6a1c63244c84b73055d401027bf8
msgid "The system provides alerts and events to help with the management of the cloud. Alerts are notices to an administrator, generally delivered by e-mail, notifying the administrator that an error has occurred in the cloud. Alert behavior is configurable."
msgstr ""
#: ../../management.rst:192
# ff3195bd128540cca761c8b00697d461
msgid "Events track all of the user and administrator actions in the cloud. For example, every guest VM start creates an associated event. Events are stored in the Management Server’s database."
msgstr ""
#: ../../management.rst:196
# 6b6c7d267ebc4ecdba5787f75ed95d52
msgid "Emails will be sent to administrators under the following circumstances:"
msgstr ""
#: ../../management.rst:198
# 239b319d590244788e6be621087e695a
msgid "The Management Server cluster runs low on CPU, memory, or storage resources"
msgstr ""
#: ../../management.rst:201
# 11bbb0a3f5de4024ac7e944c1603e026
msgid "The Management Server loses heartbeat from a Host for more than 3 minutes"
msgstr ""
#: ../../management.rst:204
# f6a69a83f8bb45a193d273cbd63ac7bd
msgid "The Host cluster runs low on CPU, memory, or storage resources"
msgstr ""
#: ../../management.rst:208
# 267b4ae8b12e42d69f646aa22992388d
msgid "Sending Alerts to External SNMP and Syslog Managers"
msgstr ""
#: ../../management.rst:210
# 030acb1fc907414196ead65866a918b0
msgid "In addition to showing administrator alerts on the Dashboard in the CloudStack UI and sending them in email, CloudStack can also send the same alerts to external SNMP or Syslog management software. This is useful if you prefer to use an SNMP or Syslog manager to monitor your cloud."
msgstr ""
#: ../../management.rst:216
# ae64dcb892834822b7480195c2882a8c
msgid "The alerts which can be sent are:"
msgstr ""
#: ../../management.rst:218
# 814ff89fb6f444fc96a8b87a532bc28f
msgid "The following is the list of alert type numbers. The current alerts can be found by calling listAlerts."
msgstr ""
#: ../../management.rst:330
# cac2d1c9d3a34cb29f25fc81630f96dc
msgid "You can also display the most up to date list by calling the API command ``listAlerts``."
msgstr ""
#: ../../management.rst:334
# 0ead10e6a3664baf84b6199d70dfb243
msgid "SNMP Alert Details"
msgstr ""
#: ../../management.rst:336
# 77c8d073d21f41859f495f2b0120f7ef
msgid "The supported protocol is SNMP version 2."
msgstr ""
#: ../../management.rst:338
# 164535e01fe54071916fc21626d662af
msgid "Each SNMP trap contains the following information: message, podId, dataCenterId, clusterId, and generationTime."
msgstr ""
#: ../../management.rst:343
# be99b465676b4d13ae21a9bd33ff94ef
msgid "Syslog Alert Details"
msgstr ""
#: ../../management.rst:345
# 653fb8fc18ea4f17ab01fe630ed6783b
msgid "CloudStack generates a syslog message for every alert. Each syslog message incudes the fields alertType, message, podId, dataCenterId, and clusterId, in the following format. If any field does not have a valid value, it will not be included."
msgstr ""
#: ../../management.rst:354
# 7c74aa344fe948a39e5bff24928b78fa
msgid "For example:"
msgstr ""
#: ../../management.rst:361
# b3bcf49651e44cc189085099c9309174
msgid "Configuring SNMP and Syslog Managers"
msgstr ""
#: ../../management.rst:363
# b5638ebd1bd5442ab77995897186ed0c
msgid "To configure one or more SNMP managers or Syslog managers to receive alerts from CloudStack:"
msgstr ""
#: ../../management.rst:366
# 377884390b154436a6ce3913008b664c
msgid "For an SNMP manager, install the CloudStack MIB file on your SNMP manager system. This maps the SNMP OIDs to trap types that can be more easily read by users. The file must be publicly available. For more information on how to install this file, consult the documentation provided with the SNMP manager."
msgstr ""
#: ../../management.rst:372
# a32632406531434cbf5c4c261b1f69b6
msgid "Edit the file /etc/cloudstack/management/log4j-cloud.xml."
msgstr ""
#: ../../management.rst:378
# 8ba1745b7c924d888e2595a379d2db32
msgid "Add an entry using the syntax shown below. Follow the appropriate example depending on whether you are adding an SNMP manager or a Syslog manager. To specify multiple external managers, separate the IP addresses and other configuration values with commas (,)."
msgstr ""
#: ../../management.rst:384
# 6cd8468c57974817b400436e8e445394
msgid "The recommended maximum number of SNMP or Syslog managers is 20 for each."
msgstr ""
#: ../../management.rst:387
# d399f22c73ea4836a3776bd53493aaf9
msgid "The following example shows how to configure two SNMP managers at IP addresses 10.1.1.1 and 10.1.1.2. Substitute your own IP addresses, ports, and communities. Do not change the other values (name, threshold, class, and layout values)."
msgstr ""
#: ../../management.rst:405
# 57b464a769fd4128a163f5613f5f1c96
msgid "The following example shows how to configure two Syslog managers at IP addresses 10.1.1.1 and 10.1.1.2. Substitute your own IP addresses. You can set Facility to any syslog-defined value, such as LOCAL0 - LOCAL7. Do not change the other values."
msgstr ""
#: ../../management.rst:421
# 9ac4b5f945144653a9fb6df9185afba4
msgid "If your cloud has multiple Management Server nodes, repeat these steps to edit log4j-cloud.xml on every instance."
msgstr ""
#: ../../management.rst:424
# d82882ad1f8e447fb1ddbf2141ca0f1e
msgid "If you have made these changes while the Management Server is running, wait a few minutes for the change to take effect."
msgstr ""
#: ../../management.rst:427
# c74a110e35d5496db9637e208ca69f0c
msgid "**Troubleshooting:** If no alerts appear at the configured SNMP or Syslog manager after a reasonable amount of time, it is likely that there is an error in the syntax of the <appender> entry in log4j-cloud.xml. Check to be sure that the format and settings are correct."
msgstr ""
#: ../../management.rst:435
# 6e66a0c8054b4278923a1680c1d13f92
msgid "Deleting an SNMP or Syslog Manager"
msgstr ""
#: ../../management.rst:437
# daed36b7b2304574be3a327f0fdaae34
msgid "To remove an external SNMP manager or Syslog manager so that it no longer receives alerts from CloudStack, remove the corresponding entry from the file ``/etc/cloudstack/management/log4j-cloud.xml``."
msgstr ""
#: ../../management.rst:443
# 13024d28ec5a4e0d9d54dc264f048c4c
msgid "Customizing the Network Domain Name"
msgstr ""
#: ../../management.rst:445
# 47fe94d226e941e8971730847123ac7e
msgid "The root administrator can optionally assign a custom DNS suffix at the level of a network, account, domain, zone, or entire CloudStack installation, and a domain administrator can do so within their own domain. To specify a custom domain name and put it into effect, follow these steps."
msgstr ""
#: ../../management.rst:451
# 12a0d889b85a42dfb2f7a37556be8592
msgid "Set the DNS suffix at the desired scope"
msgstr ""
#: ../../management.rst:453
# 8f9f57e29f9c404d9930091f8630a427
msgid "At the network level, the DNS suffix can be assigned through the UI when creating a new network, as described in `“Adding an Additional Guest Network” <networking2#adding-an-additional-guest-network>`_ or with the updateNetwork command in the CloudStack API."
msgstr ""
#: ../../management.rst:459
# c091289d2eee46e89ea79afc752a76bf
msgid "At the account, domain, or zone level, the DNS suffix can be assigned with the appropriate CloudStack API commands: createAccount, editAccount, createDomain, editDomain, createZone, or editZone."
msgstr ""
#: ../../management.rst:464
# 3aa8bfbb66e6499eaf26bd3d496d6bf8
msgid "At the global level, use the configuration parameter guest.domain.suffix. You can also use the CloudStack API command updateConfiguration. After modifying this global configuration, restart the Management Server to put the new setting into effect."
msgstr ""
#: ../../management.rst:469
# ea55aed82e8440d191210e6219afd4b4
msgid "To make the new DNS suffix take effect for an existing network, call the CloudStack API command updateNetwork. This step is not necessary when the DNS suffix was specified while creating a new network."
msgstr ""
#: ../../management.rst:473
# c4c8780f62264aef9166fb7abb03b23d
msgid "The source of the network domain that is used depends on the following rules."
msgstr ""
#: ../../management.rst:476
# ed54e22f6c384a979fdd24525a23d6f4
msgid "For all networks, if a network domain is specified as part of a network's own configuration, that value is used."
msgstr ""
#: ../../management.rst:479
# b62736506f044912b7508f5bcfca6b0b
msgid "For an account-specific network, the network domain specified for the account is used. If none is specified, the system looks for a value in the domain, zone, and global configuration, in that order."
msgstr ""
#: ../../management.rst:483
# e4424d33ec9549389255552629bbdd2a
msgid "For a domain-specific network, the network domain specified for the domain is used. If none is specified, the system looks for a value in the zone and global configuration, in that order."
msgstr ""
#: ../../management.rst:487
# 3d1ebf272ba647ef8f54fcd126b4806c
msgid "For a zone-specific network, the network domain specified for the zone is used. If none is specified, the system looks for a value in the global configuration."
msgstr ""
#: ../../management.rst:493
# b6795b367f9a4a56bd542d1303ef6706
msgid "Stopping and Restarting the Management Server"
msgstr ""
#: ../../management.rst:495
# bbd28a885afc4bd6918951b631b80c85
msgid "The root administrator will need to stop and restart the Management Server from time to time."
msgstr ""
#: ../../management.rst:498
# 0d670244a1804343a1935015f8eaa6fb
msgid "For example, after changing a global configuration parameter, a restart is required. If you have multiple Management Server nodes, restart all of them to put the new parameter value into effect consistently throughout the cloud.."
msgstr ""
#: ../../management.rst:503
# 180fc3fdda44467f97b04959693747c5
msgid "To stop the Management Server, issue the following command at the operating system prompt on the Management Server node:"
msgstr ""
#: ../../management.rst:510
# 02d90290579d496098aed77584f7a2d3
msgid "To start the Management Server:"
msgstr ""