From bf90ba2de14af7f12682cd7e8dca74fa883463b8 Mon Sep 17 00:00:00 2001 From: Samuel Merritt Date: Fri, 9 Nov 2012 18:01:34 -0800 Subject: [PATCH] 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 --- doc/source/debian_package_guide.rst | 141 ---------------------------- doc/source/getting_started.rst | 4 +- doc/source/index.rst | 1 - 3 files changed, 2 insertions(+), 144 deletions(-) delete mode 100644 doc/source/debian_package_guide.rst diff --git a/doc/source/debian_package_guide.rst b/doc/source/debian_package_guide.rst deleted file mode 100644 index 8796106cbc..0000000000 --- a/doc/source/debian_package_guide.rst +++ /dev/null @@ -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 ' ' - bzr lp-login - - #. 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: - - #. Create the debian packages:: - - cd debian - bzr bd --builder='debuild -uc -us' - - #. Upload packages to your target servers:: - - cd .. - scp *.deb root@:~/. - - ----------------------------------------------------- -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__all.deb - dpkg -i swift__all.deb - - #. Install packages depending on your implementation:: - - dpkg -i swift-auth__all.deb - dpkg -i swift-proxy__all.deb - dpkg -i swift-account__all.deb - dpkg -i swift-container__all.deb - dpkg -i swift-object__all.deb - dpkg -i swift-doc__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. diff --git a/doc/source/getting_started.rst b/doc/source/getting_started.rst index 1e08682b05..dc6ee973d2 100644 --- a/doc/source/getting_started.rst +++ b/doc/source/getting_started.rst @@ -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 `_ -* `Swift Current Trunk PPA `_ +* `Swift Ubuntu Packages `_ +* `Swift PPA Archive `_ ----------- Development diff --git a/doc/source/index.rst b/doc/source/index.rst index aabf913b07..2d8b97ba5a 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -73,7 +73,6 @@ Administrator Documentation howto_installmultinode deployment_guide admin_guide - debian_package_guide Source Documentation ====================