Skip to content

Commit 6f7f95f

Browse files
committed
Add Fedora to SAIO.
In the past we had a document at Wiki, called RHELInstructions, but it was permanently out of date, and someone deleted it, in order to stop the confusion. Differences for Fedora as quite small and it makes sense to maintain them inside the main document. This patch also fixes a couple of obvious problems: - a missing period - unwanted leading space that breaks a paragraph Still no idea how to remove color from [swift-hash]. Change-Id: I73cda027c9d9bf695cd640a6d55735d82fba0048
1 parent 48f7af6 commit 6f7f95f

File tree

1 file changed

+37
-6
lines changed

1 file changed

+37
-6
lines changed

doc/source/development_saio.rst

Lines changed: 37 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ SAIO - Swift All In One
66
Instructions for setting up a development VM
77
---------------------------------------------
88

9-
This documents setting up a virtual machine for doing Swift development. The
10-
virtual machine will emulate running a four node Swift cluster.
9+
This section documents setting up a virtual machine for doing Swift development.
10+
The virtual machine will emulate running a four node Swift cluster.
1111

1212
* Get the *Ubuntu 10.04 LTS (Lucid Lynx)* server image:
1313

@@ -33,16 +33,31 @@ Installing dependencies and the core code
3333
python-xattr sqlite3 xfsprogs python-webob python-eventlet
3434
python-greenlet python-pastedeploy python-netifaces`
3535
#. Install anything else you want, like screen, ssh, vim, etc.
36-
#. Next, choose either :ref:`partition-section` or :ref:`loopback-section`.
3736

37+
* On Fedora, log in as root and do:
38+
39+
#. `yum install openstack-swift openstack-swift-proxy
40+
openstack-swift-account openstack-swift-container openstack-swift-object`
41+
#. `yum install xinetd rsyncd`
42+
#. `yum install memcached`
43+
#. `yum install python-netifaces`
44+
45+
This installs all necessary dependencies, and also creates user `swift`
46+
and group `swift`. So, `swift:swift` ought to be used in every place where
47+
this manual calls for `<your-user-name>:<your-group-name>`.
48+
49+
Ensure that you are installing the version of Swift that corresponds to
50+
this document. If not, enable the correct update repositories.
51+
52+
Next, choose either :ref:`partition-section` or :ref:`loopback-section`.
3853

3954
.. _partition-section:
4055

4156
Using a partition for storage
4257
=============================
4358

44-
If you are going to use a separate partition for Swift data, be sure to add another device when
45-
creating the VM, and follow these instructions.
59+
If you are going to use a separate partition for Swift data, be sure to add
60+
another device when creating the VM, and follow these instructions.
4661

4762
#. `fdisk /dev/sdb` (set up a single partition)
4863
#. `mkfs.xfs -i size=1024 /dev/sdb1`
@@ -180,8 +195,24 @@ Setting up rsync
180195

181196
RSYNC_ENABLE=true
182197

198+
On Fedora, edit the following line in /etc/xinetd.d/rsync::
199+
200+
disable = no
201+
183202
#. `service rsync restart`
184203

204+
------------------
205+
Starting memcached
206+
------------------
207+
208+
On Fedora, make sure that memcached runs, running this if necessary:
209+
210+
* `systemctl enable memcached.service`
211+
* `systemctl start memcached.service`
212+
213+
If this is not done, tokens of tempauth expire immediately and accessing
214+
Swift with curl becomes impossible.
215+
185216
---------------------------------------------------
186217
Optional: Setting up rsyslog for individual logging
187218
---------------------------------------------------
@@ -651,7 +682,7 @@ If all doesn't go as planned, and tests fail, or you can't auth, or something do
651682
look for errors (most likely python tracebacks).
652683
#. Make sure all of the server processes are running. For the base
653684
functionality, the Proxy, Account, Container, and Object servers
654-
should be running
685+
should be running.
655686
#. If one of the servers are not running, and no errors are logged to syslog,
656687
it may be useful to try to start the server manually, for example:
657688
`swift-object-server /etc/swift/object-server/1.conf` will start the

0 commit comments

Comments
 (0)