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)