103 Commits

Author SHA1 Message Date
Jenkins
3735479bf0 Merge "Gerrit sysadmin tips for account repairs/renaming" 2013-09-06 00:10:29 +00:00
Jeremy Stanley
ae0c06c1a8 Preserve change creation time on project renames
* doc/source/gerrit.rst: When renaming projects in the changes
table, set created_on to itself so that it won't get updated to the
current time. This column is a timestamp datatype in MySQL and has
the "on update" property set, probably for no good reason but it's
how Gerrit's installer sets the schema.

Change-Id: I5b99d2869e55ab0f8b036fd08f248f406aff41bb
2013-09-05 01:36:43 +00:00
Jeremy Stanley
31bfd240e0 Gerrit sysadmin tips for account repairs/renaming
* doc/source/gerrit.rst: Add sections to the document about
resetting Gerrit SSH usernames and cleaning up duplicate preferred
E-mail addresses. Also a section demonstrating the dreaded account
merge process for posterity, even though we do not offer to perform
this for our users.

Change-Id: I43883ef9558abbdf5051aa617def36d1fc158100
2013-09-04 20:40:22 +00:00
Jenkins
4ce7f1991d Merge "Update references to GerritJenkinsGit wiki" 2013-09-03 17:55:40 +00:00
Robert Collins
2bfb9144f2 Document setting the correct hostname.
Puppetmaster bringup will often have the wrong hostname in a cloud
(e.g. a uuid or the shortname given to nova). But if it's wrong the
puppetmaster CA created by the puppetmaster module will be broken.

Additional nodes can have this handled by automation, but the
puppetmaster is special - this is part of the bootstrap process.

Change-Id: I8e0e2ea4a5d27fb248b88d6be57abb171d81f13f
2013-08-31 09:54:09 +12:00
Robert Collins
4d90f7a50c Document bootstrapping a new infrastructure.
Change-Id: Ic3345ecfe1c093ef68844430ed1c77cadbcf8b94
2013-08-31 08:43:13 +12:00
Robert Collins
0e5baad93f Document hiera setup a bit more comprehensively.
I had to ask, therefore we should record it :).

Change-Id: I321aa77df0037ff52a14e2bee81b147c312d08d6
2013-08-31 08:43:13 +12:00
Robert Collins
d6fd7db432 Make setting up a Puppetmaster easier.
There is a helpful script we can use that avoids the plumbing
discussion, and neither raring nor F19 can run a Puppet master, so we
should document that to avoid false starts.

Change-Id: I72f8767dc3fc7967207c37911e8e45a6d85c6001
2013-08-31 08:43:12 +12:00
Robert Collins
01e19830c3 Start documenting running your own CI infra.
This is incomplete, but as I haven't got a full thing up yet I can't
write it all. It is minimally a useful pointer for other folk trying
to do the same thing.

Change-Id: Iefb62a0ff60e5f46f1f0091beef54bfc4a376a53
2013-08-31 07:55:46 +12:00
Robert Collins
b24e2c4c91 Add a pointer to launch/README for root operators.
Cause it's not discoverable at the moment.

Change-Id: Ib8a4752f9340126e98b342e71ec6ebc11e6809b4
2013-08-31 07:55:43 +12:00
Elizabeth Krumbach Joseph
9f24ee0df1 Update references to GerritJenkinsGit wiki
We've moved the GerritJenkinsGithub wiki page to instead be
at GerritJenkinsGit, update references to it in our configs.

Change-Id: I88d8140a0e5f6e4051ca78415e0152c9cdcb86f6
2013-08-30 10:58:30 -07:00
Robert Collins
09b5460de0 Make root-only information clear in sysadmin.rst.
As we document more fully, it has become clear that the sysadmin page
really has two audiences: openstack-ci contributors and
openstack-ci/cloned-infra root operators.

Change-Id: If82c20a6292048f4212aac293da0b284f3b91436
2013-08-29 22:17:32 +12:00
Robert Collins
bd65ae3971 Fix semantic error in example config.
The user list is meant to be a list, not a literal.

Change-Id: I56fe64660c4a45aacdab7c4b2454d46ce7e80631
2013-08-29 22:17:32 +12:00
Robert Collins
7abc5fc72a Just run the install_puppet/modules scripts.
They have an x bit set and a shebang line, there is no need to specify
bash explicitly.

Change-Id: Ide8d0389c42d4ab256be3c0f6bdfcfcee621982b
2013-08-28 16:11:54 +12:00
Robert Collins
d9286370ff Fix copy-n-paste example to be clearer.
The example for spinning up an etherpad server couldn't just be run,
because the path to install_puppet.sh and the path to local.pp were
inconsistent. So lets document that the commands should be run from
the root of the checkout and fix the path to local.pp.

Change-Id: I34d4768687bd8aea8cd695faa845bddef24fa55f
2013-08-28 00:35:04 +12:00
Elizabeth Krumbach Joseph
dd1bb4a541 Update git documentation with HAProxy details
Update the documentation for our public git servers to reflect that it's now a
pool of servers load balanced with HAProxy.

Change-Id: Ib8bfec5cf8b339f2dfb57aaaf46d988ff32fc261
2013-08-23 10:25:53 -07:00
Jenkins
d78e4e6acc Merge "Use cgit server instead of github for everything" 2013-08-23 17:01:32 +00:00
Jenkins
5915c05a67 Merge "Clean up Static Web Hosting document" 2013-08-23 16:40:02 +00:00
Jeremy Stanley
350b6939a6 Clean up Static Web Hosting document
* doc/source/static.rst: Correctly indent a few preformatted command
example blocks, add a couple internal hyperlinks and clean up some
trailing whitespace on a number of lines.

Change-Id: I57980c21ac2eb08dafb05a4dc669992952b7465f
2013-08-23 16:36:32 +00:00
Monty Taylor
258abe1a23 Use cgit server instead of github for everything
We have a cgit server now, which means we should replace
all references to github with references to git.openstack.org.

Change-Id: I68ad1ce514fb4326c7d9940b5a84999af5b58562
2013-08-19 10:19:47 -07:00
Monty Taylor
e58b852907 Include instructions for deleting lock file
The zuul lock file needs to be removed as well.

Change-Id: Ice16e07c142026c4df45f21ffae80e6a506dfcdd
2013-08-17 21:56:20 -04:00
James E. Blair
8ba40aff55 Update project rename instructions
We use a thing called Zuul now.

Change-Id: Ie1a81003c37fa598897e31eef84bb8384498a9f8
2013-08-17 21:09:53 -04:00
Elizabeth Krumbach Joseph
58b14cfe14 Add more details to git server documentation
Specify what is running on the new git server, add basic
SELinux, replication and jeepyb details.

Also add to list of systems.

Change-Id: I027fa00cf6b6cee8b73fa844983cc82d465617ef
2013-08-16 12:27:01 -07:00
Jenkins
c35ad43352 Merge "Document RTFD hook job template in StackForge doc" 2013-08-15 18:06:57 +00:00
Jenkins
b8cf0809b3 Merge "Point to README.rst instead of .md for Devstack Gate." 2013-08-15 01:14:14 +00:00
Jeremy Stanley
47c189f68a Document RTFD hook job template in StackForge doc
* doc/source/stackforge.rst: Add basic documentation for the RTFD
job template. Also remove references to pylint and pyflakes jobs
which are mostly phased out due to increased flake8 popularity.

Change-Id: I0a1461a6c766a85cfac49ffed1b44358aabb2bc1
2013-08-13 21:22:49 +00:00
Jenkins
adfb2a7853 Merge "A few updates for RHEL based systems" 2013-08-12 20:13:36 +00:00
annegentle
6887ca69c5 Point to README.rst instead of .md for Devstack Gate.
Change-Id: I2af9d116f03cc5e66cac85c7db1eb02fd97f53ca
2013-08-12 14:06:40 -05:00
Paul Belanger
5a864b720a A few updates for RHEL based systems
Plus a ProTip about hiera

Change-Id: I307d264af650647f53b3e35a3bfc5721a06b06a8
Signed-off-by: Paul Belanger <paul.belanger@polybeacon.com>
2013-08-07 19:38:23 -04:00
Clark Boylan
90cc17950b Add Wiki upgrade process documentation.
* doc/source/wiki.rst: Document the wiki upgrade process.

Closes-Bug: #1206300
Change-Id: I31d4ef0895c25b4b3da1b2a6deb31e6b67d74e6d
2013-07-30 11:31:17 -07:00
Jenkins
275b45c27f Merge "Document volume maintenance on static" 2013-07-25 16:22:27 +00:00
Doug Hellmann
e6fb0aa640 Use the new oslo.sphinx library for the doc theme
Change-Id: I6b7557efec8d41687e4ef8a4864d1422bdebcfc5
Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
2013-07-22 11:50:39 -04:00
Russell Bryant
a573697b77 Update asterisk documentation
Update the documentation for the Asterisk server.  List the relevant
puppet bits, as well as where to find more documentation (the wiki for
user docs on calling in, and the free to read Asterisk book).

Change-Id: I91e97f5230868fe20c6432c046634b605d78b52c
2013-07-20 10:19:49 -07:00
Jenkins
a7aea1e1ea Merge "Add a skeleton asterisk server." 2013-07-18 04:58:14 +00:00
Jenkins
8aa2007d6e Merge "Minor doc fixes" 2013-07-18 03:38:10 +00:00
James E. Blair
40ee379325 Minor doc fixes
Things we noticed while using the docs during the bootcamp.

Change-Id: Ib407c2bb623d3bf2b5516023fec70bc247226303
2013-07-17 16:18:59 -07:00
James E. Blair
ca68f6e03c Document volume maintenance on static
Change-Id: Ia42cd5d5d0e942d627f7d457c75142076fcbdfa9
2013-07-17 15:31:32 -07:00
Russell Bryant
3b18e93131 Add a skeleton asterisk server.
This commit adds a bare server that will be updated to become an
Asterisk server.

Change-Id: If54badab3269d8c8ce504f8bfcb0e5f79eeaeb69
2013-07-17 13:11:39 -04:00
Elizabeth Krumbach
52732dd550 Add cgit web service and git server
Define git.openstack.org server and deploy cgit web service with
Apache on CentOS.

Change-Id: Id3c7c870e25e4202915bc081454896895084f9af
2013-07-16 09:55:11 -07:00
James E. Blair
ec844e3f1b Rename quantum to neutron
See: https://wiki.openstack.org/wiki/Network/neutron-renaming

Change-Id: If1bc26259a2a3e79012b63fe33af50372f7f2b43
Reviewed-on: https://review.openstack.org/35853
Tested-by: Jenkins
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Approved: James E. Blair <corvus@inaugust.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Tested-by: James E. Blair <corvus@inaugust.com>
2013-07-06 16:12:07 +00:00
Jeremy Stanley
d9da9e7835 Release Managers replaces openstack-release.
* doc/source/gerrit.rst: Update documentation to indicate that the
Release Managers group in Gerrit has supplanted the old
openstack-release group.

Change-Id: Id4ac08583ec3723289a1ebffbd1bbed1e591b760
Reviewed-on: https://review.openstack.org/34462
Reviewed-by: Elizabeth Krumbach Joseph <lyz@princessleia.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Approved: James E. Blair <corvus@inaugust.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Tested-by: Jenkins
2013-07-02 16:54:15 +00:00
James E. Blair
cac7dedf72 Fix a typo in logstash docs
This fixes a typo in the logstash module documentation.  The
original documentation said "mulitple" which is an unword.

Change-Id: Ied3e3a3356590ec188f8f2176ebfaa0169957fcd
Reviewed-on: https://review.openstack.org/34756
Approved: James E. Blair <corvus@inaugust.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Tested-by: Jenkins
2013-06-27 17:50:25 +00:00
James E. Blair
839bc3c0b0 Rename stackforge/reddwarf to openstack/trove.
Change-Id: I78ca586ce1451e3fa875482d310255b9638dc745
Reviewed-on: https://review.openstack.org/32930
Tested-by: Jenkins
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Approved: James E. Blair <corvus@inaugust.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Tested-by: James E. Blair <corvus@inaugust.com>
2013-06-14 20:17:43 +00:00
Doug Hellmann
6b3a8c542d add openstack theme
Change-Id: Iae4c09ee950fa3617c6fc2b990bc26d0a50367ec
Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Reviewed-on: https://review.openstack.org/32628
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Approved: James E. Blair <corvus@inaugust.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Tested-by: Jenkins
2013-06-13 23:40:57 +00:00
Clark Boylan
4aba312807 Use gearman to distribute logstash log pushing.
This change reorgs the logstash log pushing so that there is a central
gearman server that listens to Jenkins ZMQ events which are then
converted to per log file gearman jobs which are processed by gearman
workers. The central gearman server will live on logstash.o.o and the
existing logstash-worker hosts will be converted to gearman log pusher
workers.

This commit includes relavent documentation changes.

Change-Id: I45f7185c2479c54b090d223408dff268e1e8d7db
Reviewed-on: https://review.openstack.org/32455
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Approved: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Tested-by: Jenkins
2013-06-12 21:45:42 +00:00
Doug Hellmann
c8c48f3585 fix typos
Change-Id: I3faffb4cf33da235fb1a8ac3704e3166e8610c06
Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Reviewed-on: https://review.openstack.org/32636
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Reviewed-by: Elizabeth Krumbach Joseph <lyz@princessleia.com>
Approved: Jeremy Stanley <fungi@yuggoth.org>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Tested-by: Jenkins
2013-06-12 18:06:44 +00:00
Doug Hellmann
02b9d7a791 Fix navigation order with HOWTOs
Move the toctree from the HOWTOs sidebar on the front
page to a hidden toctree after the main toctree.
Create manual links to the HOWTOs docs in the sidebar.

This fixes the fact that the "next" link in the docs
navigated to one of the sidebars first, instead of the
introductory "Infrastructure Project" doc, while keeping
those sidebars in the toctree navigation so if someone
reads the docs straight through they get every page.

Change-Id: I5e1c23b7d3ce324bbd9e333cf6e898b33601982e
Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Reviewed-on: https://review.openstack.org/32630
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Reviewed-by: Elizabeth Krumbach Joseph <lyz@princessleia.com>
Approved: Jeremy Stanley <fungi@yuggoth.org>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Tested-by: Jenkins
2013-06-12 17:56:41 +00:00
Clark Boylan
6881008de0 Add logstash documentation.
* doc/source/logstash.rst: Add documentation on our Logstash system
architecture and how to query logstash.

Change-Id: I9da3e6d6391081131d1fd852230ddac6326c01a2
Reviewed-on: https://review.openstack.org/31257
Reviewed-by: James E. Blair <corvus@inaugust.com>
Reviewed-by: Elizabeth Krumbach Joseph <lyz@princessleia.com>
Approved: Jeremy Stanley <fungi@yuggoth.org>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Tested-by: Jenkins
2013-05-31 22:21:03 +00:00
James E. Blair
9ed2be3098 Refactor project infrastructure docs.
The goal is to re-orient the documentation as an introduction for new
contributors and a reference for all contributors.

Change-Id: I8702a5ace908c7618a6451bbfef7fc79b07429ff
Reviewed-on: https://review.openstack.org/30515
Reviewed-by: Elizabeth Krumbach Joseph <lyz@princessleia.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Approved: Monty Taylor <mordred@inaugust.com>
Reviewed-by: Monty Taylor <mordred@inaugust.com>
Tested-by: Jenkins
2013-05-30 17:27:07 +00:00
Jeremy Stanley
52abfa977f Clarify StackForge document audience and workflow.
* doc/source/stackforge.rst: Adjust the project onboarding sequence
to suggest requesting an initial group member last, since this seems
to be the simpler and less error-prone order. Also add a brief
subsection to the introduction describing the intended audience and
linking to prerequisite documentation for those who need some
additional education on OpenStack code review process and
convention.

Change-Id: I4a7cc6e56505a462c5596abe587c560bfa722f00
Reviewed-on: https://review.openstack.org/30564
Reviewed-by: slamet hendry <slamet.hendry@gmail.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Approved: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Tested-by: Jenkins
2013-05-28 18:24:42 +00:00