Changes

From SME Server
Jump to navigationJump to search
m
no edit summary
Line 1: Line 1:  
===Maintainer===
 
===Maintainer===
[http://forums.contribs.org/index.php?action=profile;u=2545 CompSOS]
+
[http://forums.contribs.org/index.php?action=profile;u=2545 CompSOS]  
 +
 
 +
===Support===
 +
For questions or comments regarding this HOWTO, contact [http://www.compsos.com.au SOS Computing PTY Ltd.] at this [mailto:shiena@compsos.com.au email] address, or Sorolo Systems Inc. at this [mailto:sme@sorolo.com email] address. 
    
===Description===
 
===Description===
Line 10: Line 13:  
===Installation===
 
===Installation===
 
<ol>
 
<ol>
   <li>Setup SME Server v8 beta 6.</li>
+
   <li value="1">Setup SME Server v8 beta 6.</li>
   <li>Do a yum update.</li>
+
   <li value="2">Do a yum update.</li>
 
       <pre>yum update</pre>
 
       <pre>yum update</pre>
   <li> If any updates were applied, update and reboot the server.</li>
+
   <li value="3"> If any updates were applied, update and reboot the server.</li>
 
       <pre>signal-event post-upgrade
 
       <pre>signal-event post-upgrade
 
signal-event reboot</pre>
 
signal-event reboot</pre>
   <li>Check your current kernel.</li>
+
   <li value="4">Check your current kernel.</li>
 
       <pre>uname -r</pre>
 
       <pre>uname -r</pre>
   <li>Install kernel-devel to get the latest development tree.</li>
+
   <li value="5">Install kernel-devel to get the latest development tree.</li>
 
Use this command only if you have a PAE kernel installed:
 
Use this command only if you have a PAE kernel installed:
 
       <pre>yum install kernel-PAE-devel kernel-headers</pre>
 
       <pre>yum install kernel-PAE-devel kernel-headers</pre>
Line 24: Line 27:  
       <pre>yum install kernel-devel kernel-headers</pre>
 
       <pre>yum install kernel-devel kernel-headers</pre>
   −
   <li> Check if the compiler (GCC) is installed. If not installed, install it.</li>
+
   <li value="6">Check if the compiler (GCC) is installed. If not installed, install it.</li>
 
       <pre>yum install gcc</pre>
 
       <pre>yum install gcc</pre>
   <li>Update SME, and reboot again</li>
+
   <li value="7">Update SME, and reboot again</li>
 
       <pre>signal-event post-upgrade
 
       <pre>signal-event post-upgrade
 
signal-event reboot</pre>
 
signal-event reboot</pre>
   <li>Change your kernel boot options</li>
+
   <li value="8">Change your kernel boot options</li>
 
       <pre>Optionally, for best results with SME 8.x and earlier versions,
 
       <pre>Optionally, for best results with SME 8.x and earlier versions,
 
modify /etc/grub.conf, adding divider=10 to the kernel boot options in order
 
modify /etc/grub.conf, adding divider=10 to the kernel boot options in order
Line 36: Line 39:  
change it to
 
change it to
 
kernel /vmlinuz-2.6.18-238.19.1.el5 ro root=/dev/main/root divider=10</pre>
 
kernel /vmlinuz-2.6.18-238.19.1.el5 ro root=/dev/main/root divider=10</pre>
 +
<b>Reminder: if you subsequently update SME Server to use a newer kernel, you will need to change
 +
your kernel boot line to reflect the update.</b>
   −
   <li>Create a symbolic link</li>
+
   <li value="9">Create a symbolic link</li>
 
       <pre>NOTE: Be careful if you cut-and-paste the command below.
 
       <pre>NOTE: Be careful if you cut-and-paste the command below.
 
In some terminal windows, from some browsers, the parts of the command in
 
In some terminal windows, from some browsers, the parts of the command in
Line 44: Line 49:  
the command below - they are all supposed to be backticks.</pre>
 
the command below - they are all supposed to be backticks.</pre>
   −
ln <b>–s</b> /usr/src/kernels/<b>`uname –r`</b>-<b>`uname-m`</b> /lib/modules/<b>`uname -r`</b>/build
+
ln <b>–s</b> /usr/src/kernels/<b>`uname –r`</b>-<b>`uname-m`</b> /lib/modules/<b>`uname -r`</b>/build<br />
 +
<b>Reminder: if you subsequently update SME Server to use a newer kernel, you will need to recreate the symbolic link.</b>
   −
   <li>Check that the symbolic link was properly created by doing a directory listing.</li>
+
   <li value="10">Check that the symbolic link was properly created by doing a directory listing.</li>
 
       <pre>NOTE: Be careful if you cut-and-paste the command below.
 
       <pre>NOTE: Be careful if you cut-and-paste the command below.
 
In some terminal windows, from some browsers, the parts of the command in
 
In some terminal windows, from some browsers, the parts of the command in
Line 54: Line 60:     
ls /lib/modules/<b>`uname -r`</b>/build
 
ls /lib/modules/<b>`uname -r`</b>/build
   <li>Install the Fedora Epel repository using the instructions [http://wiki.contribs.org/Epel here].</li>
+
   <li value="11">Install the Fedora Epel repository using the instructions [http://wiki.contribs.org/Epel here].</li>
   <li>Install Dynamic Kernel Module Support (DKMS)</li>
+
   <li value="12">Install Dynamic Kernel Module Support (DKMS)</li>
 
       <pre>yum install --enablerepo=epel dkms</pre>
 
       <pre>yum install --enablerepo=epel dkms</pre>
   <li>Install the VirtualBox repository using the instructions [http://wiki.contribs.org/VirtualBox_Repository here].</li>
+
   <li value="13">Install the VirtualBox repository using the instructions [http://wiki.contribs.org/VirtualBox_Repository here].</li>
   <li>Install <b>VirtualBox</b> (At the time of the last update to these instructions, the latest version was v4.1-2).</li>
+
   <li value="14">Install <b>VirtualBox</b> (At the time of the last update to these instructions, the latest version was v4.1-2).</li>
 
       <pre>yum install --enablerepo=virtualbox VirtualBox-4.1</pre>
 
       <pre>yum install --enablerepo=virtualbox VirtualBox-4.1</pre>
   <li>Review the VirtualBox installation log to ensure that the installation was successful.</li>
+
   <li value="15">Review the VirtualBox installation log to ensure that the installation was successful.</li>
 
       <pre>tail /var/log/vbox-install.log</pre>
 
       <pre>tail /var/log/vbox-install.log</pre>
   <li> Remove the compiler install (for security best practices)</li>
+
   <li value="16"> Remove the compiler install (for security best practices)</li>
 
       <pre> rpm -e gcc</pre>
 
       <pre> rpm -e gcc</pre>
   <li>Update SME, and reboot again</li>
+
   <li value="17">Update SME, and reboot again</li>
 
       <pre>signal-event post-upgrade
 
       <pre>signal-event post-upgrade
 
signal-event reboot</pre>
 
signal-event reboot</pre>
   <li>Setup VirtualBox as a service so it starts automatically after a reboot.</li>
+
   <li value="18">Setup VirtualBox as a service so it starts automatically after a reboot.</li>
 
       <pre>cp /etc/rc5.d/S30vboxdrv /etc/rc7.d/.
 
       <pre>cp /etc/rc5.d/S30vboxdrv /etc/rc7.d/.
 
cp /etc/rc5.d/S35vboxballoonctrl-service /etc/rc7.d/.
 
cp /etc/rc5.d/S35vboxballoonctrl-service /etc/rc7.d/.
 
cp /etc/rc5.d/S35vboxweb-service /etc/rc7.d/.</pre>
 
cp /etc/rc5.d/S35vboxweb-service /etc/rc7.d/.</pre>
   <li>Create a ''vbox.cfg'' file on your /etc/vbox/.</li>
+
   <li value="19">Create a ''vbox.cfg'' file on your /etc/vbox/.</li>
 
       <pre>nano /etc/vbox/vbox.cfg</pre>
 
       <pre>nano /etc/vbox/vbox.cfg</pre>
   Line 81: Line 87:  
Note: Without the vbox.cfg, vbox services on your rc7.d folder will not start.
 
Note: Without the vbox.cfg, vbox services on your rc7.d folder will not start.
   −
   <li>Login to the server-manager page and create an ibay for <b>phpvbox</b>.
+
   <li value="20">Login to the server-manager page and create an ibay for <b>phpvbox</b>.
 
   For instructions on how to create and configure an ibay, please see [http://wiki.contribs.org/SME_Server:Documentation:Administration_Manual:Chapter14 the SME Server Administration manual.]</li>
 
   For instructions on how to create and configure an ibay, please see [http://wiki.contribs.org/SME_Server:Documentation:Administration_Manual:Chapter14 the SME Server Administration manual.]</li>
   −
After creating the ibay, <b>do not forget to assign a password.</b>
+
<b>After creating the ibay, do not forget to assign a password.</b>
   −
   <li>Before we install <b>[http://code.google.com/p/phpvirtualbox/ phpVirtualBox]</b>, make sure you install <b>SOAP</b> first</li>
+
   <li value="21">Before we install <b>[http://code.google.com/p/phpvirtualbox/ phpVirtualBox]</b>, make sure you install <b>SOAP</b> first</li>
 
       <pre>yum install php-soap</pre>
 
       <pre>yum install php-soap</pre>
   <li>Install <b>phpVirtualBox</b></li>
+
   <li value="22">Install <b>phpVirtualBox</b></li>
 
       <pre>cd /tmp
 
       <pre>cd /tmp
 
wget `wget -q -O - http://phpvirtualbox.googlecode.com/files/LATEST.txt` -O phpvirtualbox-latest.zip
 
wget `wget -q -O - http://phpvirtualbox.googlecode.com/files/LATEST.txt` -O phpvirtualbox-latest.zip
Line 95: Line 101:  
       <pre>cd phpvirtualbox-4.1-2
 
       <pre>cd phpvirtualbox-4.1-2
 
cp –R * /home/e-smith/files/ibays/phpvbox/html</pre>
 
cp –R * /home/e-smith/files/ibays/phpvbox/html</pre>
   <li>Create a <b>tmp</b> folder inside the /phpvbox/html folder.</li>
+
   <li value="23">Create a <b>tmp</b> folder inside the /phpvbox/html folder.</li>
 
       <pre>cd /home/e-smith/files/ibays/phpvbox/html
 
       <pre>cd /home/e-smith/files/ibays/phpvbox/html
 
mkdir tmp
 
mkdir tmp
 
chmod 777 tmp/</pre>
 
chmod 777 tmp/</pre>
   <li>Create a config file using the example file provided.</li>
+
   <li value="24">Create a config file using the example file provided.</li>
 
       <pre>cp config.php-example config.php</pre>
 
       <pre>cp config.php-example config.php</pre>
   <li>Open ''config.php'' (located on your /phpvbox/html/ folder). Uncomment some lines (by removing the '#' at the beginning of the line).</li>
+
   <li value="25">Open ''config.php'' (located on your /phpvbox/html/ folder). Uncomment some lines (by removing the '#' at the beginning of the line).</li>
 
       <pre>nano /home/e-smith/files/ibays/phpvbox/html/config.php</pre>
 
       <pre>nano /home/e-smith/files/ibays/phpvbox/html/config.php</pre>
 
       <pre>/* SOAP URL of vboxwebsrv (not phpVirtualBox's URL) */
 
       <pre>/* SOAP URL of vboxwebsrv (not phpVirtualBox's URL) */
Line 128: Line 134:  
var $cachePath = '../tmp';</pre>
 
var $cachePath = '../tmp';</pre>
   −
   <li>Disable authentication of ''vboxwebsrv'' (this is not recommended, but at this stage, this is the only setup that works). Login to the server’s SSH and type this command.</li>
+
   <li value="26">Disable authentication of ''vboxwebsrv'' (this is not recommended, but at this stage, this is the only setup that works). Login to the server’s SSH and type this command.</li>
 
       <pre>vboxmanage setproperty websrvauthlibrary null</pre>
 
       <pre>vboxmanage setproperty websrvauthlibrary null</pre>
 
<!--
 
<!--
Line 139: Line 145:  
         You will not be able to start VMs until this problem is fixed.
 
         You will not be able to start VMs until this problem is fixed.
 
-->
 
-->
   <li>Install VirtualBox extension pack to enable support for USB 2.0 devices, VirtualBox RDP and PXE boot for Intel cards. Please install the extension pack with the same version as your installed version of VirtualBox!</li>
+
   <li value="27">Install VirtualBox extension pack to enable support for USB 2.0 devices, VirtualBox RDP and PXE boot for Intel cards. Please install the extension pack with the same version as your installed version of VirtualBox!</li>
    
You can find the extension packs [http://www.virtualbox.org/wiki/Downloads here.] The following commands download and install the extension pack for VirtualBox 4.1.2.
 
You can find the extension packs [http://www.virtualbox.org/wiki/Downloads here.] The following commands download and install the extension pack for VirtualBox 4.1.2.
Line 146: Line 152:  
vboxmanage extpack install Oracle_VM_VirtualBox_Extension_Pack-4.1.2-73507.vbox-extpack</pre>
 
vboxmanage extpack install Oracle_VM_VirtualBox_Extension_Pack-4.1.2-73507.vbox-extpack</pre>
   −
   <li>Update SME, and reboot again</li>
+
   <li value="28">Update SME, and reboot again</li>
 
       <pre>signal-event post-upgrade
 
       <pre>signal-event post-upgrade
 
signal-event reboot</pre>
 
signal-event reboot</pre>
   −
   <li>Ensure that the extension pack is installed correctly.</li>
+
   <li value="29">Ensure that the extension pack is installed correctly.</li>
 
Open a console window, then
 
Open a console window, then
 
       <pre>vboxmanage list extension</pre>
 
       <pre>vboxmanage list extension</pre>
Line 158: Line 164:  
Finally,
 
Finally,
   −
   <li>Open a terminal window to the SME Server and create a directory to store the virtual machine images.</li>
+
   <li value="30">Open a terminal window to the SME Server and create a directory to store the virtual machine images.</li>
 
       <pre>mkdir -p /var/lib/VirtualBox/VMs</pre>
 
       <pre>mkdir -p /var/lib/VirtualBox/VMs</pre>
   <li>Download the VirtualBox Guest Additions iso for later installation into your virtual machine guests.</li>
+
   <li value="31">Download the VirtualBox Guest Additions iso for later installation into your virtual machine guests.</li>
 
       <pre>mkdir -p /var/lib/VirtualBox/addons
 
       <pre>mkdir -p /var/lib/VirtualBox/addons
 
cd /var/lib/VirtualBox/addons
 
cd /var/lib/VirtualBox/addons
 
wget http://download.virtualbox.org/virtualbox/4.1.2/VBoxGuestAdditions_4.1.2.iso</pre>
 
wget http://download.virtualbox.org/virtualbox/4.1.2/VBoxGuestAdditions_4.1.2.iso</pre>
   −
   <li>Using a web browser, Go to http://yourdomain.com/phpvbox and connect to the phpVirtualBox web application.</li>
+
   <li value="32">Using a web browser, Go to http://yourdomain.com/phpvbox and connect to the phpVirtualBox web application.</li>
 
       <pre>From the menu provided, go to select File->Preferences.
 
       <pre>From the menu provided, go to select File->Preferences.
 
Select the "General" tab.
 
Select the "General" tab.
Line 172: Line 178:  
===Creating a Virtual Machine===
 
===Creating a Virtual Machine===
   −
   <li>Using a web browser, go to http://yourdomain.com/phpvbox to create your virtual machine.
+
   <li value="33">Using a web browser, go to http://yourdomain.com/phpvbox to create your virtual machine.
 
       <ul>
 
       <ul>
 
         <li>Create a new virtual machine (e.g. vmXP)</li>
 
         <li>Create a new virtual machine (e.g. vmXP)</li>
Line 179: Line 185:  
       </ul>
 
       </ul>
 
[[File:virtual_box.jpg]]
 
[[File:virtual_box.jpg]]
</li>
+
</li value="34">
 
<li>Install the VirtualBox Guest Additions iso into your newly setup VM.</li>
 
<li>Install the VirtualBox Guest Additions iso into your newly setup VM.</li>
 
</ol>
 
</ol>
38

edits

Navigation menu