summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorDavid Newgas <david@newgas.net>2015-04-13 13:28:07 -0700
committerDavid Newgas <david@newgas.net>2015-04-13 13:28:07 -0700
commitb2dda5866039824e60cf413738f69f50d2f39a81 (patch)
tree963077afd2a1aaa156ee8d6607f9e0d6d3c8e878 /README.md
parent65919ceb6196dd31eec65215d4fbd692aea6960f (diff)
downloadgoogle-compute-image-packages-b2dda5866039824e60cf413738f69f50d2f39a81.tar.gz
Add install from source repository instructions
Occasionally it is necessary to install from master, for example if somebody needs the as yet unreleased clock-sync manager. This commit adds instructions on how to do this.
Diffstat (limited to 'README.md')
-rw-r--r--README.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/README.md b/README.md
index 0ebc126..d1adb2d 100644
--- a/README.md
+++ b/README.md
@@ -6,10 +6,40 @@ This repository is the collection of packages that are installed on the standard
1. Google Daemon - A service that manages user accounts, maintains ssh login keys, syncs the system clock after migration, and syncs public endpoint IP addresses.
## Installation
+
+### From Release Tarballs
The easiest way to install these packages into a Linux-based image is to extract each tarball to `/` (root). Image Bundle does not have a directory structure, it is recommended to it extract to `/usr/share/imagebundle`. The tarballs are available in [releases](https://github.com/GoogleCloudPlatform/compute-image-packages/releases).
Refer to [Building a Google Compute Engine Image](https://cloud.google.com/compute/docs/images) for the complete guide.
+### From Source Repository
+Occasionally you may want to install the latest commits to the [repository](https://github.com/GoogleCloudPlatform/compute-image-packages/) even if they have not been released. This is not recommended unless there is a change that you specifically need and cannot wait for. To do this:
+
+1. Log in to your target machine.
+1. Clone the repository with
+
+ git clone https://github.com/GoogleCloudPlatform/compute-image-packages.git
+
+1. Copy the google-daemon and google-startup-scripts files to your root directory with
+
+ sudo cp -R compute-image-packages/{google-daemon/{etc,user},google-startup-scripts/{etc,usr,lib}} /
+
+1. Configure the packages to run on startup with (Debian)
+
+ sudo update-rc.d google-starup-scripts defaults && sudo update-rc.d google-accounts-manager defaults && sudo update-rc.d google-address-manager defaults && sudo update-rc.d google-clock-sync-manager defaults
+
+ or (Redhat)
+
+ sudo chkconfig --add google-startup-scripts && sudo chkconfig --add google-accounts-manager && sudo chkconfig --add google-address-manager && sudo chkconfig --add google-clock-sync-manager
+
+1. Either restart so the packages run or start them with (Debian and Redhat)
+
+ sudo service google-accounts-manager restart && sudo service google-address-manager restart && sudo service google-clock-sync-manager restart
+
+1. Install gcimagebundle with
+
+ cd compute-image-packages/gcimagebundle && sudo python setup.py install
+
## Source Code
This repository is structured so that each package is located in its own top-level directory. [`google-startup-scripts`](google-startup-scripts/) and [`google-daemon`](google-daemon/) are stored as the directory structure of where the files would be from root. [`image-bundle`](image-bundle/) has no directory structure.