openstack/swift
Code Issues Proposed changes

Remove outdated Debian packaging guide.

Browse Source 
There are 3 sections in there, all useless.

Section 1 tells you how to install Swift packages from the swift-core
PPA. However, the latest version there is ancient.

Section 2 tells you how to build your own Swift packages. However, it
talks about getting the source code from the "debian" branch in bzr,
which is obviously really old.

Section 3 tells you how to take the packages from section 2 and
install them. This isn't too out-of-date, but since section 2 doesn't
work any more, section 3 is useless.

Since stale docs are worse than no docs, there's no current
information in this document, and bringing it up-to-date requires a
whole pile of work, I've chosen to delete it entirely.

Also pulled out a couple references to the PPA elsewhere.

Fixes bug 917385.
Fixes bug 1026145.

Change-Id: I510bd8619531fe110419e5488bd20d3602868d66
This commit is contained in:
Samuel Merritt 2012-11-09 18:01:34 -08:00
parent 217bd202dd
commit bf90ba2de1
3 changed files with 2 additions and 144 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

141
doc/source/debian_package_guide.rst
View File

@ -1,141 +0,0 @@
=======================================================
Building and Deploying Custom Debian packages for Swift
=======================================================
This documents setting up the prerequisites, downloading the code and building
Debian packages necessary to deploy the various components of the swift
project code. These steps were done on a server running
*Ubuntu 10.04 LTS (Lucid Lynx)*, but should give a good idea what to do on
other distros.
------------------------------------------
Instructions for Deploying Swift-Core PPAs
------------------------------------------
These packages are built from the current development branch "trunk"
* Add swift-core/ppa repository. As root:::
apt-get install python-software-properties
add-apt-repository ppa:swift-core/trunk
apt-get update
* Install the swift base packages::
apt-get install python-swift
apt-get install swift
* Install the swift packages depending on your implementations::
apt-get install swift-auth
apt-get install swift-proxy
apt-get install swift-account
apt-get install swift-container
apt-get install swift-object
* Copy sample configuration files to `/etc/swift` directory
and rename them to `*.conf files`::
cp -a /usr/share/doc/swift/*.conf-sample /etc/swift/
cd /etc/swift ; rename 's/\-sample$//' *.conf-sample
* For servers running the swift-account, swift-container or
swift-object the rsync.conf file should be moved to
the `/etc` directory::
cd /etc/swift
mv rsyncd.conf /etc
* Modify configuration files to meet your implementation requirements
the defaults have been not been geared to a multi-server implementation.
---------------------------------------------------
Instructions for Building Debian Packages for Swift
---------------------------------------------------
* Add swift-core/ppa repository and install prerequisites. As root::
apt-get install python-software-properties
add-apt-repository ppa:swift-core/release
apt-get update
apt-get install curl gcc bzr python-coverage python-dev python-nose python-setuptools python-simplejson python-xattr python-eventlet python-greenlet debhelper python-sphinx python-all python-openssl python-pastedeploy python-netifaces bzr-builddeb
* As you
#. Tell bzr who you are::
bzr whoami '<Your Name> <youremail@.example.com>'
bzr lp-login <your launchpad id>
#. Create a local bazaar repository for dev/testing::
bzr init-repo swift
#. Pull down the swift/debian files::
cd swift
bzr branch lp:~swift-core/swift/debian
#. If you want to merge in a branch::
cd debian
bzr merge lp:<path-to-branch>
#. Create the debian packages::
cd debian
bzr bd --builder='debuild -uc -us'
#. Upload packages to your target servers::
cd ..
scp *.deb root@<swift-target-server>:~/.
----------------------------------------------------
Instructions for Deploying Debian Packages for Swift
----------------------------------------------------
* On a Target Server, As root:
#. Setup the swift ppa::
add-apt-repository ppa:swift-core/release
apt-get update
#. Install dependencies::
apt-get install rsync python-openssl python-setuptools
python-simplejson python-xattr python-greenlet python-eventlet
python-netifaces
#. Install base packages::
dpkg -i python-swift_<version>_all.deb
dpkg -i swift_<version>_all.deb
#. Install packages depending on your implementation::
dpkg -i swift-auth_<version>_all.deb
dpkg -i swift-proxy_<version>_all.deb
dpkg -i swift-account_<version>_all.deb
dpkg -i swift-container_<version>_all.deb
dpkg -i swift-object_<version>_all.deb
dpkg -i swift-doc_<version>_all.deb
#. Copy sample configuration files to `/etc/swift` directory
and rename them to `*.conf files`::
cp -a /usr/share/doc/swift/*.conf-sample /etc/swift/
cd /etc/swift
rename 's/\-sample$//' *.conf-sample
#. For servers running the swift-account, swift-container or
swift-object the rsync.conf file should be moved to
the `/etc` directory::
cd /etc/swift/
mv rsyncd.conf /etc
#. Modify configuration files to meet your implementation requirements
the defaults have been not been geared to a multi-server implementation.

4
doc/source/getting_started.rst
View File

@ -34,8 +34,8 @@ A source tarball for the latest release of Swift is available on the `launchpad
Prebuilt packages for Ubuntu are available starting with Natty, or from PPAs for earlier releases.
* `Swift Latest Release PPA <https://launchpad.net/~swift-core/+archive/release>`_
* `Swift Current Trunk PPA <https://launchpad.net/~swift-core/+archive/trunk>`_
* `Swift Ubuntu Packages <https://launchpad.net/ubuntu/+source/swift>`_
* `Swift PPA Archive <https://launchpad.net/~swift-core/+archive/release>`_
-----------
Development

1
doc/source/index.rst
View File

@ -73,7 +73,6 @@ Administrator Documentation
howto_installmultinode
deployment_guide
admin_guide
debian_package_guide
Source Documentation
====================