diff --git a/docs/sources/contributing/devenvironment.rst b/docs/sources/contributing/devenvironment.rst index ea5821b7da..0d202596c8 100644 --- a/docs/sources/contributing/devenvironment.rst +++ b/docs/sources/contributing/devenvironment.rst @@ -16,7 +16,7 @@ Instructions that have been verified to work on Ubuntu 12.10, mkdir -p $GOPATH/src/github.com/dotcloud cd $GOPATH/src/github.com/dotcloud - git clone git@github.com:dotcloud/docker.git + git clone git://github.com/dotcloud/docker.git cd docker go get -v github.com/dotcloud/docker/... diff --git a/docs/sources/installation/index.rst b/docs/sources/installation/index.rst index 0726d9b715..aaa1cc1959 100644 --- a/docs/sources/installation/index.rst +++ b/docs/sources/installation/index.rst @@ -18,4 +18,5 @@ Contents: vagrant windows amazon + rackspace upgrading diff --git a/docs/sources/installation/rackspace.rst b/docs/sources/installation/rackspace.rst new file mode 100644 index 0000000000..51f13f4732 --- /dev/null +++ b/docs/sources/installation/rackspace.rst @@ -0,0 +1,221 @@ +=============== +Rackspace Cloud +=============== + +.. contents:: Table of Contents + +Ubuntu 12.04 +------------ + +1. Build an Ubuntu 12.04 server using the "Next generation cloud servers", with your desired size. It will give you the password, keep that you will need it later. +2. When the server is up and running ssh into the server. + + .. code-block:: bash + + $ ssh root@ + +3. Once you are logged in you should check what kernel version you are running. + + .. code-block:: bash + + $ uname -a + Linux docker-12-04 3.2.0-38-virtual #61-Ubuntu SMP Tue Feb 19 12:37:47 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux + +4. Let's update the server package list + + .. code-block:: bash + + $ apt-get update + +5. Now lets install Docker and it's dependencies. To keep things simple, we will use the Docker install script. It will take a couple of minutes. + + .. code-block:: bash + + $ curl get.docker.io | sudo sh -x + +6. Docker runs best with a new kernel, so lets use 3.8.x + + .. code-block:: bash + + # install the new kernel + $ apt-get install linux-generic-lts-raring + + # update grub so it will use the new kernel after we reboot + $ update-grub + + # update-grub doesn't always work so lets make sure. ``/boot/grub/menu.lst`` was updated. + $ grep 3.8.0- /boot/grub/menu.lst + + # nope it wasn't lets manually update ``/boot/grub/menu.lst`` (make sure you are searching for correct kernel version, look at initial uname -a results.) + $ sed -i s/3.2.0-38-virtual/3.8.0-19-generic/ /boot/grub/menu.lst + + # once again lets make sure it worked. + $ grep 3.8.0- /boot/grub/menu.lst + title Ubuntu 12.04.2 LTS, kernel 3.8.0-19-generic + kernel /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash console=hvc0 + initrd /boot/initrd.img-3.8.0-19-generic + title Ubuntu 12.04.2 LTS, kernel 3.8.0-19-generic (recovery mode) + kernel /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash single + initrd /boot/initrd.img-3.8.0-19-generic + + # much better. + +7. Reboot server (either via command line or console) +8. login again and check to make sure the kernel was updated + + .. code-block:: bash + + $ ssh root@ + $ uname -a + Linux docker-12-04 3.8.0-19-generic #30~precise1-Ubuntu SMP Wed May 1 22:26:36 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux + + # nice 3.8. + +9. Make sure docker is running and test it out. + + .. code-block:: bash + + $ start dockerd + $ docker pull busybox + $ docker run busybox /bin/echo hello world + hello world + +Alternate install +^^^^^^^^^^^^^^^^^ +If you don't want to run the get.docker.io script and want to use packages instead, you can use the docker PPA. Here is how you use it. Replace step 5 with the following 3 steps. + +1. Add the custom package sources to your apt sources list. Copy and paste the following lines at once. + +.. code-block:: bash + + $ sudo sh -c "echo 'deb http://ppa.launchpad.net/dotcloud/lxc-docker/ubuntu precise main' >> /etc/apt/sources.list" + + +2. Update your sources. You will see a warning that GPG signatures cannot be verified. + +.. code-block:: bash + + $ sudo apt-get update + + +3. Now install it, you will see another warning that the package cannot be authenticated. Confirm install. + +.. code-block:: bash + + $ apt-get install lxc-docker + + +Ubuntu 12.10 +------------ + +1. Build an Ubuntu 12.10 server using the "Next generation cloud servers", with your desired size. It will give you the password, keep that you will need it later. +2. When the server is up and running ssh into the server. + + .. code-block:: bash + + $ ssh root@ + +3. Once you are logged in you should check what kernel version you are running. + + .. code-block:: bash + + $ uname -a + Linux docker-12-10 3.5.0-25-generic #39-Ubuntu SMP Mon Feb 25 18:26:58 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux + +4. Let's update the server package list + + .. code-block:: bash + + $ apt-get update + +5. Now lets install Docker and it's dependencies. To keep things simple, we will use the Docker install script. It will take a couple of minutes. + + .. code-block:: bash + + $ curl get.docker.io | sudo sh -x + +6. Docker runs best with a new kernel, so lets use 3.8.x + + .. code-block:: bash + + # add the ppa to get the right kernel package + $ echo deb http://ppa.launchpad.net/ubuntu-x-swat/q-lts-backport/ubuntu quantal main > /etc/apt/sources.list.d/xswat.list + + # add the key for the ppa + $ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B22AB97AF1CDFA9 + + # update packages again + $ apt-get update + + # install the new kernel + $ apt-get install linux-image-3.8.0-19-generic + + # make sure grub has been updated. + $ grep 3.8.0- /boot/grub/menu.lst + title Ubuntu 12.10, kernel 3.8.0-19-generic + kernel /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash console=hvc0 + initrd /boot/initrd.img-3.8.0-19-generic + title Ubuntu 12.10, kernel 3.8.0-19-generic (recovery mode) + kernel /boot/vmlinuz-3.8.0-19-generic root=/dev/xvda1 ro quiet splash single + initrd /boot/initrd.img-3.8.0-19-generic + + # looks good. If it doesn't work for you, look at the notes for 12.04 to fix. + +7. Reboot server (either via command line or console) +8. login again and check to make sure the kernel was updated + + .. code-block:: bash + + $ ssh root@ + $ uname -a + Linux docker-12-10 3.8.0-19-generic #29~precise2-Ubuntu SMP Fri Apr 19 16:15:35 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux + + # nice 3.8. + +9. Make sure docker is running and test it out. + + .. code-block:: bash + + $ start dockerd + $ docker pull busybox + $ docker run busybox /bin/echo hello world + hello world + +Ubuntu 13.04 +------------ + +1. Build an Ubuntu 13.04 server using the "Next generation cloud servers", with your desired size. It will give you the password, keep that you will need it later. +2. When the server is up and running ssh into the server. + + .. code-block:: bash + + $ ssh root@ + +3. Once you are logged in you should check what kernel version you are running. + + .. code-block:: bash + + $ uname -a + Linux docker-1304 3.8.0-19-generic #29-Ubuntu SMP Wed Apr 17 18:16:28 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux + +4. Let's update the server package list + + .. code-block:: bash + + $ apt-get update + +5. Now lets install Docker and it's dependencies. To keep things simple, we will use the Docker install script. It will take a couple of minutes. + + .. code-block:: bash + + $ curl get.docker.io | sudo sh -x + +6. Make sure docker is running and test it out. + + .. code-block:: bash + + $ start dockerd + $ docker pull busybox + $ docker run busybox /bin/echo hello world + hello world + \ No newline at end of file diff --git a/docs/sources/installation/ubuntulinux.rst b/docs/sources/installation/ubuntulinux.rst index 955e8eb3b0..972844cc18 100644 --- a/docs/sources/installation/ubuntulinux.rst +++ b/docs/sources/installation/ubuntulinux.rst @@ -48,8 +48,7 @@ Now install it, you will see another warning that the package cannot be authenti .. code-block:: bash - curl get.docker.io | sudo sh -x - + apt-get install lxc-docker Verify it worked