4.1 Linux: Installing and Setting Up a Basic Vibe Site

1. Enter the following commands to stop Apache and Tomcat:

   /etc/init.d/tomcat5 stop
   /etc/init.d/apache2 stop
   

2. Enter the following commands to make sure that Apache and Tomcat do not start again when you reboot the server:

   chkconfig --del apache2
   chkconfig --del tomcat5
   

1. Create the Linux group that you want to own the Vibe software and data store directories:

   1. In YaST, click Security and Users > User and Group Management to display the User and Group Administration page.

   2. Click Groups, then click Add.

   3. Specify the group name, then click Accept or OK.

      The group does not need a password.

2. Create the Linux user that you want Vibe to run as:

   1. Click Users, then click Add.

   2. On the User Data tab, specify the user’s full name, username, and password, then select Disable User Login.

      Like any Linux system user, the Vibe Linux user does not need to manually log in. The Vibe Linux user does not need a password, either, but YaST requires you to provide one.

   3. Click the Details tab.

   4. In the Login Shell drop-down list, select /bin/false, because this user does not need to manually log in.

   5. In the Default Group drop-down list, select the Linux group that you created in Step 1.

   6. In the Groups list, select the Linux group that you created in Step 1.

   7. Click Accept or OK.

3. Exit YaST.

1. In a terminal window, enter su - to become the root user, then enter the root password.

   You need root permissions in order to install the Vibe software, but you should not run the Vibe software as root.

2. Change to the directory where you downloaded and extracted the Vibe software.

3. Make sure that you have a license-key.xml file in the same directory with the Vibe installation program.

   more license-key.xml

   The Vibe installation program does not start without a license file in the same directory. If you have not already, rename the license file to be called license-key.xml.

   For more information about licensing, see Section 6.0, Updating Your Vibe License.

4. Enter the following command to start the Vibe installation program:

   ./installer-teaming.linux
   

5. Accept the License Agreement, then click Next.

   

6. Click Next to accept the default of New installation.

   

7. Click Next to accept the default of Basic.

8. Use the information that you have gathered on the Basic Vibe Installation Summary Sheet to provide the information that the Vibe installation program prompts you for:

   • Installation Locations
   • Location of TrueType Fonts for Stellent Converters
   • Default Locale for Novell Vibe
   • User ID for Novell Vibe
   • Network Information
   • WebDAV Authentication Method
   • Database Selection
   •      Database Type
   •      JDBC URL
   •      Credentials
   •      Setup
   •      Encryption Algorithm
   • Java JDK Location
   • Outbound E-Mail Configuration
   •      Protocol
   •      Host, Port, and Time Zone
   •      Username, Password, and Authentication
   •      Allow Sending E-Mail to All Users
   • Inbound E-Mail Configuration

   The installation program stores the information it gathers in the installer.xml file in the same directory where you started the installation program.

9. After you have provided all the requested information, click Install to begin the Vibe installation.

10. When the installation is completed, click Finish to exit the Vibe installation program.

    Information about the installation process is written to the installer.log file in the same directory where you ran the Installation program. If a problem arises during the installation, the installer.log file provides information that can help you resolve the problem.

11. Continue with Section 4.1.5, Configuring Vibe to Start Automatically on Reboot.

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