@@ -6,8 +6,8 @@ SAIO - Swift All In One
6
6
Instructions for setting up a development VM
7
7
---------------------------------------------
8
8
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.
11
11
12
12
* Get the *Ubuntu 10.04 LTS (Lucid Lynx) * server image:
13
13
@@ -33,16 +33,31 @@ Installing dependencies and the core code
33
33
python-xattr sqlite3 xfsprogs python-webob python-eventlet
34
34
python-greenlet python-pastedeploy python-netifaces `
35
35
#. Install anything else you want, like screen, ssh, vim, etc.
36
- #. Next, choose either :ref: `partition-section ` or :ref: `loopback-section `.
37
36
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 `.
38
53
39
54
.. _partition-section :
40
55
41
56
Using a partition for storage
42
57
=============================
43
58
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.
46
61
47
62
#. `fdisk /dev/sdb ` (set up a single partition)
48
63
#. `mkfs.xfs -i size=1024 /dev/sdb1 `
@@ -180,8 +195,24 @@ Setting up rsync
180
195
181
196
RSYNC_ENABLE=true
182
197
198
+ On Fedora, edit the following line in /etc/xinetd.d/rsync::
199
+
200
+ disable = no
201
+
183
202
#. `service rsync restart `
184
203
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
+
185
216
---------------------------------------------------
186
217
Optional: Setting up rsyslog for individual logging
187
218
---------------------------------------------------
@@ -651,7 +682,7 @@ If all doesn't go as planned, and tests fail, or you can't auth, or something do
651
682
look for errors (most likely python tracebacks).
652
683
#. Make sure all of the server processes are running. For the base
653
684
functionality, the Proxy, Account, Container, and Object servers
654
- should be running
685
+ should be running.
655
686
#. If one of the servers are not running, and no errors are logged to syslog,
656
687
it may be useful to try to start the server manually, for example:
657
688
`swift-object-server /etc/swift/object-server/1.conf ` will start the
0 commit comments