44 Commits

Author SHA1 Message Date
Clark Boylan
b61a3eb7a4 Clean up backups documentation
This adds the now required bup init command to the server to be backed
up. Also remove now gone HPCloud backup server and fix quotes around
command for catting public ssh key.

Change-Id: I607a7c079b16d7f1e94d6b0888cd6e302a04f68f
2017-02-08 10:38:27 -08:00
Jenkins
1960078a1d Merge "Use an ordinal server naming pattern" 2016-06-30 20:14:40 +00:00
Jenkins
abf31b52e9 Merge "Update cinder mgmt docs to use openstackclient" 2016-06-19 00:54:31 +00:00
Jenkins
4d04652b3f Merge "Add more lvm commands to cinder documentation" 2016-05-26 02:32:39 +00:00
Jeremy Stanley
3ac0a5eb69 Use an ordinal server naming pattern
As discussed during the "Launch Node, Ansible and Puppet" summit
session in Austin, we're making things unnecessarily hard on
ourselves by insisting on having multiple servers in our inventory
with the same name. In order to make server addition and replacement
automation simpler, start using an ordinal suffix on server short
names to differentiate them (we can still easily rely on DNS for
their non-numbered convenience names).

Change-Id: I040a5c3b5e1abc50c3e4676bcab0bf4eaa550f4b
2016-05-23 19:42:18 +00:00
Leif Madsen
bdd7085987
Minor documentation tweaks
Change-Id: Iece51871918979875f10eeaac0795c23232832d3
2016-04-27 22:29:05 -04:00
Spencer Krum
f76f5f446f Update cinder mgmt docs to use openstackclient
Instead of using a special cinder.sh and cinder vhost, use openstack
client with clouds.yaml.

Change-Id: I6a14a5fda09929d8345036ca4c54f387acd4fdc0
2016-04-14 13:26:23 -07:00
Spencer Krum
55e28bbe0b Add more lvm commands to cinder documentation
Sometimes we want to extend a logical volume to the entire size of the
volume group. The command to do this is quite strange and I am tried of
googling it. It is so documented.

Change-Id: I600ceb41c57e27eaaf68a1643be848cd331130a5
2016-04-14 12:54:06 -07:00
Jenkins
7ae85a3dbc Merge "Fix file link to groups.txt in sysadmin docs" 2016-03-11 11:23:38 +00:00
James E. Blair
1b7b8e0569 Add instructions on using openstackclient
Change-Id: I3a4c3618e1d558c80c7c0bcee94bb32027397311
2016-02-24 13:03:19 -08:00
Elizabeth K. Joseph
0f529255a9 Fix file link to groups.txt in sysadmin docs
Change-Id: I888beeebb70b16707661908992edb55f7f38f50c
2016-02-24 11:49:53 -08:00
Monty Taylor
765c1474b7 Use groups.txt for disabling hosts for puppet
We already have a dynamic system for managing static group management.
Use it for the disabled group so that the rules for managing the members
are not different.

Also, update the disabled list to match reality.

Also, Update docs because hosts are no longer groups

The upstream OpenStack Inventory in Ansible was fixed to no longer
return each cloud host as its own group unless there are duplicates for
the host in question. This  means it's no longer the right thing to do
to put hosts into disabled:children - disabled is just fine.

Change-Id: I95c83ed64801db15ad99a14547895f3520356f99
2016-01-20 11:38:20 -05:00
Monty Taylor
4e62f20007 Use puppet apply instead of puppet agent
At long last, the day of reckoning is here. Run puppet apply and then
copy the log files back and post them to puppetdb.

Change-Id: I919fea64df0fbb8681e91ac9425b4c43760bb3dd
2016-01-19 18:40:28 -05:00
James E. Blair
447ce13318 Clarify section on ansible inventory file
Change-Id: I3c5acb7a45c482854f68e9c9f008a2fa6ed945be
2015-12-04 11:07:51 -08:00
Monty Taylor
69ef1c7036 Add examples to make the disabling prose clearer
The way disabling works with puppet and openstack inventory in ansible
can be confusing at first. Some examples hopefully clarify the
situation.

Change-Id: Ib85feebce309896c6f3d139318dd5d204d9cb8ec
2015-12-04 14:02:34 -05:00
Monty Taylor
b23025acaa Fix three nits
These were caught in earlier reviews.

Change-Id: I026678fbbe871ffb138fd2c0dba9e788457da3a0
2015-11-30 22:24:53 -06:00
Monty Taylor
714c934d0c Use OpenStack for inventory instead of puppet
With the puppetmaster not there anymore, we should consume inventory
from OpenStack rather than from puppet.

It turns out that because of the way static and dynamic inventories get
merged, the static file needs to stand alone. SO - if you need to
disable a dynamic host from OpenStack (pretty much all of our hosts) you
need to not only add it to dynamic:children, you need to add an emtpy
group into the static file too, otherwise you'll get an error like:

 root@puppetmaster:~# ansible -i newinv '!disabled' --list-hosts
 ERROR: newinv/static:4: child group is not defined: (jenkins-dev.openstack.org)

Change-Id: Ic6809ed0b7014d7aebd414bf3a342e3a37eb10b6
2015-11-30 22:02:41 -06:00
Jenkins
0fbbcb0ea9 Merge "Add shade and openstack inventory to system" 2015-11-30 22:51:25 +00:00
Monty Taylor
7cee605a77 Add shade and openstack inventory to system
We're not ready to move from puppet inventory to openstack inventory
just yet, so don't actually swap the dynamic inventory plugin. But, add
it to the system so that running manual tests of all of the pieces is
possible.

Add the currently administratively disabled hosts to the disabled group
so that we can verify this works.

Change-Id: I73931332b2917b71a008f9213365f7594f69c41e
2015-11-28 15:59:10 -05:00
Spencer Krum
2fcf4ef6e9 We only backup to one server
Make the docs jive with reality.

Change-Id: Ic9a43cdd4bff041bec32be9d7110778bd5d6effc
2015-11-27 12:04:19 -08:00
AzherKhan
0bcb21f90f Update the sample puppet code block for etherpad
Updating the sample puppet code block for etherpad
on System Administration Wiki as it was referring
to an old etherpad puppet code.

Change-Id: Ibd2d2ee1febf909d5851b829a4a9c5f2d620a20f
2015-10-27 23:28:27 +05:30
Jeremy Stanley
0aa4acd536 Correct internal doc anchor for cinder vol mgmt
Change-Id: I6af62e8bb524feda96548f9fb2aeded7b35fdced
2015-04-20 21:45:05 +00:00
Elizabeth K. Joseph
77e5b91bbc Update docs for bup user home in /opt/backups
We're now putting bup backups into /opt/backups on a cinder
volume, updating documentation to move home directories for
servers we back up here.

Change-Id: I81e68dfb3fd9fd92dfb41ea3415a44db37f6c3af
2015-02-27 09:45:18 -08:00
Elizabeth K. Joseph
07fd18e754 Add instructions for vgcreate to sysadmin docs
The current sysadmin.html assumes there is a volume group (vg) present
when adding a new cinder volume. On a new server a vg won't exist, adding
instructions for how to add it.

Change-Id: I3171819fb5aea8a5edfab28f29ba35f9d0f5d461
2015-02-26 16:48:41 -08:00
James E. Blair
26aae7f49f Document how to disable/enable puppet
Change-Id: Id1f86c52727bac2403261083b55d89ab487fea10
2015-01-09 14:36:09 -08:00
Andreas Jaeger
e74e0cb50c Clarify puppet apply iteration docu
Clarify that only puppet apply needs to be iterated.

Change-Id: I6bad606506dca3ba9a97a48f64c6283dea0b4404
2014-12-04 19:01:54 +01:00
Andreas Jaeger
168254f154 Replace links to GerritWorkflow
Replace links to wiki article with link to infra-manual.

Change-Id: I574a30a44b0683ecf4914f1d5aef741b93d05016
2014-12-03 21:15:21 +01:00
Anita Kuno
8549f5d29e Rename config => system-config in docs
We are renaming the openstack-infra/config repo to
openstack-infra/system-config. This patch edits the docs files.

Change-Id: Ic594f1b5438a400fb6c1071c3045adb7a0b7e441
2014-10-17 15:05:29 -04:00
Jeremy Stanley
6585339b56 Update config documentation to refer to new master
Change-Id: I9072e866e47587d2de7e6d3c8f1e264d91a0d389
2014-09-15 20:48:33 +00:00
James E. Blair
c19da4c8a7 Move cinder docs into sysadmin section
And reference them from hosts that use cinder volumes.

Change-Id: I180f13a44d8e45209df8c6a16f275d987d05cbfe
2014-04-24 14:18:18 -07:00
James E. Blair
56562d83f7 Revert "Adds second hiera data directory"
This did not seem to work.

This reverts commit ed57cef9c5a65f429e07ce253668cd23ceb6c45a
2014-03-31 21:06:37 +00:00
Spencer Krum
ed57cef9c5 Adds second hiera data directory
This allows hiera data to be split into two buckets: sensitive and
non-sensitive. Sensitive data is put where it always has been. Non-
sensitive data, such as users ssh keys and lists of packages can be
put into the data directory contained within the
openstack-infra/config git repository.

This also introduces a more complex hierarchy: data is now split on
osfamily and lsbdistcondename. Operatingsystem is left for
compatibility.

Change-Id: I3b3faeab837aa5732da01e96bbe0c19aa936a58d
2014-03-28 18:42:33 -07: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
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
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
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
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
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
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
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
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