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
This commit is contained in:
Samuel Merritt
parent
217bd202dd
commit
bf90ba2de1
@ -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.
|
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 Ubuntu Packages <https://launchpad.net/ubuntu/+source/swift>`_
|
||||||
* `Swift Current Trunk PPA <https://launchpad.net/~swift-core/+archive/trunk>`_
|
* `Swift PPA Archive <https://launchpad.net/~swift-core/+archive/release>`_
|
||||||
|
|
||||||
-----------
|
-----------
|
||||||
Development
|
Development
|
||||||
|
|||||||
@ -73,7 +73,6 @@ Administrator Documentation
|
|||||||
howto_installmultinode
|
howto_installmultinode
|
||||||
deployment_guide
|
deployment_guide
|
||||||
admin_guide
|
admin_guide
|
||||||
debian_package_guide
|
|
||||||
|
|
||||||
Source Documentation
|
Source Documentation
|
||||||
====================
|
====================
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user