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)