There are too many documentation sites and not enough attention paid to
the main doc set.
I agree that they ramble around; Topics are thrown in out of place; Some
sections in the install are just noise, they have no actions described
in them.
There is no clear description of the network setup and that is key to
getting it to work.
I have not been able to install it yet and have it work.
I keep waiting for a doc set that is actually correct.
I read the docs and write JIRAs when I can understand enough to describe
where it is screwed up.
I have done Unix and Linux system administration for 20 years (CentOS
for the last 10) and for 20 years before that ran DEC-10 and VAX sites.
I do not have a lot of time to spend on this at the moment but it should
be something that should be easy to set up in a few hours.
I don't want to run and administer CloudStack, I want to use CloudStack
to manage a cloud where I can get my apps up and running more easily on
virtual machines.
This should not be as hard to install as it appears to be.
Ron
On 15/08/2013 1:22 PM, Tracy Phillips wrote:
Ron,
As a new user to CloudStack, I couldn't agree with you more.
One thing that would help with a CloudStack install is instructions on
setting up the nodes that will host the VM's first... then go into
setting up the managment server.
As it is right now, you follow along and getting into the GUI "Wizard"
<http://cloudstack.apache.org/docs/en-US/Apache_CloudStack/4.1.1/html/Installation_Guide/management-server-install-flow.html> (the
very next step tells you to login to the GUID) before you realize that
you need to add a node to connect to first.
And while we are at it... there is documentation everywhere...
http://cloudstack.apache.org/docs/en-US/index.html
https://cwiki.apache.org/confluence/display/CLOUDSTACK/Home
https://cwiki.apache.org/CLOUDSTACK/ <-- this should be removed.
Coming from OpenStack, the docs here are a mess, its like they ramble
around what is trying to be said.
Just my .02 out of frustration.
Tracy
On Thu, Aug 15, 2013 at 9:07 AM, Ron Wheeler
<rwhee...@artifact-software.com
<mailto:rwhee...@artifact-software.com>> wrote:
I have 7 unresolved bug issues about the installguide.
Only 1 of the issues reported have been fixed.
I have added 3 more and I am sure that there are any more just in
Section 4 of the install guide.
The docs need a lot of work and are probably no where near ready
for release.
There needs to a test suite for docs. At least a walkthrough of
the installation to see if it actually works.
Ron
On 15/08/2013 2:53 AM, Prasanna Santhanam wrote:
Hi All,
The docs (installguide, adminguide, release notes) leading up
to the
Apache CloudStack 4.2 release will keep building on jenkins
[1] [2]
[3] as they are written/fixed/corrected. Please review them to
help
fix doc errors. Our tech writing team is very busy working towards
bettering our docs and will be happy to recieve bug reports
[4]. You
should already have recieved notifications of docs added for new
features. Let us know what you think either via JIRA or an
email to
the dev@ list.
If you would like to contribute to the doc writing, make sure
to visit
the compiled wikis written up by Jessica and Radhika:
https://cwiki.apache.org/confluence/x/hQLMAQ
[1] http://jenkins.buildacloud.org/job/docs-4.2-adminguide/
[2] http://jenkins.buildacloud.org/job/docs-4.2-installguide/
[3] http://jenkins.buildacloud.org/job/docs-4.2-releasenotes/
[4] https://cwiki.apache.org/confluence/x/vRvVAQ
Thanks,
--
Ron Wheeler
President
Artifact Software Inc
email: rwhee...@artifact-software.com
<mailto:rwhee...@artifact-software.com>
skype: ronaldmwheeler
phone: 866-970-2435, ext 102 <tel:866-970-2435%2C%20ext%20102>
--
Ron Wheeler
President
Artifact Software Inc
email: rwhee...@artifact-software.com
skype: ronaldmwheeler
phone: 866-970-2435, ext 102
