Commit Graph

21 Commits

Author SHA1 Message Date
Madhuri Kumari fb0dedb211 [doc-migration] Add admin folder for related documents
Change-Id: I4e53423f53fd70382a18fd7aca50145b5bd16fac
2017-07-19 15:37:35 +05:30
yuanpeng cc4940f756 Fix some grammar or spelling de-normalization
Fix some de-normalization of plural forms or grammar

Change-Id: I9e2b5ab7a2744cd730a95e9f53c0ebc5fb696ad9
2017-03-17 17:38:51 +08:00
Jenkins 47ba8da9e8 Merge "Updates Documentation for non-ID Params" 2016-11-15 19:42:35 +00:00
Stephen Watson d7b88c47e5 Updates Documentation for non-ID Params
Updates magnum documentation to reflect the changes made for
bp/rename-id-parameter-names.

Change-Id: I7c0d69970b9ac50649cac0e80932b5971ce09c3f
Depends-on: Idc6b9322ec7c0ecb386162ca46c7d49b910685d8
Implements: blueprint rename-id-parameter-names
2016-11-11 11:56:50 -07:00
Jenkins 9ea401c55f Merge "remove extra bracket from script in docs." 2016-11-10 06:47:13 +00:00
Paul Czarkowski 1fb355eea3 remove extra bracket from script in docs.
The troubleshooting guide has a python script in it which has invalid
syntax. This removes the extra bracket from that script and makes it
function correctly.  I also added some more specificity for credentials.

Change-Id: I9c8b8f861b4226d9eddca4ab44c811faa89160bc
2016-11-09 14:56:32 -06:00
Spyros Trigazis 67de6c537a Add user-domain in role creation
We must add the user-domain to ensure than the user is from
the magnum domain.

Change-Id: I8defb35f745f7df2e20deea759a43ef1bb47d248
Closes-bug: #1635202
2016-11-01 14:06:44 +01:00
Jenkins 8f91077493 Merge "Revises 'json' to 'JSON' and 'yaml' to 'YAML'" 2016-10-10 06:29:04 +00:00
Mitsuhiro Tanino 278f92e5f9 Add dns server access confirmation
There is an environment that the google public DNS is not
able to use for the --dns-servername.
Before specifying the dns-servername, it's better to confirm
that the DNS can resolve server names properly at your
environment, otherwise, you will fail cluster creation.

Also this commit fixes some old links at the network
troubleshooting section of ops guide.

Change-Id: I2f765a8ff94ad54f3fb1fb029a36fdea328ea514
2016-10-03 15:31:07 -04:00
Yushiro FURUKAWA 66de9762a0 Revises 'json' to 'JSON' and 'yaml' to 'YAML'
Change-Id: Id0ecfde70cc31edf1175fc78b93b8a85110244b2
2016-09-30 22:11:40 +09:00
Jaycen Grant 584380f8ee Rename Bay to Cluster in docs
This is a continuation of patch 353726 and includes all of the
doc changes for replacing the term bay with cluster and
BayModel with ClusterTemplate.

Change-Id: Ia7efaed157971ad7631ddffb9c1400f3516720f0
Implements: blueprint rename-bay-to-cluster
2016-08-26 12:18:50 -07:00
Hongbin Lu e9ced7fe60 Add troubleshooting steps for trustee creation
Change-Id: I939b6b84fcf367444e0503e406762c9fa9d8b1e4
Partial-Implements: blueprint magnum-troubleshooting-guide
2016-05-12 15:47:41 -04:00
Eli Qiao d688b94cd5 Doc: fix flannel etcd key
In flanneld version 0.5.4(on fedora-atomic-23 iamge), the default flannel
etcd key changed from /coreos.com/network to /atomic.io/network.

Use $FLANNEL_ETCD_KEY in /etc/sysconfig/flanneld for debugging.

Change-Id: I13e26061b7a6b33878f90834eacde9c4bc6e72d7
2016-04-07 16:09:11 +08:00
Corey O'Brien 32f917c8d7 Switch to Atomic 23
Change the devstack image to the default Atomic 23 image.
Update templates not to rely on interface naming because the names
changed between Atomic 21 and Atomic 23 images.
Add a functional test to validate minion node registration.
Update docs to refer to a generic Atomic image.

Co-Authored-By: Hongbin Lu <hongbin.lu@huawei.com>

Implements: blueprint atomic23
Change-Id: Id67244e3f452b3c7c3c46fdabcca3a5c141a76c0
2016-04-02 18:17:42 -04:00
Jenkins 3b24dfd02e Merge "Add Flannel troubleshooting" 2016-03-06 02:50:19 +00:00
Ton Ngo 590849ac6a Add etcd troubleshooting
Add section on etcd to troubleshooting guide.

etcd provides key/value pair storage and management for
many services in the COE, therefore if it fails, many
other services will be failing also.  In some cases, the
secondary failures can be rather mysterious, for instance
kube-apiserver will simply fail to start with no specific
error message.

This section covers the basic failure scenario and gives some
pointers to verify the correct configuration, operation.

Partially implements:  blueprint magnum-troubleshooting-guide
Change-Id: I602a9c3b8e54796c72848cf945107a319e45b973
2016-02-26 00:28:03 +00:00
Ton Ngo 30a9d40999 Add Flannel troubleshooting
Add section on Flannel to troubleshooting guide.

Flannel provides the overlay network and is the default
network driver for Kubernetes COE.  It is also an optional
network driver for Swarm COE.  Failure in Flannel would
mean that the containers cannot communicate with each other.

This section covers common failures, how to verify configuration,
how to check for correct operation, logs, known limitations.

If you have encountered other scenarios or have additional tips,
please comment or add your own patch.

Partially implements:  blueprint magnum-troubleshooting-guide
Change-Id: Icfc61d532a3381f3b70d36d8e765f0b6548e0c3f
2016-02-26 00:06:13 +00:00
Ton Ngo e74830a588 Troubleshooting Kubernetes networking
Add guide for debugging inter-pods communication

The networking between pods is different and separate from the
neutron network set up for the cluster.  Flannel is the default
network for Kubernetes cluster and Docker is configured to use
Flannel subnet.  If there is a problem, the pods will not be
able to talk to each other.

This section describes techniques for debugging Kubernetes
networking based on Flannel.

Partially implements: blueprint magnum-troubleshooting-guide
Change-Id: Ifaa71b6c8a236041b033da8ea0a8e403ff884594
2016-02-01 02:22:52 +00:00
Ton Ngo 1d1eacceb9 Add troubleshooting for network
Cover the scenario when nodes cannot connect to internet

The nodes need to connect to the internet for discovery and
image download.  No network connection is a basic failure
and can happen at any time.  This patch describes some
techniques for debugging.

If you have encountered a scenario not described here, please
mention in the review.

Partially implements: blueprint magnum-troubleshooting-guide
Change-Id: I69ca9d624b960329109fbbed8634646e63aa5118
2016-01-21 22:39:12 +00:00
Thomas Maddox af95b3fb48 Add initial documentation for troubleshooting gate
After repeated trouble digging into gate failures,
this documentation should help a new or seasoned
Magnum developer simulate gate test failures for
troubleshooting purposes.

Partially implements: blueprint magnum-troubleshooting-guide

Change-Id: Ib015b404027af30d82f6aa2538f78cba820cbce4
2016-01-18 19:07:30 +00:00
Ton Ngo a8406104fc Skeleton for Troubleshooting Guide
Initial empty framework to fill in

Following up on the discussion at the Tokyo Summit, we are
putting together a Troubleshooting Guide for Magnum.
This is organized as a list of failure symptoms, with pointers
to techniques for troubleshooting.  The initial list of
failure symptoms is from brainstorming at the Summit, but
is expected to grow as more are identified.

This initial framework is not complete by any mean, but is set up
so that multiple contributors can work in parallel.
New details can be added at any time, but current details should
be kept accurate.

Partially implements: blueprint magnum-troubleshooting-guide
Change-Id: I83b9b9ba9c76e608b4adafa525caf92aaaaaf880
2016-01-07 05:20:20 +00:00