Described how to translating/publishing CloudStack docs and how to build from codes.

1. Apache CloudStack
How to contribution
- Translating/Building -
NetOneSystems Co., Ltd
Go Chiba

2.  Go Chiba
– NetOneSystems CloudSoftware Team
(IaaS, Monitoring, Management, SDN etc...)
– Apache CloudStack Japanse Translator
Translating ACS docs on private
And not publisher of this book…
– Contact
mailto: go.chiba@gmail.com
Twitter: @go_chiba
Introduction

3. Translating

4.  Apache CloudStack have below projects for translating
– Document tranlating(Apache CloudStack Docs)
– GUI translating(Apache CloudStack UI)
– Runbook(Quick Install Guide) translating
(Apache CloudStack Runbook)
Target

5.  Translating w/ Transifex(https://www.transifex.com)
Display
sections
Source
document
Translated
document
Recommen
ded
document
Transifex

6.  Check your translating with Publican
(Confirmed on CentOS 6.3)
1. Install requred tools
2. Clone source code from repository
3. Install common contents(e.g. images)
# yum install git rpm-build python-setuptools publican
# easy_install transifex-client
# git clone
https://git-wip-us.apache.org/repos/asf/cloudstack.git
# cd cloudstack/docs/publican-cloudstack
# ./gen_rpm.sh
# rpm –i ~/rpmbuild/RPMS/noarch/publican-cloudstack-0.6-
1.el6.noarch.rpm
Publishing document

7. Publishing document
4. Setting transifex client and pull po files
5. Rename directory(only Japanse)
6. Running publican
Config files: all, adminguide, devguide, installation, niciranvp,
release-note
Format : html, html-single, pdf, epub
# cd cloudstack/docs
# tx init
# ./settx.sh
# tx pull –l ja_JP
# mv ja_JP ja-JP
# publican build --config=publican-all.cfg
--formats=html,pdf --langs=ja-JP

8. 7. Check doc book
# ls tmp/ja-JP/*
Also check sebastien's
presentation
http://
www.slideshare.net/seba
stiengoasguen/how-to-tr
anslate-apache-cloudsta
ck-docs
Publishing document

9.  You can report document bugs on JIRA like a code bugs
 We wellcome your reviewing even if it's typos :)
– Wrong port number、Miss spells etc…
Document bugs

10. Building

11. 1. Install related packages
2. Install maven binaries and configure
# yum install git java-1.6.0-openjdk java-1.6.0-openjdk-
devel mysql mysql-server tomcat6 mkisofs gcc python MySQL-
python python-setuptools
# wget http://www.us.apache.org/dist/maven/maven-
3/3.0.5/binaries/apache-maven-3.0.5-bin.tar.gz
# cd /usr/local/
# tar -zxvf apache-maven-3.0.5-bin.tar.gz
# echo export M2_HOME=/usr/local/apache-maven-3.0.5 >>
~/.bashrc # echo export PATH=${M2_HOME}/bin:${PATH} >>
~/.bashrc
Preparation

12. Preparation
3. Start MySQL service
4. Clone ClousStack repository(pull it if requred)
# service mysqld start
# git clone http://git-wip-
us.apache.org/repos/asf/cloudstack.git
# git pull origin master

13. Building CloudStack
1. Checking dependancies
2. Clean and buildeing
3. Deploy sql scheme
4. Running management server
When you modify codes, building again and check
behavior after running management server
# mvn clean install -P systemvm,developer
# mvn -P developer -pl developer -Ddeploydb
# mvn -pl :cloud-client-ui jetty:run
# mvn –P deps

14. Packaging(rpm)
1. Insall rpm-build
2. Checking dependancies
3. Running packaging script
4. Confirm generated rpms
# yum install rpm-build
# mvn –P deps
# cd package/centos63
# ./package.sh
# ls dist/rpmbuild/RPMS/x86_64/
cloudstack-agent-4.1.0-SNAPSHOT.el6.x86_64.rpm ……

15. 1. Install dpkg-dev and maven
2. Checking dependancies
3. Generate deb packages
Recommend to install maven from apt on debian/unbungu
# apt-get install dpkg-dev maven
# mvn –P deps
# cd package/debian
# dpkg-buildpackage
Packaging(deb)

16. Future scedules
 Road to CloudStack 4.2 Release
https://cwiki.apache.org/confluence/display/CLOUDSTACK/Cloudstack+4.2+Release
 Japanse User group planning doc sprint on June/July
– Target
Interesting but well known about translating... :(
I'd like to contributing but not good code writer... :(
May 31 Merge new feature to master, Release branch
will be cut
June 1 Test/Bugfix, Doc Finalization
June 30 Docs Completion, Release branch moves to
limited update
July /1-30 Translation and Integration docs
Final regression testing / bug fixes / doc fixes
July 22 RC created, VOTE is called

17. At last...

18. CloudStack Collaboration
Conference ‘13