Commit Graph

100 Commits

Author SHA1 Message Date
Jenkins
c84145a93b Merge "Document basic admin hints for jeepyb." 2013-09-23 21:43:21 +00:00
Robert Collins
e7316e1673 Document basic admin hints for jeepyb.
Somewhat obvious, but would have saved me a debugging round-trip.

Change-Id: I31a69b8ba0413ed09423822b817f0d05517751b0
2013-09-23 17:27:22 -04:00
Robert Collins
1ac5997a82 Gerrit docs improvements - user and groups.
The user and group docs were a bit opaque, and the needed groups for
the project creator account were not well documented.

Change-Id: Iee6d3ea6dd34a687205412174f78cd44e756c953
2013-09-23 17:25:32 -04:00
Robert Collins
1ba7d02a0e Make gerrit DB setup match actual practice.
sudo su - mysql is the actual mechanism used by -infra folk.

Change-Id: I209f0e9e2cb3f4dd7ad012f39b6e6551c05c5e0e
2013-09-23 17:25:32 -04:00
Jenkins
83063e2f4a Merge "Clean up flake8 issues before switch" 2013-09-21 14:57:33 +00:00
Monty Taylor
eef4f76011 Clean up flake8 issues before switch
In anticipation of swtiching to flake8 as part of the removal of
pyflakes jobs, clean up a few flake8 errors so that we don't have to
ignore as many things.

Change-Id: Idb8466bb3194904d84e17dd3f2a7c32aff13788c
2013-09-20 14:37:30 -07:00
Jenkins
2f81032060 Merge "adding staging server for activity board" 2013-09-20 21:20:52 +00:00
Jenkins
266b6541ce Merge "Add cacti documentation" 2013-09-20 21:17:39 +00:00
Elizabeth Krumbach Joseph
9c01216cf3 Add publications link to docs
Now that it's working, add the Infrastructure Publications link
to our project documentation.

Change-Id: I8cea33d1a30905bb3b8ec4e569416ad2e22fb681
2013-09-20 12:23:07 -07:00
Elizabeth Krumbach Joseph
c93ebce891 Add cacti documentation
Initial commit for basic cacti documentation and how to add a
new host to our instance.

Change-Id: I16f3474c5e0355ea10d4bffc94925624ee64328a
2013-09-20 11:54:45 -07:00
Stefano Maffulli
93490ce25d adding staging server for activity board
Change-Id: Ib2b0de6e2cdc59f5c9dca90117d333f70dbab040
2013-09-12 14:40:44 +10:00
James E. Blair
dcef558baf Move running-your-own to the sidebar
It is a HOWTO and it isn't part of the flow of the main docs,
which are focused on how the OpenStack project infrastructure
is used and operated.

Change-Id: I6e783899ab55f952acab81c7c90ca596d9bb1603
2013-09-11 13:02:26 -07:00
Jenkins
43f6a6a96f Merge "Clarify bup server setup directions." 2013-09-11 04:43:04 +00:00
Clark Boylan
1d194f6a79 Clarify bup server setup directions.
* doc/source/sysadmin.rst: Add note about needing to send an EOF to bup
server to close the initial ssh connection used to verify the backup
server's ssh host key.

Change-Id: I9c21513e5c6de771572f1aa9cb10095bff730eac
2013-09-09 16:12:52 -07:00
Khai Do
02076717d0 link to jjb cache documentation in the handbook .
Additional documentation was added for jjb cache in jjb manual.
Instead of documenting it twice, this
patch simply points to the jjb manual.

Depends on I57cf59c8723aa04e20801f32a81b573c9d096b48
Fixes bug 1193450

Change-Id: I1741d9774540d1e6b877533f29238663c2890028
2013-09-09 12:12:26 -07:00
Jenkins
91980ec05d Merge "Add backup restore docs." 2013-09-09 13:02:24 +00:00
Khai Do
6192aea57f update thirdy party testing how to doc
I don't believe openstack has it's own jenkins gerrit trigger plugin
anymore.  The link was returning a 404 Error.  Updated the link
to point to the general gerrit trigger plugin in the jenkins-ci repo.

Change-Id: Id42f2d8371b8c8e4a0f1f57e110637d4a8b14953
2013-09-06 14:21:33 -07:00
Clark Boylan
c6cde7cfe4 Add backup restore docs.
* doc/source/sysadmin.rst: Document how to restore from bup backups.

* modules/bup/files/etc/bup-excludes: Exclude special backup restore
dirs in /root. This prevents backup restores from being backed up
too.

Change-Id: Ide0e69c128be0a8b8774df7acaf9267df097f104
2013-09-06 13:29:04 -07:00
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