fixing readme
This commit is contained in:
parent
f8d53fb6e2
commit
8cf7963edb
68
README.md
68
README.md
|
@ -1,7 +1,67 @@
|
|||
puppet-jira
|
||||
===========
|
||||
# puppet-jira
|
||||
Puppet module authored by Bryce Johnson
|
||||
|
||||
Atlassian JIRA Puppet Module
|
||||
## Introduction
|
||||
|
||||
puppet-jira is a module for Atlassian's Enterprise Issue Tracking and
|
||||
project management tool.
|
||||
|
||||
## Requirements
|
||||
|
||||
### Operating System
|
||||
* MacOS: UNSUPPORTED
|
||||
* Linux: RedHat (Debian untested)
|
||||
* Windows: UNSUPPORTED
|
||||
### Databases
|
||||
* Postgres
|
||||
* MySQL
|
||||
|
||||
### Package Requirements
|
||||
|
||||
* Puppet 2.7.x
|
||||
|
||||
* hiera and hiera-puppet
|
||||
This puppet module heavily uses hiera-puppet to decouple configuration
|
||||
information from the module itself. An example is given in jira.yaml
|
||||
that you can use to construct your own jira hieradata information. Params.pp
|
||||
is still used since some resource types can't call hiera directly, like file.
|
||||
|
||||
* git 1.7.6+ (this module doesn't check, at least yet, just make sure git
|
||||
is installed)
|
||||
|
||||
* open JDK 1.6 (Don't use 1.7 yet), prefer update 33+
|
||||
|
||||
### Before you begin
|
||||
It is your responsibility to backup your database. Especially do so
|
||||
if you are installing to an existing installation of jira as this module
|
||||
is UNTESTED from with an existing install of jira
|
||||
|
||||
You must have your database setup with the account user that the application
|
||||
will use. This information needs to be put in the hiera yaml, for example
|
||||
jira.yaml, in your hieradata directory.
|
||||
|
||||
Make sure you have a JAVA_HOME and appropriate java installed on your machine.
|
||||
Recommended is JDK 1.6u33
|
||||
|
||||
Did I mention if you are upgrading, BACKUP your database first? This module
|
||||
makes no warranty on your data, per its license.
|
||||
|
||||
### Installation
|
||||
|
||||
This puppet module will be downloading the jira zip, extract it into
|
||||
/opt/jira/atlassian-jira-$version
|
||||
|
||||
A service will also be created for you with chkconfig configured to be on
|
||||
so that jira will start up automatically on system start.
|
||||
|
||||
You will also need to enter in the directory to your jira-home, which should
|
||||
also be kept in the hiera yaml, for example jira.yaml.
|
||||
|
||||
Once you have installed the yaml information, then run puppet apply with
|
||||
this module included in the modulepath.
|
||||
|
||||
*** Fixes and Future Work
|
||||
Please feel free to raise any issues here for fixes. I'm happy to fix them
|
||||
up. Also feel free to make a pull request for anything so I can hopefully
|
||||
get it in.
|
||||
|
||||
UNTESTED...DO NOT USE...I am not ready for you master.
|
Loading…
Reference in New Issue