Changes between Version 5 and Version 6 of Documentation/Community/HowTo/ThePerfectEboxSetup/Install

Timestamp:

06/16/09 05:47:48 (4 years ago)

Author:

poundjd (IP: 68.32.33.27)

Comment:

Lots of #FIXME's, edits and comments. This is very very detailed. Getting closer to being done.

Documentation/Community/HowTo/ThePerfectEboxSetup/Install

@@ -1 +1 @@
 == Install ==
 
-You should get the latest eBox Platform installer based on Ubuntu GNU/Linux installer from the download page. #FIXME i386 vs amd64 download
-
-=== Assumptions used below ===
+You should get the latest eBox Platform installer based on Ubuntu GNU/Linux installer from the [http://ebox-platform.com/download/ download page]. #FIXME i386 vs amd64 download
+
+=== Assumptions Used Below ===
 
 ==== Language and Location ====
-For this guide we will assuming an English Speaker from the USA.
+For this guide we will be assuming an English Speaker from the USA.
 
 ==== Networking ====
@@ -18 +18 @@
 Server Name will be : '''ebox'''
 
-User Full Name : '''user'''
-
-User Name : '''user'''
-
-User Password '''GoodPassword''' - will be displayed as ****
+User Full Name : '''user''' #FIXME ''- Should be '''eBox Administrator Full Name''' in pictures and here.''
+
+User Name : '''user''' #FIXME ''- Should be '''eBoxAdministrator''' in pictures and here.''
+
+User Password '''AGoodPassword''' - will be displayed as ****
 
 eBox HTTPS Port: '''443'''
@@ -43 +43 @@
 ==== General settings ====
 
-You should check that your server is configured to boot up from the CD or DVD ROM unit otherwise the installer won't start. Most of the times this is the default behavior but if it doesn't check your hardware vendor documentation.
-
-The first screen that appears lets us choose the installer language. Just press ''enter'' to select English or move with the arrows to select the desired language.
+You should check that your server is configured to boot up from the CD or DVD ROM unit otherwise the installer won't start. Most of the times this is the default behavior but if it doesn't check your hardware vendor documentation.  This is set in the BIOS of your computer.
+
+The first screen that appears lets us choose the installer language. Just press ''Enter'' to select English or move with the arrows to select the desired language.
 
 [[Image(ebox_install_01.png, 300)]]
@@ -51 +51 @@
 On the main screen we can do 5 different actions:
 
-  * Install eBox Platform (selected by default, this is the option we should go for)
-  * Check CD for defects (we can use this option to check that the image was properly burned)
-  * Rescue a broken system (we will use this option to rescue the system on a fatal error)
-  * Test memory (the installer includes a memory tester application, we should check our server memory if it does random weird things)
-  * Boot from first hard disk (we will use this option to boot the system on a boot loader fatal error)
+  * Install eBox Platform ''(Selected by default, this is the option we will select)''
+  * Check CD for defects ''(We can use this option to check that the image was properly burned)''
+  * Rescue a broken system ''(We will use this option to rescue the system if we have a fatal error)''
+  * Test memory ''(The installer includes a memory tester application, we should check our server memory if it does random weird things)''
+  * Boot from first hard disk ''(We will use this option to boot the system if we have a boot loader fatal error)''
 
 [[Image(ebox_install_02.png, 300)]]
 
-The next step is to choose your system language: We will select '''English'''.
+The next step is to choose your system language: 
+
+We will select '''English'''.
 
 [[Image(ebox_install_03.png, 300)]] 
 
-The next step is to chose your system Localization: We will select '''USA'''.
+The next step is to chose your system Localization:
+
+We will select '''United States'''.  #FIXME ''(The picture showes ''''Ireland'''')''
 
 [[Image(ebox_install_04.png, 300)]]
@@ -69 +73 @@
 After that we will have to choose the keyboard layout, the installer can auto detect it or we can select it by hand, we prefer to do it this way: 
 
-First we will select '''No'''
+First where it asks us ''Detect keyboard layout?''. 
+
+We will select '''No'''
 
 [[Image(ebox_install_05.png, 300)]] 
 
+Where it next asks for ''The origin of the keyboard:''. 
+
 We will then select '''USA'''.
 
 [[Image(ebox_install_06.png, 300)]]
 
- We will again select '''USA'''
+Where it asks for the ''Keyboard layout:''. 
+
+We will again select '''USA'''
 
 [[Image(ebox_install_07.png, 300)]]
@@ -91 +101 @@
 Select the network interface.  Usually if only one network cable is installed you will only have one option. In this case we have three to choose from, we select the one that is connected to the internal LAN.
 
+'''Please note that the text after the ":" will be based on your hardware not what we have installed here for this trial.'''
+
+Where it asks for ''Primary network interface:''.
+
+We will will select '''eth0:'''  
+
 [[Image(ebox_install_09.png, 300)]] 
 
-Next then the installer will ask us for a hostname for the machine. In this example we will use '''ebox'''.
+Next then the installer asks us for a ''hostname:'' for the machine. 
+
+We will type in '''ebox'''.
 
 [[Image(ebox_install_10.png, 300)]]
 
+==== #FIXME RAID ====
 ==== Partitioning ====
 
-#FIXME RAID
-
-Probably this is the most complex step and where you have to make more choices but this is very important for your server future. Our install will be using LVM (Linux Volume Manager) and the partition scheme we recommend would be something like:
+Probably this is the most complex step and where you have to make more choices but this is also very important for your server future. Our install will be using LVM (Linux Volume Manager) and the partition scheme we recommend would be something like:
 
 || Partition || Size || Format || Mount Point || Comments ||
@@ -116 +133 @@
 We shouldn't forget to leave some free space on the LVM volume in order to create the snapshots used for safe upgrades. This size usually should be around 2G but probably you will need more if you want to make snapshots on data partitions volumes, in that case 2G+15% of your other volumes size should be OK.
 
-That's why we will choose ''Manual'' partitioning:
+===== /boot =====
+
+That's why we will choose '''Manual''' partitioning.
 
 [[Image(ebox_install_11.png, 300)]]
 
-Will go over the ''FREE SPACE'' with the rows and will press ''Enter'' to create a new partition there:
+The Installer displays a summary of the disks and partitions we currently have on the system next.  Sense this picture is from a virtual install we only have a 8.6 GB virtual hard disk.
+
+We will move the highlighted area over the line that says: ''pri/log   8.6 GB   FREE SPACE''.
+
+We select it by hitting ''Enter''.
 
 [[Image(ebox_install_12.png, 300)]]
 
-Next steps will be to configure the size as a primary partition at the beginning of the hard disk, the file system and the mount point are selected by default:
-
-Select '''Create a new partition'''
+That will mark this area as marked and partitioned. 
+The next few steps will be to configure the ''/boot'' partition, marking it as a primary partitions and placing it at the beginning of the hard disk
+
+So where it asked us ''How to use this free space:'' 
+
+We Select '''Create a new partition'''.
 
 [[Image(ebox_install_13.png, 300)]] 
 
-We selected '''256M''' here, but you should select '''????''' or the size you need for '''/boot'''.
+We will select '''256M''' here, but you should select '''????''' or the correct size you need for '''/boot'''.
+
+Where it asks us for the ''New partition size:''.
+
+We type in '''256M'''.
 
 [[Image(ebox_install_14.png, 300)]] 
 
-Select '''Primary'''
+Where it asks us ''Type for the new partition:''.
+
+We Select '''Primary'''.
 
 [[Image(ebox_install_15.png, 300)]] 
 
-Select '''Beginning'''
+Where it asks us ''Location for he new partition:''
+
+We select '''Beginning'''
 
 [[Image(ebox_install_16.png, 300)]] 
 
-The file system should be '''ext3''', the mount point is '''/boot''', Leave the other settings as their defaults.
+Where it asks us ''Partition settings''. We should be able to accept all but two of the defaults, and they should be:  The file system should be '''ext3''', the mount point is '''/boot''', leave the other settings as their defaults.
+
+So where under ''Partition settings'' is says ''Use as:''.
+
+We should select '''Ext3 journaling file system''' 
 
 [[Image(ebox_install_17.png, 300)]]
 
+So where under ''Partition settings'' it says ''Mount point''.
+
+We should select '''/boot'''.
+
+[[Image(ebox_install_18.png, 300)]]
+
 And this is the state after creating the system partition:
 
-[[Image(ebox_install_18.png, 300)]]
-
-Now we are going to create a LVM volume on the free space going over ''FREE SPACE'' and pressing ''Enter'':
+So we select ''Done setting up the partition''.
 
 [[Image(ebox_install_19.png, 300)]]
 
+
+===== Logical Volume Manager =====
+
 The steps now will be the same as before, creating the partition with the maximum size, but on the last one will have to change the defaults:
 
-Select the FREE SPACE
+Select the ''FREE SPACE''.
 
 [[Image(ebox_install_20.png, 300)]] 
 
-Select '''Create a new partition'''
+Select '''Create a new partition'''.
 
 [[Image(ebox_install_21.png, 300)]]
-
-#FIX IT -- Will go over ''Use as:'' and will press ''Enter'' selecting ''physical volume for LVM'' and finishing:
 
 Next we select the maximum size we can for the LVM partition. Our example will be using '''8.3 GB''', you should select '''max''', or perhaps the default will be the max.
@@ -183 +226 @@
 [[Image(ebox_install_25.png, 300)]] 
 
-Now we are done with this partition.  So we select '''Don setting up the partition'''.
+Now we are done with this partition.  So we select '''Done setting up the partition'''.
 
 [[Image(ebox_install_26.png, 300)]] 
 
-
-Now with LVM setup is in place we can create the logical volumes for every partition we want, probably swap, /var, /home and /var/vmail.
-
-Select ''Configure the Logical Volume Manager'':
+Select '''Configure the Logical Volume Manager''':
 
 [[Image(ebox_install_27.png, 300)]]
 
-Now the partition needs to be put on disk so Select '''Yes''', and wait a little while.
+Now the partition needs to be put on disk.
+
+Where it asks ''Write the changes to disks and configure LVM?''
+
+We select '''Yes''', and wait a little while.
 
 [[Image(ebox_install_28.png, 300)]]  
 
-Now we have to create a volume group so select '''Create volume group'''
+
+====== Logical Volume Group ======
+
+Now we have to create a volume group.
+
+Where it says ''LVM configuration action:''
+
+We select '''Create volume group'''.
 
 [[Image(ebox_install_29.png, 300)]] 
 
-Now we give the volume group a name.  We selected '''ebox'''
+Now we give the volume group a name.  
+
+Where it says ''Volume group name:'' 
+
+We will type in '''ebox'''.
 
 [[Image(ebox_install_30.png, 300)]]
 
-Now we select the devices for the new volume group.  We only have one device, so that is what we select.  Then we select '''Continue'''.
+Now we select the devices for the new volume group.  We only have one device, so that is what we select.  
+
+Where it says ''Devices for the new volume group:'' We highlight the only disk we have.
+
+Then we select '''Continue'''.
 
 [[Image(ebox_install_31.png, 300)]] 
 
-Next we see the '''Summary of current LVM configuration:''' here we will select the '''Create logical volume'''
+====== Logical Volumes ======
+
+
+Now with the LVM setup we can create the logical volumes for every partition we want, usually that would probably be /root, swap, /var, /home and /var/vmail. But for this guide we will only do /root, swap and /var.
+
+Next we see the '''Summary of current LVM configuration:''' with the current summary. 
+
+Where it says ''LVM configuration action:''
+
+We will select the '''Create logical volume'''
 
 [[Image(ebox_install_32.png, 300)]] 
 
-Next we have to select the volume group where the new logical volume will be created.  We have only one choice '''ebox'''
+Next we have to select the volume group where the new logical volume will be created.  We have only one choice '''ebox'''.
+
+Where it says ''Volume group:'' 
+
+We select '''ebox''', our only choice.
 
 [[Image(ebox_install_33.png, 300)]] 
 
-So now we have to name the new logical volume, this one will be '''root'''
+So now we have to name the new logical volume, this one will be '''root'''.
+
+Where it says ''Logical volume name:''
+
+We will type in '''root'''.
 
 [[Image(ebox_install_34.png, 300)]] 
 
-Now we enter the size of the new logical volume, we select '''4G'''
+Now we enter the size of the new logical volume, we select '''4G'''.
+
+Where it says ''Logical volume size:''
+
+We will type in '''4g'''.
 
 [[Image(ebox_install_35.png, 300)]] 
 
+We have to repeat the last 2 steps and create the following logical volumes
+
+|| Name ||  Size  ||
+|| swap || 536.9M ||
+|| var  ||  2.1G  ||
+
 Now we are done with creating the logical volumes...
 
+So where it says ''LVM configuration action:''
+
+We select '''Finish'''.
+
 [[Image(ebox_install_36.png, 300)]]
 
 This is what our partitions now look like, 
-|| Partition || Size     || File System || Comments ||
-|| 1 /boot   || 255MB    ||    ext3     ||  ||
-|| 2         || 8.3 GB   ||    LVM      || Volume Group ||
-|| 2a root   || 4.3 GB   ||    LVM      ||  /root in the LVM ||
-|| 2b swap   || 536.9 MB ||    LVM      ||  ||
-|| 2c var    || 2.1 GB   ||    LVM      ||  /var in the LVM ||
-
-MORE EDITING TO COME>>>>
-
+|| Partition ||    Phy/Log   || Size     || File System || Comments ||
+|| 1 /boot   || Phy Partion  || 255MB    ||    ext3     ||  ||
+|| 2         || Log V Group  || 8.3 GB   ||    lvm      || Volume Group ||
+|| 2a root   || Log Volume   || 4.3 GB   ||             ||  /root in the LVM ||
+|| 2b swap   || Log Volume   || 536.9 MB ||             ||   swap in the LVM ||
+|| 2c var    || Log Volume   || 2.1 GB   ||             ||  /var in the LVM ||
+
+Now we will put the file system on the ''root'' logical volume 
+
+Select the line that says ''#1 4.2GB''
 
 [[Image(ebox_install_37.png, 300)]] 
+
+Now we will tell it what file system we want on it.
+
+We select ''Use as:''
+
 [[Image(ebox_install_38.png, 300)]] 
+
+Now we will select the file system we want.
+
+Select ''Ext3 journaling file system''.
+
 [[Image(ebox_install_39.png, 300)]]
 
+Now we will mark it and go to the next one.
+
+Select ''Done setting up the partition''.
+
 [[Image(ebox_install_40.png, 300)]] 
-[[Image(ebox_install_41.png, 300)]] 
+
+We have to do the same things for ''swap'' and ''/var'' only the file systems will be different.
+
+This is what our partitions now look like, 
+|| Partition ||    Phy/Log   || Size     || File System || Comments ||
+|| 1 /boot   || Phy Partion  || 255MB    ||    ext3     ||  ||
+|| 2         || Log V Group  || 8.3 GB   ||    lvm      || Volume Group ||
+|| 2a root   || Log Volume   || 4.3 GB   ||    ext3     ||  / in the LVM ||
+|| 2b swap   || Log Volume   || 536.9 MB ||    swap     ||   swap in the LVM ||
+|| 2c var    || Log Volume   || 2.1 GB   ||    xfs      ||  /var in the LVM ||
+
+Now we have configured the file system we want to write it to the disk.
+
+Select ''Finish partitioning and write changes to disk''.
+
+[[Image(ebox_install_41.png, 300)]]
+
+It checks to make sure that your done.
+
+Where it says ''Write the changes to disks?''
+
+Select ''Yes''
+
 [[Image(ebox_install_42.png, 300)]]
 
+We are done with the storage sub-system at this point.
+
+=== Setup the eBox Administrators Account ===
+
+Where it asks ''Full name for the new user:''
+
+We will type in the eBox administrators full name.
+
+We will type in '''user''' #FIXME ''- Should be '''eBox Administrator Full Name''' 
+
 [[Image(ebox_install_43.png, 300)]] 
+
+Where it asks ''Username for the new user:''
+
+We will type in the eBox administrators username.
+
+We will type in '''user''' #FIXME ''- Should be '''eBoxAdministrator''' 
+
 [[Image(ebox_install_44.png, 300)]] 
+
+Where it asks ''Choose a password for the new user:''
+
+We will type in the eBox administrators password.
+
+We will type in '''AGoodPassword''' - will be displayed as *************
+
 [[Image(ebox_install_45.png, 300)]]
 
+Where it asks ''Re-enter password to verify:''
+
+We will type in the eBox administrators password again.
+
+We will type in '''AGoodPassword''' - will be displayed as *************, again
+
 [[Image(ebox_install_46.png, 300)]] 
+
+At this point it will install the software from the CD or DVD and it may take a while....
+
 [[Image(ebox_install_47.png, 300)]] 
+
+=== System Clock ===
+
+At this point we have to tell the Operating System whether the system clock is set to normal time or to Coordinated Universal Time, or UTC.  If you plan to use Network Time Protocol (NTP) for setting the time and keeping it accurate, then this is needed.
+
+Where it asks ''Is the system clock set to UTC?''
+
+Select '''Yes'''.
+
 [[Image(ebox_install_48.png, 300)]]
 
+The Ubuntu installation is complete so now you just have to remove the CD or DVD and reboot the system.  But first we have to configure some things for eBox.
+
+Select '''Continue'''
+
 [[Image(ebox_install_49.png, 300)]] 
+==== eBox Web Interface Setup ====
+
+Now we have to set two values for the eBox Web Interface and then we can reboot.
+
+===== Web Interface Password =====
+
+We need a password for the Web Interface.
+
+Where it says ''eBox administrator password:''
+
+Type in '''AGoodPassword'''  
+
 [[Image(ebox_install_50.png, 300)]] 
+
+Where it says ''Confirm password:''
+
+Type in '''AGoodPassword'''
+
 [[Image(ebox_install_51.png, 300)]]
 
+Now we have to configure the port that the eBox Web server listens on.
+
+Where it says ''eBox HTTPS port:''
+
+Type in ''443'' or accept the default and select ''<Ok>''
+
 [[Image(ebox_install_52.png, 300)]] 
+
+Once the above is done the server will shutdown and reboot.
+
+presenting you with a console login prompt.
+
+The password is the one for the eBox Administrator, not the one for the eBox Web Interface.
+
 [[Image(ebox_install_53.png, 300)]]