Skip to content

Commit 811f61a

Browse files
dharmabumsteaddharmabumstead
committed
DOC-1403: cleaning up getting started section of the user guide; adding content suggestions from doc summit.
1 parent a163750 commit 811f61a

File tree

5 files changed

+77
-19
lines changed

5 files changed

+77
-19
lines changed

‎content/en_us/user-guide.ditamap

+5-3
Original file line numberDiff line numberDiff line change
@@ -4,25 +4,27 @@
44
<title>Eucalyptus <ph conref="shared/conrefs.dita#prod/version"/> User Guide</title>
55
<topicmeta>
66
<copyright>
7-
<copyryear year="2012"/>
7+
<copyryear year="2014"/>
88
<copyrholder>Eucalyptus Systems</copyrholder>
99
</copyright>
1010
<prodinfo>
1111
<prodname>Eucalyptus</prodname>
1212
<vrmlist>
13-
<vrm version="3.2.0"/>
13+
<vrm version="4.0.2"/>
1414
</vrmlist>
1515
</prodinfo>
1616
</topicmeta>
1717
<topicref href="user-guide/index.dita"/>
1818
<topicref href="user-guide/getting_started.dita">
19-
<topicref href="user-guide/signup.dita"/>
19+
<!--<topicref href="user-guide/signup.dita"/>-->
2020
<topicref href="user-guide/get_creds.dita"/>
21+
<topicref href="shared/console_login.dita"/>
2122
<topicref href="user-guide/find_image.dita"/>
2223
<topicref href="user-guide/create_keypairs.dita"/>
2324
<topicref href="user-guide/authorize_sg.dita"/>
2425
<topicref href="user-guide/run_instance.dita"/>
2526
<topicref href="user-guide/login_instance.dita"/>
27+
<topicref href="user-guide/test_instance_web_server.dita"/>
2628
<topicref href="user-guide/reboot_instance.dita"/>
2729
<topicref href="user-guide/terminate_instance.dita"/>
2830

‎content/en_us/user-guide/find_image.dita

+1-5
Original file line numberDiff line numberDiff line change
@@ -41,8 +41,4 @@ admin available public x86_64 ramdisk</codeblock>
4141
use.</postreq>
4242
</taskbody>
4343
</task>
44-
<!--Enter euca-describe-instances to verify your VM instance is running and to view information, such as instance id, key name, VM Type, and IP addresses.
45-
euca-describe-instances
46-
RESERVATION r-338206B5 alice default
47-
INSTANCE i-4DCF092C emi-EC1410C1 192.168.7.24 10.17.0.130 ↵ running mykey 0 m1.small 2010-03-15T21:57:45.134Z ↵
48-
wind eki-822C1344 eri-BFA91429-->
44+

‎content/en_us/user-guide/getting_started.dita

+9-11
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,16 @@
33
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
44
<concept id="getting_started">
55
<title>Getting Started</title>
6-
<shortdesc>This section helps you get started using your Eucalyptus cloud, including an overview
7-
of the features available to end users, how to sign up for an account, get credentials, and
8-
set the environment variables that enable you to interact with Eucalyptus.</shortdesc>
6+
<shortdesc>This section helps you get started using your Eucalyptus cloud, and covers setting up
7+
your user credentials, installing and configuring the command line tools, and working with
8+
images and instances.</shortdesc>
99
<conbody>
10-
<p> As a cloud user, you can access the Eucalyptus cloud using a command line interface such
11-
as Euca2ools, or using a web-based interface such as the Eucalyptus User Console. You
12-
can switch between them freely. What you create in one will be accessible through the
13-
other. </p>
10+
<note><p>For complete documentation on the Eucalyptus Console, see <xref href="../shared/console_login.dita"/>.</p>
11+
</note>
12+
<p>As a cloud user, you can access the Eucalyptus cloud using a command line interface such as
13+
Euca2ools, or using a web-based interface such as the Eucalyptus User Console. You can
14+
switch between them freely. What you create in one will be accessible through the other. </p>
1415
<p>To access Eualyptus, you need keys for Euca2ools and a password for the User Console. To
15-
request access, talk to your cloud administrator. <!--If you are using Euca2ools and want to
16-
get started, see <xref href="../euca2ools-guide/index.dita"/>. If you are using the
17-
Eucalyptus User Console and want to get started, see <xref
18-
href="../console-guide/index.dita"/>.--></p>
16+
request access, talk to your cloud administrator.</p>
1917
</conbody>
2018
</concept>

‎content/en_us/user-guide/images/test_instance_web_server_connect.png

235 KB
Loading

‎content/en_us/user-guide/test_instance_web_server.dita

+62
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
3+
<task id="test_instance_web_server">
4+
<title>Set Up A Web Server on an Instance</title>
5+
<shortdesc/>
6+
<taskbody>
7+
<context>
8+
<p>Once you've launched an instance and connected to it, you can test it by setting up a
9+
web server.</p>
10+
</context>
11+
<steps>
12+
<step>
13+
<cmd>ssh into your instance.</cmd>
14+
<info>
15+
<codeblock>ssh 192.168.1.1 -l root</codeblock>
16+
</info>
17+
</step>
18+
<step>
19+
<cmd>Install Apache:</cmd>
20+
<info>
21+
<codeblock>yum install -y httpd</codeblock>
22+
<p>You should see output similar to the following:</p>
23+
<codeblock>Loaded plugins: fastestmirror, security, versionlock
24+
Loading mirror speeds from cached hostfile
25+
* extras: centos.sonn.com
26+
Midokura-local | 2.9 kB 00:00
27+
centos-6-x86_64-os | 3.7 kB 00:00
28+
centos-6-x86_64-updates | 3.4 kB 00:00
29+
centos-6-x86_64-updates/primary_db | 5.4 MB 00:00
30+
elrepo-6-x86_64 | 2.9 kB 00:00
31+
epel-6-x86_64 | 4.4 kB 00:00
32+
epel-6-x86_64/primary_db | 6.3 MB 00:00
33+
euca2ools-release | 1.2 kB 00:00
34+
eucalyptus-release | 1.3 kB 00:00
35+
eucalyptus-release/primary | 417 kB 00:00
36+
extras | 3.3 kB 00:00
37+
Setting up Install Process
38+
Package httpd-2.2.15-31.el6.centos.x86_64 already installed and latest version
39+
Nothing to do
40+
</codeblock>
41+
</info>
42+
</step>
43+
<step>
44+
<cmd>Start the web server:</cmd>
45+
<info>
46+
<codeblock>service httpd start</codeblock>
47+
<p>You should see output similar to the following:</p>
48+
<codeblock>Starting httpd: [ OK ]</codeblock>
49+
</info>
50+
</step>
51+
<step>
52+
<cmd>Test connectivity to your instance by using a web browser and connecting to the
53+
web service on your instance.</cmd>
54+
<info>
55+
<p>For example:</p>
56+
<image href="images/test_instance_web_server_connect.png" scale="75"
57+
alt="Windows login screen"/>
58+
</info>
59+
</step>
60+
</steps>
61+
</taskbody>
62+
</task>

0 commit comments

Comments
 (0)