6.1 Linux: Installing and Setting Up a Basic Vibe Site

To enable port forwarding on a SUSE Linux server that uses SuSEfirewall2:

1. As the Linux root user, open the following file:

   /etc/sysconfig/SuSEfirewall2

2. Find the following line:

   FW_REDIRECT=""

3. Between the quotation marks, copy and insert the following string:

   0/0,ip_address,tcp,80,8080 0/0,ip_address,tcp,443,8443 
                                           0/0,ip_address,tcp,25,2525
   

4. Replace ip_address with the IP address of the Vibe server.

5. Save the SuSEfirewall2 file, then exit the text editor.

6. Use the following command to restart the firewall:

   /sbin/SuSEfirewall2 start

7. Use the following command to verify that the default browser ports (80 and 443) have been forwarded to the Vibe server ports (8080 and 8443) and that the default SMTP mail host port (25) has been forwarded to the Vibe internal mail host:

   iptables-save | grep REDIRECT

To use iptables commands to enable port forwarding on any type of Linux server:

1. As the Linux root user, change to the /etc/init.d directory.

2. In a text editor, create a new file for a set of iptables commands, for example:

   gedit vibe-iptables

3. Copy and paste the following lines into the vibe-iptables file:

   iptables -t nat -A OUTPUT -d localhost -p tcp --dport 80 
                                          -j REDIRECT --to-ports 8080
   
   iptables -t nat -A OUTPUT -d hostname -p tcp --dport 80 
                                         -j REDIRECT --to-ports 8080
   
   iptables -t nat -A PREROUTING -d hostname -p tcp --dport 80 
                                             -j REDIRECT --to-ports 8080
   
   iptables -t nat -A OUTPUT -d localhost -p tcp --dport 443 
                                          -j REDIRECT --to-ports 8443
   
   iptables -t nat -A OUTPUT -d hostname -p tcp --dport 443 
                                         -j REDIRECT --to-ports 8443
   
   iptables -t nat -A PREROUTING -d hostname -p tcp --dport 443 
                                             -j REDIRECT --to-ports 8443
   
   iptables -t nat -A OUTPUT -d localhost -p tcp --dport 25 
                                          -j REDIRECT --to-ports 2525
   
   iptables -t nat -A OUTPUT -d hostname -p tcp --dport 25 
                                         -j REDIRECT --to-ports 2525
   
   iptables -t nat -A PREROUTING -d hostname -p tcp --dport 25 
                                             -j REDIRECT --to-ports 2525
   

   In this example, the lines are wrapped for readability. When you paste them into the text editor, if the lines are still wrapped, remove the hard returns so that you have six iptables commands, each on its own line.

4. Replace hostname with the hostname or IP address of the Vibe server.

5. Save the vibe-iptables file, then exit the text editor.

6. Use the following command to make the file executable:

   chmod +x vibe-iptables

7. Use the following command to immediately execute the commands in the vibe-iptables file:

   chkconfig vibe-iptables on

8. Use the following command to add vibe-iptables to future server boot initialization:

   chkconfig --add vibe-iptables

9. Use the following command to verify that the default browser ports (80 and 443) have been forwarded to the Vibe server ports (8080 and 8443) and that the default SMTP mail host port (25) has been forwarded to the Vibe internal mail host:

   iptables-save | grep REDIRECT

1. Download the OpenOffice.org software for Linux from OpenOffice.org to a convenient temporary location on the Vibe server.

2. Extract the contents of the downloaded file, then change to the subdirectory into which the software files have been extracted.

3. Run the OpenOffice.org Installation program.

   ./setup
   

4. Click Next to begin the installation.

5. Select Custom, then click Next.

6. Click the blue down-arrow to select all optional components for installation, then click Next.

   This includes the OpenOffice.org Java Runtime Environment (JRE) and other components required for document conversion.

7. Click Install Now.

   The OpenOffice.org software is installed to:

   /opt/openoffice.org3

8. Click Finish.

9. From the command line, manually start OpenOffice.org as the user who will also start the OpenOffice daemon:

   /opt/opneoffice.org3/soffice.bin
         -headless -nofirststartwizard
         -accept="socket,host=localhost,port-8100;urp;StarOffice.Service"
   

   If you are running OpenOffice.org in a headless environment, you must use the -nofirststartwizard option in this command.

   If you want to start OpenOffice.org with a wizard that gathers personal information, launch the program from your server’s graphical interface.

10. (Conditional) If you started OpenOffice.org with the graphical interface, provide the requested personal information in the wizard, then exit OpenOffice.org.

11. Continue with Running OpenOffice.org as the Document Converter for Vibe.

1. Use the following command to start the OpenOffice.org converters:

   /opt/opneoffice.org3/soffice.bin
         -headless -nofirststartwizard
         -accept="socket,host=localhost,port-8100;urp;StarOffice.Service"
   

   IMPORTANT:Execute the command as the same Linux user that runs Vibe.

2. Use the following command to verify that OpenOffice.org is running as a daemon:

   ps -eaf | grep soffice

3. Test HTML conversion on your Vibe site by viewing a document that has been added as a File Entry in your Vibe site.

4. Configure the Vibe server so that OpenOffice.org is always running as a daemon whenever Vibe is running.