Permalink
Browse files

Remove outdated Debian packaging guide.

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
  • Loading branch information...
smerritt committed Nov 10, 2012
1 parent 217bd20 commit bf90ba2de14af7f12682cd7e8dca74fa883463b8
Showing with 2 additions and 144 deletions.
  1. +0 −141 doc/source/debian_package_guide.rst
  2. +2 −2 doc/source/getting_started.rst
  3. +0 −1 doc/source/index.rst
@@ -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.
@@ -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
View
@@ -73,7 +73,6 @@ Administrator Documentation
howto_installmultinode
deployment_guide
admin_guide
- debian_package_guide
Source Documentation
====================

0 comments on commit bf90ba2

Please sign in to comment.