Author: mcaspers Date: 2011-02-02 22:25:40 -0500 (Wed, 02 Feb 2011) New Revision: 28949 Modified: trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/Book_Info.xml trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/add_and_manage_server_keys-task.xml trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/using_the_deltacloud_perspective-task.xml Log: General Documentation Updates Modified: trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/Book_Info.xml =================================================================== --- trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/Book_Info.xml 2011-02-03 01:22:51 UTC (rev 28948) +++ trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/Book_Info.xml 2011-02-03 03:25:40 UTC (rev 28949) @@ -9,7 +9,7 @@ <productname>JBoss Developer Studio</productname> <productnumber>4.0</productnumber> <edition>1</edition> - <pubsnumber>10</pubsnumber> + <pubsnumber>11</pubsnumber> <abstract> <para> The Cloud Tools Reference Guide provides documentation of the tools used to interact with your cloud computing instances, including the Deltacloud API. Modified: trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/add_and_manage_server_keys-task.xml =================================================================== --- trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/add_and_manage_server_keys-task.xml 2011-02-03 01:22:51 UTC (rev 28948) +++ trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/add_and_manage_server_keys-task.xml 2011-02-03 03:25:40 UTC (rev 28949) @@ -9,7 +9,16 @@ To access Deltacloud servers, key file authentication is used. Each key represents the person accessing the server and informs the server of their authorization level (a person may have several keys). </para> <para> - Each unique user requires an individual key file and each file must be specified in the SSH2 private keys list prior to performing the ssh connection. To access the SSH2 private keys list navigate to <menuchoice> + Each unique user requires an prive key. These keys can be generated by Deltacloud Tools when launching an instance (see <xref linkend="sect-Cloud_Tools_Reference_Guide-Tasks-using_the_deltacloud_perspective"/>), using a number of external tools, or provided by a service such as Amazon EC2. Each private key must then be specified in the SSH2 private keys list prior to performing the ssh connection. + </para> + + <note> + <title>Tip</title> + <para>New keys generated by Deltacloud Tools when launching an instance are automatically added to the SSH2 private keys list.</para> + </note> + + <para> + To access the SSH2 private keys list navigate to <menuchoice> <guimenuitem>Window</guimenuitem> <guimenuitem>Preferences</guimenuitem> <guimenuitem>General</guimenuitem> @@ -25,11 +34,7 @@ </imageobject> </mediaobject> </figure> - <para> - Keys are also imported when launching a new instance. Refer to <xref linkend="sect-Cloud_Tools_Reference_Guide-Tasks-using_the_deltacloud_perspective"/> for more information. - </para> - </section> Modified: trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/using_the_deltacloud_perspective-task.xml =================================================================== --- trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/using_the_deltacloud_perspective-task.xml 2011-02-03 01:22:51 UTC (rev 28948) +++ trunk/deltacloud/docs/Cloud_Tools_Reference_Guide/en-US/using_the_deltacloud_perspective-task.xml 2011-02-03 03:25:40 UTC (rev 28949) @@ -12,11 +12,11 @@ <title>The Cloud Viewer</title> <para> - The <guilabel>Cloud Viewer</guilabel> view lists the servers you are connected to, the instances running on each server and the images available on each server. Right-clicking (or control-clicking on Mac OS) on a cloud connection presents you with options to delete a cloud using the <guimenuitem>Delete Cloud</guimenuitem> option or reload the the cloud view with the <guimenuitem>Refresh View</guimenuitem> option. + The <guilabel>Cloud Viewer</guilabel> view lists the servers you are connected to, the instances running on each server and the images available on each server. Right-clicking (or control-clicking on Mac OS) on a cloud connection presents you with options to delete a cloud using the <guimenuitem>Delete Cloud</guimenuitem> option or reload the the cloud view with the <guimenuitem>Refresh View</guimenuitem> option. </para> <para> - You can also right-click (or control-click on Mac OS) anywhere in the <guilabel>Cloud Viewer</guilabel> view and select the <guilabel>Launch Instance</guilabel> option to launch a new instance. See <xref linkend="theimagesview"/> for more information on lanching an instance. + You can also right-click (or control-click on Mac OS) anywhere in the <guilabel>Cloud Viewer</guilabel> view and select the <guilabel>Launch Instance</guilabel> option to launch a new instance. See <xref linkend="theimagesview"/> for more information on lanching an instance. </para> <para> @@ -58,8 +58,8 @@ User authentication keys are managed for Deltacloud tooling by the <guilabel>Manage Keys</guilabel> dialog. When clicking on the <guibutton>Manage</guibutton> you will be presented with this dialog. Select one from the list or add a new one by clicking the <guibutton>New</guibutton> button. Newly created keys will also be added to the SSH2 key list if they are not already present. </para> <para> - Click <guibutton>Finish</guibutton> to create the new instance. - </para> + Click the <guibutton>Next</guibutton> button to move to the next step. + </para> <figure id="deltacloud_perspective-launching_an_instance"> <title>Deltacloud perspective: Launching an instance</title> <mediaobject> @@ -68,6 +68,28 @@ </imageobject> </mediaobject> </figure> + + <para> + The next wizard page allows you to explicitily create an Eclipse Remote System Explorer (RSE), which is used to browse the remote filesystem and connect to the instance via an SSH terminal. + </para> + + <para> + You can also create a Web Tools Platform (WTP) server adapter, which will allow you to deploy any WTP compliant web project to the remote instance. + </para> + + <para> + Click the <guibutton>Finish</guibutton> button to launch the new instance and any RSE Connections or WTP Adapters that you have defined. + </para> + + <figure id="deltacloud_perspective-launching_an_instance2"> + <title>Deltacloud perspective: Defining an RSE Connection and a WTP Adapter</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/Deltacloud-perspective-launch_instance2.png"/> + </imageobject> + </mediaobject> + </figure> + </section> <section id="theinstancesview"> <title>The Instances view</title>