Re: [gt-user] who maintains the Globus Toolkit documentation?
Has the idea of placing the documentation on a wiki where it could be updated by community members been discussed? Perhaps by users with a Globus Online login? Pete On Wed, Oct 17, 2012 at 10:58 AM, Stuart Martin smar...@mcs.anl.gov wrote: Hi John, Thanks for your thoughts. We'll look to improve the GT doc based on your feedback. http://jira.globus.org/browse/GT-305 Cheers, Stu On Oct 17, 2012, at Oct 17, 8:58 AM, john alexander sanabria ordonez wrote: Hello, I did try to follow the instructions given in the Globus Toolkit documentation web page but I found a couple of gaps that mislead the deployment of basic grid services (simpleCA + gram5 + gridftp), e.g. • The documentation does not mention that the grid-ca-certs package should be installed • The documentation can be more specific about the grid-ca-create command must be run by the globus user • When this command is run by globus user some files (found in ~/.globus/simpleCA) must be copied to the /etc/grid-security directory • The documentation should provide a hint which describes what [YUM and OSG specific] repositories should be installed for setting up a machine where Globus services would be provisioned (https://twiki.grid.iu.edu/bin/view/Documentation/Release3/YumRepositories) I have to thank to Marco Mambelli and Jose Caballero for their hints that allow me to define the correct set of steps for installing those services. Regards, PS: I wrote some Chef recipes which allow to deploy the aforementioned services in a physical or virtual machine
Re: [gt-user] who maintains the Globus Toolkit documentation?
Sounds good. As Vas says, we're looking to make some changes/improvements to the Toolkit web pages. That may be a longer term effort. But, maybe there are some simple, near term changes that can be made to get this going. We'll discuss internally here and let you know our plans. Thanks for the input! -Stu On Oct 19, 2012, at Oct 19, 9:28 AM, Pete Eby wrote: I thinking having the install and quickstart guides in a wiki format would be extremely helpful. The globus user community seems well suited to help maintain this documentation. These guides are very helpful, and allowing them to be updated might help to improve them further. Also, perhaps an additional community wiki page could be created for trouble shooting common issues. There seems to be some top 10 things users encounter frequently, and this might help save them a considerable amount of debug / research time. Pete On Fri, Oct 19, 2012 at 10:22 AM, Stuart Martin smar...@mcs.anl.gov wrote: I like that idea a lot. We use docbook to generate most of the toolkit's web content. We'll have to think through if and where taking on a transition like that would make sense. Maybe there are some GT pages that are best left to be generated via docbook and some that could be changed to become wiki pages. For example, I'm thinking (partially based on the input here) that the install and quick start might be good candidates to be wiki pages. http://www.globus.org/toolkit/docs/latest-stable/admin/install/#gtadmin http://www.globus.org/toolkit/docs/latest-stable/admin/quickstart/#quickstart Maybe this developer guide too? http://www.globus.org/toolkit/docs/5.2/5.2.2/appendices/developer/ Thoughts? -Stu On Oct 19, 2012, at Oct 19, 6:09 AM, Pete Eby wrote: Has the idea of placing the documentation on a wiki where it could be updated by community members been discussed? Perhaps by users with a Globus Online login? Pete On Wed, Oct 17, 2012 at 10:58 AM, Stuart Martin smar...@mcs.anl.gov wrote: Hi John, Thanks for your thoughts. We'll look to improve the GT doc based on your feedback. http://jira.globus.org/browse/GT-305 Cheers, Stu On Oct 17, 2012, at Oct 17, 8:58 AM, john alexander sanabria ordonez wrote: Hello, I did try to follow the instructions given in the Globus Toolkit documentation web page but I found a couple of gaps that mislead the deployment of basic grid services (simpleCA + gram5 + gridftp), e.g. • The documentation does not mention that the grid-ca-certs package should be installed • The documentation can be more specific about the grid-ca-create command must be run by the globus user • When this command is run by globus user some files (found in ~/.globus/simpleCA) must be copied to the /etc/grid-security directory • The documentation should provide a hint which describes what [YUM and OSG specific] repositories should be installed for setting up a machine where Globus services would be provisioned (https://twiki.grid.iu.edu/bin/view/Documentation/Release3/YumRepositories) I have to thank to Marco Mambelli and Jose Caballero for their hints that allow me to define the correct set of steps for installing those services. Regards, PS: I wrote some Chef recipes which allow to deploy the aforementioned services in a physical or virtual machine
Re: [gt-user] who maintains the Globus Toolkit documentation?
Here is a jira for tracking http://jira.globus.org/browse/GT-308 On Oct 19, 2012, at Oct 19, 10:14 AM, Stuart Martin wrote: Sounds good. As Vas says, we're looking to make some changes/improvements to the Toolkit web pages. That may be a longer term effort. But, maybe there are some simple, near term changes that can be made to get this going. We'll discuss internally here and let you know our plans. Thanks for the input! -Stu On Oct 19, 2012, at Oct 19, 9:28 AM, Pete Eby wrote: I thinking having the install and quickstart guides in a wiki format would be extremely helpful. The globus user community seems well suited to help maintain this documentation. These guides are very helpful, and allowing them to be updated might help to improve them further. Also, perhaps an additional community wiki page could be created for trouble shooting common issues. There seems to be some top 10 things users encounter frequently, and this might help save them a considerable amount of debug / research time. Pete On Fri, Oct 19, 2012 at 10:22 AM, Stuart Martin smar...@mcs.anl.gov wrote: I like that idea a lot. We use docbook to generate most of the toolkit's web content. We'll have to think through if and where taking on a transition like that would make sense. Maybe there are some GT pages that are best left to be generated via docbook and some that could be changed to become wiki pages. For example, I'm thinking (partially based on the input here) that the install and quick start might be good candidates to be wiki pages. http://www.globus.org/toolkit/docs/latest-stable/admin/install/#gtadmin http://www.globus.org/toolkit/docs/latest-stable/admin/quickstart/#quickstart Maybe this developer guide too? http://www.globus.org/toolkit/docs/5.2/5.2.2/appendices/developer/ Thoughts? -Stu On Oct 19, 2012, at Oct 19, 6:09 AM, Pete Eby wrote: Has the idea of placing the documentation on a wiki where it could be updated by community members been discussed? Perhaps by users with a Globus Online login? Pete On Wed, Oct 17, 2012 at 10:58 AM, Stuart Martin smar...@mcs.anl.gov wrote: Hi John, Thanks for your thoughts. We'll look to improve the GT doc based on your feedback. http://jira.globus.org/browse/GT-305 Cheers, Stu On Oct 17, 2012, at Oct 17, 8:58 AM, john alexander sanabria ordonez wrote: Hello, I did try to follow the instructions given in the Globus Toolkit documentation web page but I found a couple of gaps that mislead the deployment of basic grid services (simpleCA + gram5 + gridftp), e.g. • The documentation does not mention that the grid-ca-certs package should be installed • The documentation can be more specific about the grid-ca-create command must be run by the globus user • When this command is run by globus user some files (found in ~/.globus/simpleCA) must be copied to the /etc/grid-security directory • The documentation should provide a hint which describes what [YUM and OSG specific] repositories should be installed for setting up a machine where Globus services would be provisioned (https://twiki.grid.iu.edu/bin/view/Documentation/Release3/YumRepositories) I have to thank to Marco Mambelli and Jose Caballero for their hints that allow me to define the correct set of steps for installing those services. Regards, PS: I wrote some Chef recipes which allow to deploy the aforementioned services in a physical or virtual machine
Re: [gt-user] who maintains the Globus Toolkit documentation?
I had a lot of troubles too. Some of them I solved just by trying (a lot), other I ask for help for some researchers (experts) who already installed. So, I have some tricks and details that is necessary and is not mentioned in doc. Surely, I will help. 2012/10/19, Stuart Martin smar...@mcs.anl.gov: Here is a jira for tracking http://jira.globus.org/browse/GT-308 On Oct 19, 2012, at Oct 19, 10:14 AM, Stuart Martin wrote: Sounds good. As Vas says, we're looking to make some changes/improvements to the Toolkit web pages. That may be a longer term effort. But, maybe there are some simple, near term changes that can be made to get this going. We'll discuss internally here and let you know our plans. Thanks for the input! -Stu On Oct 19, 2012, at Oct 19, 9:28 AM, Pete Eby wrote: I thinking having the install and quickstart guides in a wiki format would be extremely helpful. The globus user community seems well suited to help maintain this documentation. These guides are very helpful, and allowing them to be updated might help to improve them further. Also, perhaps an additional community wiki page could be created for trouble shooting common issues. There seems to be some top 10 things users encounter frequently, and this might help save them a considerable amount of debug / research time. Pete On Fri, Oct 19, 2012 at 10:22 AM, Stuart Martin smar...@mcs.anl.gov wrote: I like that idea a lot. We use docbook to generate most of the toolkit's web content. We'll have to think through if and where taking on a transition like that would make sense. Maybe there are some GT pages that are best left to be generated via docbook and some that could be changed to become wiki pages. For example, I'm thinking (partially based on the input here) that the install and quick start might be good candidates to be wiki pages. http://www.globus.org/toolkit/docs/latest-stable/admin/install/#gtadmin http://www.globus.org/toolkit/docs/latest-stable/admin/quickstart/#quickstart Maybe this developer guide too? http://www.globus.org/toolkit/docs/5.2/5.2.2/appendices/developer/ Thoughts? -Stu On Oct 19, 2012, at Oct 19, 6:09 AM, Pete Eby wrote: Has the idea of placing the documentation on a wiki where it could be updated by community members been discussed? Perhaps by users with a Globus Online login? Pete On Wed, Oct 17, 2012 at 10:58 AM, Stuart Martin smar...@mcs.anl.gov wrote: Hi John, Thanks for your thoughts. We'll look to improve the GT doc based on your feedback. http://jira.globus.org/browse/GT-305 Cheers, Stu On Oct 17, 2012, at Oct 17, 8:58 AM, john alexander sanabria ordonez wrote: Hello, I did try to follow the instructions given in the Globus Toolkit documentation web page but I found a couple of gaps that mislead the deployment of basic grid services (simpleCA + gram5 + gridftp), e.g. • The documentation does not mention that the grid-ca-certs package should be installed • The documentation can be more specific about the grid-ca-create command must be run by the globus user • When this command is run by globus user some files (found in ~/.globus/simpleCA) must be copied to the /etc/grid-security directory • The documentation should provide a hint which describes what [YUM and OSG specific] repositories should be installed for setting up a machine where Globus services would be provisioned (https://twiki.grid.iu.edu/bin/view/Documentation/Release3/YumRepositories) I have to thank to Marco Mambelli and Jose Caballero for their hints that allow me to define the correct set of steps for installing those services. Regards, PS: I wrote some Chef recipes which allow to deploy the aforementioned services in a physical or virtual machine
Re: [gt-user] who maintains the Globus Toolkit documentation?
Hi John, Thanks for your thoughts. We'll look to improve the GT doc based on your feedback. http://jira.globus.org/browse/GT-305 Cheers, Stu On Oct 17, 2012, at Oct 17, 8:58 AM, john alexander sanabria ordonez wrote: Hello, I did try to follow the instructions given in the Globus Toolkit documentation web page but I found a couple of gaps that mislead the deployment of basic grid services (simpleCA + gram5 + gridftp), e.g. • The documentation does not mention that the grid-ca-certs package should be installed • The documentation can be more specific about the grid-ca-create command must be run by the globus user • When this command is run by globus user some files (found in ~/.globus/simpleCA) must be copied to the /etc/grid-security directory • The documentation should provide a hint which describes what [YUM and OSG specific] repositories should be installed for setting up a machine where Globus services would be provisioned (https://twiki.grid.iu.edu/bin/view/Documentation/Release3/YumRepositories) I have to thank to Marco Mambelli and Jose Caballero for their hints that allow me to define the correct set of steps for installing those services. Regards, PS: I wrote some Chef recipes which allow to deploy the aforementioned services in a physical or virtual machine
Re: [gt-user] who maintains the Globus Toolkit documentation?
Hi Stu, I don't know how feasible this is, but I have found the best way to get accurate documentation is to hand your final draft to an average expected audience member, and then look over their shoulder while they go through it, taking notes on what trips them up. It really brings to light the omissions and incorrect steps, and makes for a much better final product. I just went through a similar process instructing student workers on how to use PuTTY to port forward into their private virtual CentOS machines, and how to log in and perform some basic CLI steps. Melvin From: smar...@mcs.anl.gov Date: Wed, 17 Oct 2012 09:58:29 -0500 To: john.sanab...@correounivalle.edu.co CC: gt-user@lists.globus.org Subject: Re: [gt-user] who maintains the Globus Toolkit documentation? Hi John, Thanks for your thoughts. We'll look to improve the GT doc based on your feedback. http://jira.globus.org/browse/GT-305 Cheers, Stu On Oct 17, 2012, at Oct 17, 8:58 AM, john alexander sanabria ordonez wrote: Hello, I did try to follow the instructions given in the Globus Toolkit documentation web page but I found a couple of gaps that mislead the deployment of basic grid services (simpleCA + gram5 + gridftp), e.g. • The documentation does not mention that the grid-ca-certs package should be installed • The documentation can be more specific about the grid-ca-create command must be run by the globus user • When this command is run by globus user some files (found in ~/.globus/simpleCA) must be copied to the /etc/grid-security directory • The documentation should provide a hint which describes what [YUM and OSG specific] repositories should be installed for setting up a machine where Globus services would be provisioned (https://twiki.grid.iu.edu/bin/view/Documentation/Release3/YumRepositories) I have to thank to Marco Mambelli and Jose Caballero for their hints that allow me to define the correct set of steps for installing those services. Regards, PS: I wrote some Chef recipes which allow to deploy the aforementioned services in a physical or virtual machine