You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cloudstack.apache.org by Radhika PC <ra...@citrix.com> on 2012/10/18 09:09:59 UTC
Review Request: Troubleshooting section in the Install Guide
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/7645/
-----------------------------------------------------------
Review request for cloudstack, David Nalley, Chip Childers, Jessica Tomechak, and Wido den Hollander.
Description
-------
Troubleshooting section in the Install Guide
Diffs
-----
docs/en-US/binary-log-error.xml PRE-CREATION
docs/en-US/cannot-add-hosts.xml PRE-CREATION
docs/en-US/check-log-files.xml PRE-CREATION
docs/en-US/console-proxy-vm-issues.xml PRE-CREATION
docs/en-US/database-checklists.xml PRE-CREATION
docs/en-US/mgmt-server-checklists.xml PRE-CREATION
docs/en-US/preparation-checklists.xml PRE-CREATION
docs/en-US/run-diagnostic-script.xml PRE-CREATION
docs/en-US/storage-checklists.xml PRE-CREATION
docs/en-US/troubleshoot-awsapi.xml PRE-CREATION
docs/en-US/troubleshoot-install.xml PRE-CREATION
docs/en-US/troubleshoot-ms-log.xml PRE-CREATION
docs/en-US/troubleshooting-ssvm.xml PRE-CREATION
docs/en-US/vlan-issues.xml PRE-CREATION
Diff: https://reviews.apache.org/r/7645/diff/
Testing
-------
patch cleanly applies
Thanks,
Radhika PC
Re: Review Request: Troubleshooting section in the Install Guide
Posted by Kristoffer Sheather - Cloud Central <kr...@cloudcentral.com.au>.
Ceph is also supported now as a storage option for KVM installations. The section needs a re-write.
On 20/10/2012, at 11:21, "Jessica Tomechak" <je...@gmail.com> wrote:
>
>
>> On Oct. 18, 2012, 11:07 a.m., David Nalley wrote:
>>> docs/en-US/storage-checklists.xml, line 36
>>> <https://reviews.apache.org/r/7645/diff/1/?file=177809#file177809line36>
>>>
>>> There are far more options than this for storage - is there a reason we have limited it to these two?
>>
>> Radhika PC wrote:
>> investigating
>
> Is our entire "Working with Storage" section out of date? It says "CloudStack defines two types of storage: primary and secondary. Primary storage can be accessed by
> either iSCSI or NFS. Additionally, direct attached storage may be used for primary storage. Secondary
> storage is always accessed using NFS." However, OpenStack Object Storage (Swift) is one additional option I'm aware of for secondary storage. VMFS and Fiber Channel are also mentioned for primary storage elsewhere in the doc. I don't think our docs talk about any other options. Are there additional options in the open-source CloudStack that need to be added to the open-source docs? This is worth opening a doc bug for, if we need to update those Storage sections.
>
>
> - Jessica
>
>
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://reviews.apache.org/r/7645/#review12562
> -----------------------------------------------------------
>
>
> On Oct. 18, 2012, 7:09 a.m., Radhika PC wrote:
>>
>> -----------------------------------------------------------
>> This is an automatically generated e-mail. To reply, visit:
>> https://reviews.apache.org/r/7645/
>> -----------------------------------------------------------
>>
>> (Updated Oct. 18, 2012, 7:09 a.m.)
>>
>>
>> Review request for cloudstack, David Nalley, Chip Childers, Jessica Tomechak, and Wido den Hollander.
>>
>>
>> Description
>> -------
>>
>> Troubleshooting section in the Install Guide
>>
>>
>> Diffs
>> -----
>>
>> docs/en-US/binary-log-error.xml PRE-CREATION
>> docs/en-US/cannot-add-hosts.xml PRE-CREATION
>> docs/en-US/check-log-files.xml PRE-CREATION
>> docs/en-US/console-proxy-vm-issues.xml PRE-CREATION
>> docs/en-US/database-checklists.xml PRE-CREATION
>> docs/en-US/mgmt-server-checklists.xml PRE-CREATION
>> docs/en-US/preparation-checklists.xml PRE-CREATION
>> docs/en-US/run-diagnostic-script.xml PRE-CREATION
>> docs/en-US/storage-checklists.xml PRE-CREATION
>> docs/en-US/troubleshoot-awsapi.xml PRE-CREATION
>> docs/en-US/troubleshoot-install.xml PRE-CREATION
>> docs/en-US/troubleshoot-ms-log.xml PRE-CREATION
>> docs/en-US/troubleshooting-ssvm.xml PRE-CREATION
>> docs/en-US/vlan-issues.xml PRE-CREATION
>>
>> Diff: https://reviews.apache.org/r/7645/diff/
>>
>>
>> Testing
>> -------
>>
>> patch cleanly applies
>>
>>
>> Thanks,
>>
>> Radhika PC
>>
>>
>
Re: Review Request: Troubleshooting section in the Install Guide
Posted by Jessica Tomechak <je...@gmail.com>.
> On Oct. 18, 2012, 11:07 a.m., David Nalley wrote:
> > docs/en-US/storage-checklists.xml, line 36
> > <https://reviews.apache.org/r/7645/diff/1/?file=177809#file177809line36>
> >
> > There are far more options than this for storage - is there a reason we have limited it to these two?
>
> Radhika PC wrote:
> investigating
Is our entire "Working with Storage" section out of date? It says "CloudStack defines two types of storage: primary and secondary. Primary storage can be accessed by
either iSCSI or NFS. Additionally, direct attached storage may be used for primary storage. Secondary
storage is always accessed using NFS." However, OpenStack Object Storage (Swift) is one additional option I'm aware of for secondary storage. VMFS and Fiber Channel are also mentioned for primary storage elsewhere in the doc. I don't think our docs talk about any other options. Are there additional options in the open-source CloudStack that need to be added to the open-source docs? This is worth opening a doc bug for, if we need to update those Storage sections.
- Jessica
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/7645/#review12562
-----------------------------------------------------------
On Oct. 18, 2012, 7:09 a.m., Radhika PC wrote:
>
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://reviews.apache.org/r/7645/
> -----------------------------------------------------------
>
> (Updated Oct. 18, 2012, 7:09 a.m.)
>
>
> Review request for cloudstack, David Nalley, Chip Childers, Jessica Tomechak, and Wido den Hollander.
>
>
> Description
> -------
>
> Troubleshooting section in the Install Guide
>
>
> Diffs
> -----
>
> docs/en-US/binary-log-error.xml PRE-CREATION
> docs/en-US/cannot-add-hosts.xml PRE-CREATION
> docs/en-US/check-log-files.xml PRE-CREATION
> docs/en-US/console-proxy-vm-issues.xml PRE-CREATION
> docs/en-US/database-checklists.xml PRE-CREATION
> docs/en-US/mgmt-server-checklists.xml PRE-CREATION
> docs/en-US/preparation-checklists.xml PRE-CREATION
> docs/en-US/run-diagnostic-script.xml PRE-CREATION
> docs/en-US/storage-checklists.xml PRE-CREATION
> docs/en-US/troubleshoot-awsapi.xml PRE-CREATION
> docs/en-US/troubleshoot-install.xml PRE-CREATION
> docs/en-US/troubleshoot-ms-log.xml PRE-CREATION
> docs/en-US/troubleshooting-ssvm.xml PRE-CREATION
> docs/en-US/vlan-issues.xml PRE-CREATION
>
> Diff: https://reviews.apache.org/r/7645/diff/
>
>
> Testing
> -------
>
> patch cleanly applies
>
>
> Thanks,
>
> Radhika PC
>
>
Re: Review Request: Troubleshooting section in the Install Guide
Posted by Radhika PC <ra...@citrix.com>.
> On Oct. 18, 2012, 11:07 a.m., David Nalley wrote:
> > docs/en-US/cannot-add-hosts.xml, line 23
> > <https://reviews.apache.org/r/7645/diff/1/?file=177802#file177802line23>
> >
> > This is factually inaccurate per edison
have sent a mail to Edison about this.
> On Oct. 18, 2012, 11:07 a.m., David Nalley wrote:
> > docs/en-US/database-checklists.xml, line 50
> > <https://reviews.apache.org/r/7645/diff/1/?file=177805#file177805line50>
> >
> > I think you can have both FQDN or IP address - not sure that FQDN is mandatory.
who is the point of contact to confirm ?
> On Oct. 18, 2012, 11:07 a.m., David Nalley wrote:
> > docs/en-US/database-checklists.xml, line 66
> > <https://reviews.apache.org/r/7645/diff/1/?file=177805#file177805line66>
> >
> > 6.2 is no longer a preferred platform and there are others that work as well - consider purging the entire bit
should we be listing the supported platforms here ?
> On Oct. 18, 2012, 11:07 a.m., David Nalley wrote:
> > docs/en-US/mgmt-server-checklists.xml, line 66
> > <https://reviews.apache.org/r/7645/diff/1/?file=177806#file177806line66>
> >
> > 6.2 is no longer a preferred platform - there are also other platforms that work
should we be listing none ?
> On Oct. 18, 2012, 11:07 a.m., David Nalley wrote:
> > docs/en-US/mgmt-server-checklists.xml, line 72
> > <https://reviews.apache.org/r/7645/diff/1/?file=177806#file177806line72>
> >
> > A number of problems here:
> > CloudPlatform sould be &PRODUCT;
> > Also - the ISO is far less helpful as CloudStack now needs packages that aren't available on the first CD.
what is the suggested option ?
> On Oct. 18, 2012, 11:07 a.m., David Nalley wrote:
> > docs/en-US/storage-checklists.xml, line 36
> > <https://reviews.apache.org/r/7645/diff/1/?file=177809#file177809line36>
> >
> > There are far more options than this for storage - is there a reason we have limited it to these two?
investigating
> On Oct. 18, 2012, 11:07 a.m., David Nalley wrote:
> > docs/en-US/troubleshoot-install.xml, line 21
> > <https://reviews.apache.org/r/7645/diff/1/?file=177811#file177811line21>
> >
> > Why is this not a chapter?
will fix
- Radhika
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/7645/#review12562
-----------------------------------------------------------
On Oct. 18, 2012, 7:09 a.m., Radhika PC wrote:
>
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://reviews.apache.org/r/7645/
> -----------------------------------------------------------
>
> (Updated Oct. 18, 2012, 7:09 a.m.)
>
>
> Review request for cloudstack, David Nalley, Chip Childers, Jessica Tomechak, and Wido den Hollander.
>
>
> Description
> -------
>
> Troubleshooting section in the Install Guide
>
>
> Diffs
> -----
>
> docs/en-US/binary-log-error.xml PRE-CREATION
> docs/en-US/cannot-add-hosts.xml PRE-CREATION
> docs/en-US/check-log-files.xml PRE-CREATION
> docs/en-US/console-proxy-vm-issues.xml PRE-CREATION
> docs/en-US/database-checklists.xml PRE-CREATION
> docs/en-US/mgmt-server-checklists.xml PRE-CREATION
> docs/en-US/preparation-checklists.xml PRE-CREATION
> docs/en-US/run-diagnostic-script.xml PRE-CREATION
> docs/en-US/storage-checklists.xml PRE-CREATION
> docs/en-US/troubleshoot-awsapi.xml PRE-CREATION
> docs/en-US/troubleshoot-install.xml PRE-CREATION
> docs/en-US/troubleshoot-ms-log.xml PRE-CREATION
> docs/en-US/troubleshooting-ssvm.xml PRE-CREATION
> docs/en-US/vlan-issues.xml PRE-CREATION
>
> Diff: https://reviews.apache.org/r/7645/diff/
>
>
> Testing
> -------
>
> patch cleanly applies
>
>
> Thanks,
>
> Radhika PC
>
>
Re: Review Request: Troubleshooting section in the Install Guide
Posted by David Nalley <da...@gnsa.us>.
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/7645/#review12562
-----------------------------------------------------------
docs/en-US/cannot-add-hosts.xml
<https://reviews.apache.org/r/7645/#comment26818>
This is factually inaccurate per edison
docs/en-US/database-checklists.xml
<https://reviews.apache.org/r/7645/#comment26819>
I think you can have both FQDN or IP address - not sure that FQDN is mandatory.
docs/en-US/database-checklists.xml
<https://reviews.apache.org/r/7645/#comment26820>
6.2 is no longer a preferred platform and there are others that work as well - consider purging the entire bit
docs/en-US/database-checklists.xml
<https://reviews.apache.org/r/7645/#comment26821>
CloudPlatform should be &PRODUCT;
docs/en-US/mgmt-server-checklists.xml
<https://reviews.apache.org/r/7645/#comment26822>
6.2 is no longer a preferred platform - there are also other platforms that work
docs/en-US/mgmt-server-checklists.xml
<https://reviews.apache.org/r/7645/#comment26823>
A number of problems here:
CloudPlatform sould be &PRODUCT;
Also - the ISO is far less helpful as CloudStack now needs packages that aren't available on the first CD.
docs/en-US/run-diagnostic-script.xml
<https://reviews.apache.org/r/7645/#comment26824>
Consider using <replaceable>link-local-ip</replaceable>
docs/en-US/run-diagnostic-script.xml
<https://reviews.apache.org/r/7645/#comment26825>
Consider using replaceable here as well
docs/en-US/storage-checklists.xml
<https://reviews.apache.org/r/7645/#comment26826>
There are far more options than this for storage - is there a reason we have limited it to these two?
docs/en-US/storage-checklists.xml
<https://reviews.apache.org/r/7645/#comment26828>
NFS is no longer the only options for secondary storage
docs/en-US/storage-checklists.xml
<https://reviews.apache.org/r/7645/#comment26827>
CloudStack should be &PRODUCT;
docs/en-US/troubleshoot-install.xml
<https://reviews.apache.org/r/7645/#comment26829>
Why is this not a chapter?
docs/en-US/troubleshooting-ssvm.xml
<https://reviews.apache.org/r/7645/#comment26830>
Second sentence doesn't seem to fit (actually it isn't a sentence at all, which is probably the problem)
docs/en-US/troubleshooting-ssvm.xml
<https://reviews.apache.org/r/7645/#comment26831>
Second sentence seems misplaced - if this is a list of problems, is it a problem that it contacts dl.c.c?
docs/en-US/vlan-issues.xml
<https://reviews.apache.org/r/7645/#comment26832>
I'd consider using 'hypervisor' instead of host. CloudStack uses the term host to refer to a number of things (see the return on the listHosts API command)
- David Nalley
On Oct. 18, 2012, 7:09 a.m., Radhika PC wrote:
>
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://reviews.apache.org/r/7645/
> -----------------------------------------------------------
>
> (Updated Oct. 18, 2012, 7:09 a.m.)
>
>
> Review request for cloudstack, David Nalley, Chip Childers, Jessica Tomechak, and Wido den Hollander.
>
>
> Description
> -------
>
> Troubleshooting section in the Install Guide
>
>
> Diffs
> -----
>
> docs/en-US/binary-log-error.xml PRE-CREATION
> docs/en-US/cannot-add-hosts.xml PRE-CREATION
> docs/en-US/check-log-files.xml PRE-CREATION
> docs/en-US/console-proxy-vm-issues.xml PRE-CREATION
> docs/en-US/database-checklists.xml PRE-CREATION
> docs/en-US/mgmt-server-checklists.xml PRE-CREATION
> docs/en-US/preparation-checklists.xml PRE-CREATION
> docs/en-US/run-diagnostic-script.xml PRE-CREATION
> docs/en-US/storage-checklists.xml PRE-CREATION
> docs/en-US/troubleshoot-awsapi.xml PRE-CREATION
> docs/en-US/troubleshoot-install.xml PRE-CREATION
> docs/en-US/troubleshoot-ms-log.xml PRE-CREATION
> docs/en-US/troubleshooting-ssvm.xml PRE-CREATION
> docs/en-US/vlan-issues.xml PRE-CREATION
>
> Diff: https://reviews.apache.org/r/7645/diff/
>
>
> Testing
> -------
>
> patch cleanly applies
>
>
> Thanks,
>
> Radhika PC
>
>
Re: Review Request: Troubleshooting section in the Install Guide
Posted by Jessica Tomechak <je...@gmail.com>.
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/7645/#review13030
-----------------------------------------------------------
docs/en-US/database-checklists.xml
<https://reviews.apache.org/r/7645/#comment28043>
This checklist is very old. I think the material might have been originally from Chiradeep, so try asking there.
docs/en-US/troubleshooting-ssvm.xml
<https://reviews.apache.org/r/7645/#comment28048>
Just need to replace the period with a colon. "Sample common problems:" Or, you could make this a bit more writer-ly with "A few common problems include:" or even a simple "For example:"
docs/en-US/troubleshooting-ssvm.xml
<https://reviews.apache.org/r/7645/#comment28045>
Correct. The second sentence should be more like "It needs to contact ..." Also, we should probably remove the reference to download.cloud.com. So maybe "It needs to use HTTP to get the templates from a server."
- Jessica Tomechak
On Oct. 18, 2012, 7:09 a.m., Radhika PC wrote:
>
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://reviews.apache.org/r/7645/
> -----------------------------------------------------------
>
> (Updated Oct. 18, 2012, 7:09 a.m.)
>
>
> Review request for cloudstack, David Nalley, Chip Childers, Jessica Tomechak, and Wido den Hollander.
>
>
> Description
> -------
>
> Troubleshooting section in the Install Guide
>
>
> Diffs
> -----
>
> docs/en-US/binary-log-error.xml PRE-CREATION
> docs/en-US/cannot-add-hosts.xml PRE-CREATION
> docs/en-US/check-log-files.xml PRE-CREATION
> docs/en-US/console-proxy-vm-issues.xml PRE-CREATION
> docs/en-US/database-checklists.xml PRE-CREATION
> docs/en-US/mgmt-server-checklists.xml PRE-CREATION
> docs/en-US/preparation-checklists.xml PRE-CREATION
> docs/en-US/run-diagnostic-script.xml PRE-CREATION
> docs/en-US/storage-checklists.xml PRE-CREATION
> docs/en-US/troubleshoot-awsapi.xml PRE-CREATION
> docs/en-US/troubleshoot-install.xml PRE-CREATION
> docs/en-US/troubleshoot-ms-log.xml PRE-CREATION
> docs/en-US/troubleshooting-ssvm.xml PRE-CREATION
> docs/en-US/vlan-issues.xml PRE-CREATION
>
> Diff: https://reviews.apache.org/r/7645/diff/
>
>
> Testing
> -------
>
> patch cleanly applies
>
>
> Thanks,
>
> Radhika PC
>
>
Re: Review Request: Troubleshooting section in the Install Guide
Posted by Chip Childers <ch...@sungard.com>.
On Tue, Dec 18, 2012 at 4:09 AM, Radhika PC
<ra...@citrix.com> wrote:
>
>
>> On Dec. 18, 2012, 4:06 a.m., Chip Childers wrote:
>> > Jessica and Radhika,
>> >
>> > Is this patch still outstanding? Is it not needed anymore?
>
> Need lot more investigation. So taking time.
>
>
> - Radhika
>
Thanks for all the effort!
Can you close the review out as abandoned, and create a new one when ready?
Re: Review Request: Troubleshooting section in the Install Guide
Posted by Radhika PC <ra...@citrix.com>.
> On Dec. 18, 2012, 4:06 a.m., Chip Childers wrote:
> > Jessica and Radhika,
> >
> > Is this patch still outstanding? Is it not needed anymore?
Need lot more investigation. So taking time.
- Radhika
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/7645/#review14633
-----------------------------------------------------------
On Oct. 18, 2012, 7:09 a.m., Radhika PC wrote:
>
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://reviews.apache.org/r/7645/
> -----------------------------------------------------------
>
> (Updated Oct. 18, 2012, 7:09 a.m.)
>
>
> Review request for cloudstack, David Nalley, Chip Childers, Jessica Tomechak, and Wido den Hollander.
>
>
> Description
> -------
>
> Troubleshooting section in the Install Guide
>
>
> Diffs
> -----
>
> docs/en-US/binary-log-error.xml PRE-CREATION
> docs/en-US/cannot-add-hosts.xml PRE-CREATION
> docs/en-US/check-log-files.xml PRE-CREATION
> docs/en-US/console-proxy-vm-issues.xml PRE-CREATION
> docs/en-US/database-checklists.xml PRE-CREATION
> docs/en-US/mgmt-server-checklists.xml PRE-CREATION
> docs/en-US/preparation-checklists.xml PRE-CREATION
> docs/en-US/run-diagnostic-script.xml PRE-CREATION
> docs/en-US/storage-checklists.xml PRE-CREATION
> docs/en-US/troubleshoot-awsapi.xml PRE-CREATION
> docs/en-US/troubleshoot-install.xml PRE-CREATION
> docs/en-US/troubleshoot-ms-log.xml PRE-CREATION
> docs/en-US/troubleshooting-ssvm.xml PRE-CREATION
> docs/en-US/vlan-issues.xml PRE-CREATION
>
> Diff: https://reviews.apache.org/r/7645/diff/
>
>
> Testing
> -------
>
> patch cleanly applies
>
>
> Thanks,
>
> Radhika PC
>
>
Re: Review Request: Troubleshooting section in the Install Guide
Posted by Chip Childers <ch...@sungard.com>.
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://reviews.apache.org/r/7645/#review14633
-----------------------------------------------------------
Jessica and Radhika,
Is this patch still outstanding? Is it not needed anymore?
- Chip Childers
On Oct. 18, 2012, 7:09 a.m., Radhika PC wrote:
>
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://reviews.apache.org/r/7645/
> -----------------------------------------------------------
>
> (Updated Oct. 18, 2012, 7:09 a.m.)
>
>
> Review request for cloudstack, David Nalley, Chip Childers, Jessica Tomechak, and Wido den Hollander.
>
>
> Description
> -------
>
> Troubleshooting section in the Install Guide
>
>
> Diffs
> -----
>
> docs/en-US/binary-log-error.xml PRE-CREATION
> docs/en-US/cannot-add-hosts.xml PRE-CREATION
> docs/en-US/check-log-files.xml PRE-CREATION
> docs/en-US/console-proxy-vm-issues.xml PRE-CREATION
> docs/en-US/database-checklists.xml PRE-CREATION
> docs/en-US/mgmt-server-checklists.xml PRE-CREATION
> docs/en-US/preparation-checklists.xml PRE-CREATION
> docs/en-US/run-diagnostic-script.xml PRE-CREATION
> docs/en-US/storage-checklists.xml PRE-CREATION
> docs/en-US/troubleshoot-awsapi.xml PRE-CREATION
> docs/en-US/troubleshoot-install.xml PRE-CREATION
> docs/en-US/troubleshoot-ms-log.xml PRE-CREATION
> docs/en-US/troubleshooting-ssvm.xml PRE-CREATION
> docs/en-US/vlan-issues.xml PRE-CREATION
>
> Diff: https://reviews.apache.org/r/7645/diff/
>
>
> Testing
> -------
>
> patch cleanly applies
>
>
> Thanks,
>
> Radhika PC
>
>