blob: 93381892bdbc75859c1422f5c094eee6ef731dfe [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"
#: ../../troubleshooting.rst:18
msgid "TroubleShooting"
msgstr ""
#: ../../troubleshooting.rst:21
msgid "Working with Server Logs"
msgstr ""
#: ../../troubleshooting.rst:23
msgid "The CloudStack Management Server logs all web site, middle tier, and database activities for diagnostics purposes in `/var/log/cloudstack/management/`. The CloudStack logs a variety of error messages. We recommend this command to find the problematic output in the Management Server log:."
msgstr ""
#: ../../troubleshooting.rst:30
msgid "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."
msgstr ""
#: ../../troubleshooting.rst:38
msgid "The CloudStack 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:"
msgstr ""
#: ../../troubleshooting.rst:47
msgid "Note that the job ID is 1076. You can track back the events relating to job 1076 with the following grep:"
msgstr ""
#: ../../troubleshooting.rst:54
msgid "The CloudStack Agent Server logs its activities in `/var/log/cloudstack/agent/`."
msgstr ""
#: ../../troubleshooting.rst:58
msgid "Data Loss on Exported Primary Storage"
msgstr ""
#: ../../troubleshooting.rst:61
#: ../../troubleshooting.rst:99
#: ../../troubleshooting.rst:140
#: ../../troubleshooting.rst:162
#: ../../troubleshooting.rst:185
#: ../../troubleshooting.rst:219
msgid "Symptom"
msgstr ""
#: ../../troubleshooting.rst:63
msgid "Loss of existing data on primary storage which has been exposed as a Linux NFS server export on an iSCSI volume."
msgstr ""
#: ../../troubleshooting.rst:68
#: ../../troubleshooting.rst:106
#: ../../troubleshooting.rst:146
#: ../../troubleshooting.rst:168
#: ../../troubleshooting.rst:197
#: ../../troubleshooting.rst:226
msgid "Cause"
msgstr ""
#: ../../troubleshooting.rst:70
msgid "It is possible that a client from outside the intended pool has mounted the storage. When this occurs, the LVM is wiped and all data in the volume is lost"
msgstr ""
#: ../../troubleshooting.rst:76
#: ../../troubleshooting.rst:112
#: ../../troubleshooting.rst:153
#: ../../troubleshooting.rst:176
#: ../../troubleshooting.rst:207
#: ../../troubleshooting.rst:235
msgid "Solution"
msgstr ""
#: ../../troubleshooting.rst:78
msgid "When setting up LUN exports, restrict the range of IP addresses that are allowed access by specifying a subnet mask. For example:"
msgstr ""
#: ../../troubleshooting.rst:85
msgid "Adjust the above command to suit your deployment needs."
msgstr ""
#: ../../troubleshooting.rst:89
msgid "More Information"
msgstr ""
#: ../../troubleshooting.rst:91
msgid "See the export procedure in the \"Secondary Storage\" section of the CloudStack Installation Guide"
msgstr ""
#: ../../troubleshooting.rst:96
msgid "Recovering a Lost Virtual Router"
msgstr ""
#: ../../troubleshooting.rst:101
msgid "A virtual router is running, but the host is disconnected. A virtual router no longer functions as expected."
msgstr ""
#: ../../troubleshooting.rst:108
msgid "The Virtual router is lost or down."
msgstr ""
#: ../../troubleshooting.rst:114
msgid "If you are sure that a virtual router is down forever, or no longer functions as expected, destroy it. You must create one afresh while keeping the backup router up and running (it is assumed this is in a redundant router setup):"
msgstr ""
#: ../../troubleshooting.rst:119
msgid "Force stop the router. Use the stopRouter API with forced=true parameter to do so."
msgstr ""
#: ../../troubleshooting.rst:122
msgid "Before you continue with destroying this router, ensure that the backup router is running. Otherwise the network connection will be lost."
msgstr ""
#: ../../troubleshooting.rst:126
msgid "Destroy the router by using the destroyRouter API."
msgstr ""
#: ../../troubleshooting.rst:128
msgid "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."
msgstr ""
#: ../../troubleshooting.rst:132
msgid "For more information about the API syntax, see the API Reference at `http://cloudstack.apache.org/docs/api/ <http://cloudstack.apache.org/docs/api/>`_."
msgstr ""
#: ../../troubleshooting.rst:137
msgid "Maintenance mode not working on vCenter"
msgstr ""
#: ../../troubleshooting.rst:142
msgid "Host was placed in maintenance mode, but still appears live in vCenter."
msgstr ""
#: ../../troubleshooting.rst:148
msgid "The CloudStack administrator UI was used to place the host in scheduled maintenance mode. This mode is separate from vCenter's maintenance mode."
msgstr ""
#: ../../troubleshooting.rst:155
msgid "Use vCenter to place the host in maintenance mode."
msgstr ""
#: ../../troubleshooting.rst:159
msgid "Unable to deploy VMs from uploaded vSphere template"
msgstr ""
#: ../../troubleshooting.rst:164
msgid "When attempting to create a VM, the VM will not deploy."
msgstr ""
#: ../../troubleshooting.rst:170
msgid "If the template was created by uploading an OVA file that was created using vSphere Client, it is possible the OVA contained an ISO image. If it does, the deployment of VMs from the template will fail."
msgstr ""
#: ../../troubleshooting.rst:178
msgid "Remove the ISO and re-upload the template."
msgstr ""
#: ../../troubleshooting.rst:182
msgid "Unable to power on virtual machine on VMware"
msgstr ""
#: ../../troubleshooting.rst:187
msgid "Virtual machine does not power on. You might see errors like:"
msgstr ""
#: ../../troubleshooting.rst:189
msgid "Unable to open Swap File"
msgstr ""
#: ../../troubleshooting.rst:191
msgid "Unable to access a file since it is locked"
msgstr ""
#: ../../troubleshooting.rst:193
msgid "Unable to access Virtual machine configuration"
msgstr ""
#: ../../troubleshooting.rst:199
msgid "A known issue on VMware machines. ESX hosts lock certain critical virtual machine files and file systems to prevent concurrent changes. Sometimes the files are not unlocked when the virtual machine is powered off. When a virtual machine attempts to power on, it can not access these critical files, and the virtual machine is unable to power on."
msgstr ""
#: ../../troubleshooting.rst:209
msgid "See the following:"
msgstr ""
#: ../../troubleshooting.rst:211
msgid "`VMware Knowledge Base Article <http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=10051/>`_"
msgstr ""
#: ../../troubleshooting.rst:216
msgid "Load balancer rules fail after changing network offering"
msgstr ""
#: ../../troubleshooting.rst:221
msgid "After changing the network offering on a network, load balancer rules stop working."
msgstr ""
#: ../../troubleshooting.rst:228
msgid "Load balancing rules were created while using a network service offering that includes an external load balancer device such as NetScaler, and later the network service offering changed to one that uses the CloudStack virtual router."
msgstr ""
#: ../../troubleshooting.rst:237
msgid "Create a firewall rule on the virtual router for each of your existing load balancing rules so that they continue to function."
msgstr ""
#: ../../troubleshooting.rst:242
msgid "Troubleshooting Internet Traffic"
msgstr ""
#: ../../troubleshooting.rst:244
msgid "Below are a few troubleshooting steps to check whats going wrong with your network..."
msgstr ""
#: ../../troubleshooting.rst:249
msgid "Trouble Shooting Steps"
msgstr ""
#: ../../troubleshooting.rst:251
msgid "The switches have to be configured correctly to pass VLAN traffic. You can verify if VLAN traffic is working by bringing up a tagged interface on the hosts and pinging between them as below..."
msgstr ""
#: ../../troubleshooting.rst:255
msgid "On *host1 (kvm1)*"
msgstr ""
#: ../../troubleshooting.rst:263
msgid "On *host2 (kvm2)*"
msgstr ""
#: ../../troubleshooting.rst:271
msgid "If the pings dont work, run *tcpdump(8)* all over the place to check who is gobbling up the packets. Ultimately, if the switches are not configured correctly, CloudStack networking wont work so fix the physical networking issues before you proceed to the next steps"
msgstr ""
#: ../../troubleshooting.rst:276
msgid "Ensure `Traffic Labels <http://cloudstack.apache.org/docs/en-US/Apache_CloudStack/4.2.0/html/Installation_Guide/about-physical-networks.html>`_ are set for the Zone."
msgstr ""
#: ../../troubleshooting.rst:278
msgid "Traffic labels need to be set for all hypervisors including XenServer, KVM and VMware types. You can configure traffic labels when you creating a new zone from the *Add Zone Wizard*."
msgstr ""
#: ../../troubleshooting.rst:284
msgid "On an existing zone, you can modify the traffic labels by going to *Infrastructure, Zones, Physical Network* tab."
msgstr ""
#: ../../troubleshooting.rst:289
msgid "List labels using *CloudMonkey*"
msgstr ""
#: ../../troubleshooting.rst:321
msgid "KVM traffic labels require to be named as *\"cloudbr0\"*, *\"cloudbr2\"*, *\"cloudbrN\"* etc and the corresponding bridge must exist on the KVM hosts. If you create labels/bridges with any other names, CloudStack (atleast earlier versions did) seems to ignore them. CloudStack does not create the physical bridges on the KVM hosts, you need to create them **before** before adding the host to Cloudstack."
msgstr ""
#: ../../troubleshooting.rst:340
msgid "The Virtual Router, SSVM, CPVM *public* interface would be bridged to a physical interface on the host. In the example below, *cloudbr0* is the public interface and CloudStack has correctly created the virtual interfaces bridge. This virtual interface to physical interface mapping is done automatically by CloudStack using the traffic label settings for the Zone. If you have provided correct settings and still dont have a working working Internet, check the switching layer before you debug any further. You can verify traffic using tcpdump on the virtual, physical and bridge interfaces."
msgstr ""
#: ../../troubleshooting.rst:372
msgid "Pre-create labels on the XenServer Hosts. Similar to KVM bridge setup, traffic labels must also be pre-created on the XenServer hosts before adding them to CloudStack."
msgstr ""
#: ../../troubleshooting.rst:385
msgid "The Internet would be accessible from both the SSVM and CPVM instances by default. Their public IPs will also be directly pingable from the Internet. Please note that these test would work only if your switches and traffic labels are configured correctly for your environment. If your SSVM/CPVM cant reach the Internet, its very unlikely that the Virtual Router (VR) can also the reach the Internet suggesting that its either a switching issue or incorrectly assigned traffic labels. Fix the SSVM/CPVM issues before you debug VR issues."
msgstr ""
#: ../../troubleshooting.rst:417
msgid "The Virtual Router (VR) should also be able to reach the Internet without having any Egress rules. The Egress rules only control forwarded traffic and not traffic that originates on the VR itself."
msgstr ""
#: ../../troubleshooting.rst:432
msgid "However, the Virtual Router's (VR) Source NAT Public IP address **WONT** be reachable until appropriate Ingress rules are in place. You can add *Ingress* rules under *Network, Guest Network, IP Address, Firewall* setting page."
msgstr ""
#: ../../troubleshooting.rst:439
msgid "The VM Instances by default wont be able to access the Internet. Add Egress rules to permit traffic."
msgstr ""
#: ../../troubleshooting.rst:444
msgid "Some users have reported that flushing IPTables rules (or changing routes) on the SSVM, CPVM or the Virtual Router makes the Internet work. This is not expected behaviour and suggests that your networking settings are incorrect. No IPtables/route changes are required on the SSVM, CPVM or the VR. Go back and double check all your settings."
msgstr ""
#: ../../troubleshooting.rst:451
msgid "In a vast majority of the cases, the problem has turned out to be at the switching layer where the L3 switches were configured incorrectly."
msgstr ""
#: ../../troubleshooting.rst:454
msgid "This section was contibuted by Shanker Balan and was originally published on `Shapeblue's blog <http://shankerbalan.net/blog/internet-not-working-on-cloudstack-vms/>`_"
msgstr ""