blob: 7e5d458d440dd1f3c71ef407e76f3486da6be6ac [file] [log] [blame]
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2016, Apache Software Foundation
# 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.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2016-08-22 13:55+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
msgid "Managing the Cloud"
msgstr ""
#: ../../management.rst:21
msgid "Using Tags to Organize Resources in the Cloud"
msgstr ""
#: ../../management.rst:23
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
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
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
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
msgid "The following API commands have the \"tags\" input parameter:"
msgstr ""
#: ../../management.rst:57
msgid "listVirtualMachines"
msgstr ""
#: ../../management.rst:59
msgid "listVolumes"
msgstr ""
#: ../../management.rst:61
msgid "listSnapshots"
msgstr ""
#: ../../management.rst:63
msgid "listNetworks"
msgstr ""
#: ../../management.rst:65
msgid "listTemplates"
msgstr ""
#: ../../management.rst:67
msgid "listIsos"
msgstr ""
#: ../../management.rst:69
msgid "listFirewallRules"
msgstr ""
#: ../../management.rst:71
msgid "listPortForwardingRules"
msgstr ""
#: ../../management.rst:73
msgid "listPublicIpAddresses"
msgstr ""
#: ../../management.rst:75
msgid "listSecurityGroups"
msgstr ""
#: ../../management.rst:77
msgid "listLoadBalancerRules"
msgstr ""
#: ../../management.rst:79
msgid "listProjects"
msgstr ""
#: ../../management.rst:81
msgid "listVPCs"
msgstr ""
#: ../../management.rst:83
msgid "listNetworkACLs"
msgstr ""
#: ../../management.rst:85
msgid "listStaticRoutes"
msgstr ""
#: ../../management.rst:89
msgid "Reporting CPU Sockets"
msgstr ""
#: ../../management.rst:91
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
msgid "Log in to the PRODUCT UI."
msgstr ""
#: ../../management.rst:102
msgid "In the left navigation bar, click Infrastructure."
msgstr ""
#: ../../management.rst:104
msgid "On CPU Sockets, click View all."
msgstr ""
#: ../../management.rst:106
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
msgid "Changing the Database Configuration"
msgstr ""
#: ../../management.rst:113
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
msgid "Changing the Database Password"
msgstr ""
#: ../../management.rst:121
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
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
msgid "Next, you'll update the password for the CloudStack user on the MySQL server."
msgstr ""
#: ../../management.rst:142
msgid "At the MySQL shell, you'll change the password and flush privileges:"
msgstr ""
#: ../../management.rst:150
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
msgid "File encryption type"
msgstr ""
#: ../../management.rst:162
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
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
msgid "After copying the new password over, you can now start CloudStack (and the usage engine, if necessary)."
msgstr ""
#: ../../management.rst:185
msgid "Administrator Alerts"
msgstr ""
#: ../../management.rst:187
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
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
msgid "Emails will be sent to administrators under the following circumstances:"
msgstr ""
#: ../../management.rst:198
msgid "The Management Server cluster runs low on CPU, memory, or storage resources"
msgstr ""
#: ../../management.rst:201
msgid "The Management Server loses heartbeat from a Host for more than 3 minutes"
msgstr ""
#: ../../management.rst:204
msgid "The Host cluster runs low on CPU, memory, or storage resources"
msgstr ""
#: ../../management.rst:208
msgid "Sending Alerts to External SNMP and Syslog Managers"
msgstr ""
#: ../../management.rst:210
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
msgid "The alerts which can be sent are:"
msgstr ""
#: ../../management.rst:218
msgid "The following is the list of alert type numbers. The current alerts can be found by calling listAlerts."
msgstr ""
#: ../../management.rst:330
msgid "You can also display the most up to date list by calling the API command ``listAlerts``."
msgstr ""
#: ../../management.rst:334
msgid "SNMP Alert Details"
msgstr ""
#: ../../management.rst:336
msgid "The supported protocol is SNMP version 2."
msgstr ""
#: ../../management.rst:338
msgid "Each SNMP trap contains the following information: message, podId, dataCenterId, clusterId, and generationTime."
msgstr ""
#: ../../management.rst:343
msgid "Syslog Alert Details"
msgstr ""
#: ../../management.rst:345
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
msgid "For example:"
msgstr ""
#: ../../management.rst:361
msgid "Configuring SNMP and Syslog Managers"
msgstr ""
#: ../../management.rst:363
msgid "To configure one or more SNMP managers or Syslog managers to receive alerts from CloudStack:"
msgstr ""
#: ../../management.rst:366
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
msgid "Edit the file /etc/cloudstack/management/log4j-cloud.xml."
msgstr ""
#: ../../management.rst:378
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
msgid "The recommended maximum number of SNMP or Syslog managers is 20 for each."
msgstr ""
#: ../../management.rst:387
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
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
msgid "If your cloud has multiple Management Server nodes, repeat these steps to edit log4j-cloud.xml on every instance."
msgstr ""
#: ../../management.rst:424
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
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
msgid "Deleting an SNMP or Syslog Manager"
msgstr ""
#: ../../management.rst:437
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
msgid "Customizing the Network Domain Name"
msgstr ""
#: ../../management.rst:445
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
msgid "Set the DNS suffix at the desired scope"
msgstr ""
#: ../../management.rst:453
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
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
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
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
msgid "The source of the network domain that is used depends on the following rules."
msgstr ""
#: ../../management.rst:476
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
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
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
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
msgid "Stopping and Restarting the Management Server"
msgstr ""
#: ../../management.rst:495
msgid "The root administrator will need to stop and restart the Management Server from time to time."
msgstr ""
#: ../../management.rst:498
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
msgid "To stop the Management Server, issue the following command at the operating system prompt on the Management Server node:"
msgstr ""
#: ../../management.rst:510
msgid "To start the Management Server:"
msgstr ""