From 823bc74935b8f3713c7443c617402334dc5fbda4 Mon Sep 17 00:00:00 2001 From: Ken Cochrane Date: Sat, 11 May 2013 19:03:41 -0400 Subject: [PATCH 1/3] Added install instructions for RackSpace cloud using Ubuntu 12.04, 12.10, 13.04 --- docs/sources/installation/index.rst | 1 + docs/sources/installation/rackspace.rst | 205 ++++++++++++++++++++++++ 2 files changed, 206 insertions(+) create mode 100644 docs/sources/installation/rackspace.rst 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..0ed7558a37 --- /dev/null +++ b/docs/sources/installation/rackspace.rst @@ -0,0 +1,205 @@ +=============== +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 + + # add the ppa to get the right kernel package + $ echo deb http://ppa.launchpad.net/ubuntu-x-swat/r-lts-backport/ubuntu precise 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 + + # 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 + +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 From f074e983bd99a19509f96e235a2f35fbe1cab849 Mon Sep 17 00:00:00 2001 From: Ken Cochrane Date: Sun, 12 May 2013 13:12:44 -0400 Subject: [PATCH 2/3] updated the rackspace docs to have more information, and fixed a couple of mistakes --- docs/sources/installation/rackspace.rst | 36 ++++++++++++++++------- docs/sources/installation/ubuntulinux.rst | 3 +- 2 files changed, 27 insertions(+), 12 deletions(-) diff --git a/docs/sources/installation/rackspace.rst b/docs/sources/installation/rackspace.rst index 0ed7558a37..51f13f4732 100644 --- a/docs/sources/installation/rackspace.rst +++ b/docs/sources/installation/rackspace.rst @@ -37,17 +37,8 @@ Ubuntu 12.04 .. code-block:: bash - # add the ppa to get the right kernel package - $ echo deb http://ppa.launchpad.net/ubuntu-x-swat/r-lts-backport/ubuntu precise 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 + $ apt-get install linux-generic-lts-raring # update grub so it will use the new kernel after we reboot $ update-grub @@ -89,6 +80,31 @@ Ubuntu 12.04 $ 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 ------------ 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 From 87038311fc0869d8dd9303d11ed79279238b0b6e Mon Sep 17 00:00:00 2001 From: Ken Cochrane Date: Sun, 12 May 2013 21:46:35 -0400 Subject: [PATCH 3/3] fixed the git clone url, it was the read-write one that required ssh access to the docker account, changed to the read only version --- docs/sources/contributing/devenvironment.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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/...