Author: irooskov(a)redhat.com Date: 2012-05-11 02:30:46 -0400 (Fri, 11 May 2012) New Revision: 40943 Removed: trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_04.png trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_05a.png Modified: trunk/openshift/docs/reference/en-US/Creating_an_OpenShift_Express_Application.xml trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_03.png trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_05.png trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_06.png trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_07.png Log: update to new openshift tooling info in progress Modified: trunk/openshift/docs/reference/en-US/Creating_an_OpenShift_Express_Application.xml =================================================================== --- trunk/openshift/docs/reference/en-US/Creating_an_OpenShift_Express_Application.xml 2012-05-11 00:56:21 UTC (rev 40942) +++ trunk/openshift/docs/reference/en-US/Creating_an_OpenShift_Express_Application.xml 2012-05-11 06:30:46 UTC (rev 40943) @@ -35,51 +35,35 @@ </mediaobject> </figure> <para> - If you have already signed up for an OpenShift account then you can input your <guilabel>Username</guilabel> and <guilabel>Password</guilabel> here and click the <guibutton>Next</guibutton> button. If validation is successful you will see the <guilabel>Setup OpenShift Application<guilabel> screen. + If you have already signed up for an OpenShift account then you can input your <guilabel>Username</guilabel> and <guilabel>Password</guilabel> here and click the <guibutton>Next</guibutton> button. If validation is successful you will see the <guilabel>Setup OpenShift Application</guilabel> screen. </para> <para> If you do not have an OpenShift account, you can create one through the link at the top of the wizard screen. This will open the OpenShift sign-up page within your workbench. Once you have created an account you will need to relaunch the <guilabel>OpenShift Application</guilabel> wizard and input your new username and password. </para> <figure id="application_creation_03"> - <title>Setting the domain name</title> + <title>Creating a domain</title> <mediaobject> <imageobject> <imagedata fileref="images/Creating_an_OpenShift_Express_Application/application_creation_03.png" format="PNG" /> </imageobject> <textobject> <phrase> - Creating a domain name or inserting one that already exists for your OpenShift account. + Creating a domain for your OpenShift account. </phrase> </textobject> </mediaobject> </figure> <para> - If you already have a domain name then you can type this into the <guilabel>Domain name</guilabel> field. + If you need to create a domain, type the name you wish to have into the <guilabel>Domain name</guilabel> field. You will also need to provide your public SSH key. Ensure that the paired private key is listed within the SSH2 Preferences. If you are unsure, click the <guilabel>SSH2 Preferences</guilabel> link. Click <guibutton>Finish</guibutton> to complete domain creation. </para> <para> - If you need to create a domain, type the name you wish to have into the <guilabel>Domain name</guilabel> field and click the <guibutton>Create</guibutton> button. After clicking <guibutton>Create</guibutton>, you will need to provide your public SSH key. You will need to ensure that the paired private key is listed within the SSH2 Preferences. If you are unsure, click the <guilabel>SSH2 Preferences</guilabel> link in the window. Click <guibutton>Finish</guibutton> to complete domain creation. + If you already have a domain name then you will not see the <guilabel>Domain Creation</guilabel> screen. </para> - <figure id="application_creation_04"> - <title>Creating a domain name</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/Creating_an_OpenShift_Express_Application/application_creation_04.png" format="PNG" /> - </imageobject> - <textobject> - <phrase> - Going through the process of creating a domain name. - </phrase> - </textobject> - </mediaobject> - </figure> <note> <para> - If you ever wish to rename your domain, you can do so by changing the name as it appears in the <guilabel>Domain name</guilabel> field and then click <guibutton>Rename</guibutton>. + If you ever wish to rename your domain, this can be done through the <guilabel>OpenShift Explorer</guilabel>. <!--put xref here --> </para> </note> - <para> - Click the <guibutton>New</guibutton> button in the <guilabel>Available Applications</guilabel> section of the wizard to begin creating your first OpenShift application, for the specified domain. - </para> <figure id="application_creation_05"> <title>Creating a new OpenShift application</title> <mediaobject> @@ -94,105 +78,55 @@ </mediaobject> </figure> <para> - You will need to specify a name for the application and the platform to deploy for, from the <guilabel>Cartdige</guilabel> drop-down list. Click the <guibutton>Next</guibutton> to embedd cartridges or click <guibutton>Finish</guibutton> to create the application. + Now ready to create your OpenShift application, you will need to specify a name, the platform type to deploy for, from the <guilabel>Type</guilabel> drop-down list, and the <guilabel>Gear profile</guilabel> to be used. <!--Further gear profile information to go here--> </para> <note> <para> No underscores or special characters are allowed in the application name. </para> </note> - <figure id="application_creation_05a"> - <title>Embed Cartridges</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/Creating_an_OpenShift_Express_Application/application_creation_05a.png" format="PNG" /> - </imageobject> - <textobject> - <phrase> - Choosing which cartridges to embed within the application. - </phrase> - </textobject> - </mediaobject> - </figure> <para> - If you clicked <guibutton>Next</guibutton>, you will now see the <guilabel>Embed Cartridges</guilabel> screen. From here you can choose to embed any numbe rof cartridges, or none. Once you have finished your selection click <guibutton>Finish</guibutton>. + You can also select to embed cartridges into your applicaiton. By embedding a cartridge, you allow your application the ability to use the asociated technology. For example, embedding the <guilabel>mysql</guilabel> cartridge will grant your application the capability to use a MySQL database. </para> - <note> - <para> - The <guilabel>Embed Cartridges</guilabel> screen can also be access by highlighting a project in the <guilabel>Available Applications</guilabel> section of the <guilabel>Application Selection</guilabel> screen and clicking on the <guibutton>Edit</guibutton> button. To embed your application with a cartridge is to grant the capability to your application. For example, embedding the <guilabel>mysql</guilabel> cartridge will grant your application the capability to use a MySQL database. - </para> - </note> <figure id="application_creation_06"> - <title>Created application availability</title> + <title>Application setup</title> <mediaobject> <imageobject> <imagedata fileref="images/Creating_an_OpenShift_Express_Application/application_creation_06.png" format="PNG" /> </imageobject> <textobject> <phrase> - The created application is now available in the Available Applications section. + Configuring the project and server adaptor settings. </phrase> </textobject> </mediaobject> </figure> <para> - You can select an available application by clicking on it in the <guilabel>Available Applications</guilabel> section of the window. Having selected an application, you can now <guibutton>Delete</guibutton> or view the details of the application by clicking the <guibutton>Details</guibutton>; try that now. + Since you are creating a new project, leave the <guilabel>Create a new project</guilabel> checkbox ticked. </para> - <figure id="application_creation_07"> - <title>Application details</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/Creating_an_OpenShift_Express_Application/application_creation_07.png" format="PNG" /> - </imageobject> - <textobject> - <phrase> - The details screen for the application. - </phrase> - </textobject> - </mediaobject> - </figure> <para> - The <guilabel>Application Details</guilabel> will provide you with all the information available concenring the application. To close this window and return to the previous window, click <guibutton>OK</guibutton>. + For easy interaction with the OpenShift server and your domain it is recommended that you leave the <guilabel>Create and setup a server for easy publishing</guilabel> checkbox ticked. Doing so will create an OpenShift server instance in the <guilabel>Servers</guilabel> view, upon completing the wizard. </para> - <figure id="application_creation_06b"> - <title>Application availability</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/Creating_an_OpenShift_Express_Application/application_creation_06.png" format="PNG" /> - </imageobject> - <textobject> - <phrase> - Having returned to the previous screen, we can see that the application is still available. - </phrase> - </textobject> - </mediaobject> - </figure> <para> - Click the <guibutton>Next</guibutton> to proceed to the next screen. + Click the <guibutton>Next</guibutton> button to progress in the wizard. </para> - <figure id="application_creation_08"> - <title>Cloned Git Repository</title> + <figure id="application_creation_07"> + <title>Cloning settings</title> <mediaobject> <imageobject> - <imagedata fileref="images/Creating_an_OpenShift_Express_Application/application_creation_08.png" format="PNG" /> + <imagedata fileref="images/Creating_an_OpenShift_Express_Application/application_creation_07.png" format="PNG" /> </imageobject> <textobject> <phrase> - Cloning the project from the Git repository and creating the JBoss Server adapter. + Clone settings for the project from the Git repository. </phrase> </textobject> </mediaobject> </figure> <para> - The final screen of the <guilabel>OpenShift application wizard</guilabel> specifies <guilabel>Git clone</guilabel> settings and <guilabel>JBoss Server adapter</guilabel> options. + The final screen of the <guilabel>OpenShift application wizard</guilabel> specifies <guilabel>Cloning settings</guilabel>. Here you can set the properties for creating a local copy of your application. The <guilabel>Location</guilabel> and <guilabel>Remote name</guilabel> options will be set to automatically, however you are able to change these by deselecting the <property>default</property> option and specifying custom settings in the fields provided. </para> <para> - In the <guilabel>Git clone</guilabel> section of the window sets the properties for creating a local copy of your application for you to work with. The location of your application in the Git repository of your domain is present in the <guilabel>Cloning From</guilabel> field. The <guilabel>Destination</guilabel> and <guilabel>Remote name</guilabel> options will be set to default automatically, however you are able to change these by deselecting the <property>default</property> option and specifying custom settings in the fields provided. - </para> - <para> - The <guilabel>JBoss Server adapter</guilabel> section of the window will have the option to <property>Create a JBoss server adapter</property> selected automatically. Creating a JBoss server adapter will allow you to publish changes you make to your application, back to your OpenShift domain. - </para> - <para> Click the <guibutton>Finish</guibutton> to begin the cloning of the Git repository. </para> <figure id="application_creation_09"> @@ -209,7 +143,7 @@ </mediaobject> </figure> <para> - After the Git repository has been cloned, you will see a new <guilabel>Git Repositories</guilabel> tab appear near the bottom of your workbench. If you do not see the tab you can open it manually by navigating to <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Show View</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>Git</guimenuitem><guimenuitem>Git Repositories</guimenuitem></menuchoice>. With the <guilabel>Git Repositories</guilabel> option selected, click <guibutton>OK</guibutton>. + After the Git repository has been cloned, it will be available through the <guilabel>Git Repositories</guilabel> view. You can open it by navigating to <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Show View</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>Git</guimenuitem><guimenuitem>Git Repositories</guimenuitem></menuchoice>. With the <guilabel>Git Repositories</guilabel> option selected, click <guibutton>OK</guibutton>. </para> <figure id="application_creation_10"> <title>Project in Package Explorer</title> Modified: trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_03.png =================================================================== (Binary files differ) Deleted: trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_04.png =================================================================== (Binary files differ) Modified: trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_05.png =================================================================== (Binary files differ) Deleted: trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_05a.png =================================================================== (Binary files differ) Modified: trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_06.png =================================================================== (Binary files differ) Modified: trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_07.png =================================================================== (Binary files differ)