[jira] [Created] (STRATOS-1055) [Wiki] - Improvements needed in the Puppet Master docs

["Mariangela Hills (JIRA)" <ji...@apache.org>]

Mariangela Hills created STRATOS-1055:
-----------------------------------------

             Summary: [Wiki] - Improvements needed in the Puppet Master docs
                 Key: STRATOS-1055
                 URL: https://issues.apache.org/jira/browse/STRATOS-1055
             Project: Stratos
          Issue Type: Improvement
          Components: Documentation
    Affects Versions: 4.1.0 M4
            Reporter: Mariangela Hills
            Assignee: Mariangela Hills


The answers mentioned for the following issues need to be documented to improve the Puppet Master documentation. 

------------------------------------------------------------------------------------------------
Questions:
Bug #4  - Setup blocker 

Unfortunately, the setup process doesn't work very well, and I hit a major blocker.  the git repo [1] does not contain a python distribution zip (apache-stratos-python-cartridge-agent-4.1.0-SNAPSHOT.zip) , and the documentation predicates a distribution existing [2]

"13. Copy the Python Cartridge Agent distribution (apache-stratos-python-cartridge-agent-4.1.0-SNAPSHOT.zip), which is in the <STRATOS_HOME>/products/python-cartridge-agent/target/ directory, to the /etc/puppet/modules/python_agent/files/ directory.
"

Please tell the elves how to fix?


[1] https://github.com/apache/stratos/tree/master/products/python-cartridge-agent
[2] https://cwiki.apache.org/confluence/display/STRATOS/4.1.0-M4+Configuring+Puppet+Master


Additional documentation glitches include the following:

UG #1
https://cwiki.apache.org/confluence/display/STRATOS/4.1.0-M4+Configuring+Puppet+Master

"Install Puppet Master (v3) as follows:

    Execute the following command. When you execute this command, your system hostname will get modified.
    ./puppetinstall -m -d <PUPPETMASTER-DOMAIN> -s <PUPPET-MASTER-IP>
"

?? docs don't explain PUPPETMASTER-domain and puppet-master-ip


BUG #2
https://cwiki.apache.org/confluence/display/STRATOS/4.1.0-M4+Configuring+Puppet+Master

"Change the variables in the nodes.pp file accordingly.
vi /etc/puppet/manifests/nodes/
base.pp
"

??? what does 'change accordingly' mean?


?? the example has 10.4.128.12 address parameters.  how do the parameters map to reader IP addresses?  should the reader use 127.0.0.1 or a local IP address?

BUG #3
https://cwiki.apache.org/confluence/display/STRATOS/4.1.0-M4+Configuring+Puppet+Master

Download the Java distribution to the /etc/puppet/modules/java/files/ directory. Define the Java distribution name and the unzipped folder name in the  base.pp file, which is in the /etc/puppet/manifests/nodes directory, and save the file.

? should I just apt-get a java distribution?
------------------------------------------------------------------------------------------------
Answers:
Bug#4
You have to build the python agent to get the zip.
Do a "mvn clean install" from <STRATOS_HOME>/products/python-cartridge-agent directory. Then you will get the
apache-stratos-python-cartridge-agent-4.1.0-SNAPSHOT.zip inside target directory.

Bug#1
Installing puppet master is documented here https://github.com/thilinapiy/puppetinstall

Bug#2
You have to update /etc/puppet/manifests/nodes/base.pp according to your setup. For example, you have to update $mb_ip/$cep_ip  according to your setup.

#following directory is used to store binary packages
$local_package_dir    = '/mnt/packs'
# Stratos message broker IP and port
$mb_ip                = 'YOUR_MB_IP'
$mb_port              = 'YOUR_MB_PORT'
$mb_type              = 'activemq'
# Stratos CEP IP and port
$cep_ip               = 'YOUR_CEP_IP'
$cep_port             = 'YOUR_CEP_PORT'
# Stratos Cartridge Agent’s trust store password
$truststore_password  = 'wso2carbon'

But I guess this base.pp is updated. Instead of $mb_ip and $mb_port, you have to give $mb_url ($mb_url	= 'tcp://127.0.0.1:1883').

Bug#3
You have to download a java distribution, say jdk-7u7-linux-x64.tar.gz, and copy this inside /etc/puppet/modules/java/files/ directory.
Then you need to update the /etc/puppet/manifests/nodes/base.pp according to your java distribution version.

$java_distribution  = 'jdk-7u7-linux-x64.tar.gz'
$java_name          = 'jdk1.7.0_07'

Here $java_distribution is the downloaded java distribution name and $java_name is the the name of the unzipped java distribution.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)