summaryrefslogtreecommitdiffstats
path: root/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL44
1 files changed, 30 insertions, 14 deletions
diff --git a/INSTALL b/INSTALL
index d5b86b44..ad0de57d 100644
--- a/INSTALL
+++ b/INSTALL
@@ -26,30 +26,44 @@ See link:http://jenkins.debian.net/userContent/about.html["about jenkins.debian.
==== Jenkins plugins
+* Jenkins GIT plugin
* Jenkins Subversion Plug-in
-* SCM Sync Configuration Plugin
+
+* Log Parser Plugin
+* HTML Publisher plugin
* Static Analysis Utilities
+
+* Read-only configurations
+* SCM Sync Configuration Plugin
* Dependency Graph Viewer Plugin
* Nested View Plugin
-* Locale plugin
-* HTML Publisher plugin
-* Jenkins GIT plugin
* View Job Filters
-* Read-only configurations
+
* Sidebar Link
* Green Balls
-* Log Parser Plugin
-* Jenkins Translation Assistance plugin
* Compact Columns
* Simple Theme Plugin
+* Locale plugin
+* Jenkins Translation Assistance plugin
-=== updating jenkins.debian.net with update_jdn.sh
+=== updating jenkins.debian.net with 'update_jdn.sh'
-* needed packages are listed in 'update_jdn.sh' and which will also make sure they are installed
-** 'update_jdn.sh' is available in the git repo
-* package configuration is kept in that git repo and deployed by 'update_jdn.sh' as well.
+'update_jdn.sh' is small hackish script which will install all needed packages and copy their configuration in place.
+
+As 'root' run:
+----
+cd
+git clone git://git.debian.org/git/users/holger/jenkins.debian.net.git
+cd jenkins.debian.net
+./update_jdn.sh
+----
+
+'jenkins-job-builder' is the only software which is not covered by this script.
=== Installing jenkins-job-builder
+
+This is the only softwhich which needs manual installation and is not covered by 'update_jdn.sh'
+
* rebuild python-jenkinsapi from sid for wheezy:
* `pip install python-jenkins`
* `git clone https://github.com/openstack-ci/jenkins-job-builder ; cd jenkins-job-builder ; python setup.py install`
@@ -57,8 +71,10 @@ See link:http://jenkins.debian.net/userContent/about.html["about jenkins.debian.
=== Using jenkins-job-builder
-* then run `cd /srv/jenkins/job-cfg ; jenkins-jobs update .` to update jobs
-* testing: `cd /srv/jenkins/job-cfg ; rm test-output/ -r ; mkdir test-output ; jenkins-jobs test . -o test-output/ ; ls test-output/`
+'update_jdn.sh' takes care of this too, so this is just for quick documentation. The real documentation is at link:http://ci.openstack.org/jenkins-job-builder/
+
+* run `cd /srv/jenkins/job-cfg ; jenkins-jobs update .` to update jobs
+* for testing: `cd /srv/jenkins/job-cfg ; rm test-output/ -r ; mkdir test-output ; jenkins-jobs test . -o test-output/ ; ls test-output/`
=== munin
@@ -66,7 +82,7 @@ link://munin-monitoring[Munin] is installed, running with link:http://jenkins.de
=== Backup
-Currently only the configuration is backed up, but neither the jenkins results nor system logs. But it's at least sufficient to re-setup the system if needed.
+Currently only the configuration is backed up, but neither the jenkins results nor system logs. But that's at least sufficient to re-setup the system if needed.
* The _etckeeper_ package is installed and automatically keeps '/etc' in '/etc/.git'.
* The _SCM Sync Configuration Plugin_ is installed in Jenkins, putting all Jenkins configuration into '/srv/jenkins.debian.net-scm-sync.git'.