You should already have reviewed Section 3.0, Planning a Basic Teaming Installation and filled out the Basic Teaming Installation Summary Sheet. The following sections step you through the process of installing and starting Novell Teaming on Linux.
Make sure that the Linux server where you plan to install Teaming meets the system requirements listed in Section 2.1, Teaming Server Requirements.
In a terminal window, become root by entering su - and the root password.
Set the Linux open file limit to meet the needs of the Teaming software:
Open the /etc/security/limits.conf file in an ASCII text editor.
Add the following lines to the bottom of the list, following the format of the example lines:
* hard nofile 65535 * soft nofile 4096
Save the file, then exit the text editor.
Perform the following conditional tasks if needed:
For example, to stop the Apache Web server and its associated instance of Tomcat:
Enter the following commands to stop Apache and Tomcat:
/etc/init.d/tomcat5 stop /etc/init.d/apache2 stop
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
If the user and group that you want to use for Teaming, as described in Section 3.8.2, Linux User ID for Teaming do not exist yet, create them. It is easier if you create the group first.
Create the Linux group that you want to own the Teaming software and data store directories:
In YaST, click
to display the User and Group Administration page.Click
, then click .Specify the group name, then click
or .The group does not need a password.
Create the Linux user that you want Teaming to run as:
Click
, then click .On the
tab, specify the user’s full name, username, and password, then select .Like any Linux system user, the Teaming Linux user does not need to manually log in. The Teaming Linux user does not need a password, either, but YaST requires you to provide one.
Click the
tab.In the
drop-down list, select , because this user does not need to manually log in.In the Step 1.
drop-down list, select the Linux group that you created inIn the Step 1.
list, select the Linux group that you created inClick
or .Exit YaST.
When you run the Novell Teaming Installation program for the first time, you typically want to use the GUI interface. However, if you are installing Teaming on a server where the X Window System* is not available, a text-based Installation program is also available. After you are familiar with the Teaming installation process, you can use a silent installation to automate the process.
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 Teaming software, but you should not run the Teaming software as root.
Change to the directory where you downloaded and extracted the Teaming software.
Make sure that you have a license-key.xml file in the same directory with the Teaming Installation program.
more license-key.xml
The Teaming Installation program does not start without a license file in the same directory, and the license file has a different name when you download it.
For more information about licensing, see Section 6.0, Updating Your Teaming License.
Enter the following command to start the Teaming Installation program:
./installer-teaming.linux
Accept the License Agreement, then click
.Click
to accept the default of .Click
to accept the default of .Use the information that you have gathered on the Basic Teaming Installation Summary Sheet to provide the information that the Teaming Installation program prompts you for:
The Installation program stores the information it gathers in the installer.xml file in the same directory where you started the Installation program.
After you have provided all the requested information, click
to begin the Teaming installation.When the installation is completed, click
to exit the Teaming 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.
Continue with Section 4.1.3, Configuring Teaming to Start Automatically on Reboot.
If you try to start the GUI Teaming Installation program in an environment where the X Windows System is not running, the text-based Teaming Installation program starts instead.
If you want to use the text-based Installation program in an environment where it is starting with a GUI by default, use the following command in the directory where the Installation program is located:
./installer-teaming.linux --text
IMPORTANT:The text-based Teaming Installation program must be run in the same directory where the Teaming license file is located. If the license file is not in the same directory, the text-based Installation program cannot find it.
The text-based Installation program gathers the same configuration information as the GUI Installation program does. This information is stored in the installer.xml file in the directory where you run the Installation program.
The Installation program does not write the information it gathers into the installer.xml file until you exit the Installation program, and you cannot back up when using the text-based Installation program. Therefore, when you use the text-based Installation program, you should plan you installation carefully in advance, using the Basic Teaming Installation Summary Sheet or the Advanced Teaming Installation Summary Sheet. If you make a mistake during the installation, continue to the end of the installation process and exit the Installation program normally, so that all information is saved. Then run the text-based Installation program again. Your previous information is supplied as defaults and you can change the information as needed.
If your Novell Teaming system expands beyond one server, you might need to repeatedly install the same Teaming components. A silent installation makes this an easy process. Edit an existing installer.xml file so that it has the hostname of the server where you want to perform the silent installation and copy it to that server. In the directory where the Installation program is located. use the appropriate command to run the Teaming installation program, depending on the action that you want the silent installation to perform:
./installer-teaming.linux --silent --install ./installer-teaming.linux --silent --upgrade ./installer-teaming.linux --silent --reconfigure
The Installation program obtains all the information it needs from the installer.xml file and completes the installation without user interaction.
You can configure Novell Teaming to start automatically each time you reboot the Linux server.
As the Linux root user, enter the following command:
chkconfig --add teaming
To verify that automatic startup is turned on, enter the following command:
chkconfig teaming
In order to make Novell Teaming available on the default HTTP/HTTPS ports of 80 and 443, you must set up port forwarding in order to forward the browser default ports (80 and 443) to the Teaming server ports (8080 and 8443). In addition, you must set up port forwarding if you want to forward the default SMTP mail host port (25) to the default Teaming internal mail host port (2525).
You can set up port forwarding in one of two ways, depending on whether or not you are using the Teaming server as a firewall.
To enable port forwarding on a SUSE Linux server that leverages SuSEfirewall2:
As the Linux root user, open the following file:
/etc/sysconfig/SuSEfirewall2
Find the following line:
FW_REDIRECT=""
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
Replace ip_address with the IP address of the Teaming server.
Save the SuSEfirewall2 file, then exit the text editor.
Use the following command to restart the firewall:
/sbin/SuSEfirewall2 start
Use the following command to verify that the default browser ports (80 and 443) have been forwarded to the Teaming server ports (8080 and 8443) and that the default SMTP mail host port (25) has been forwarded to the Teaming internal mail host:
iptables-save | grep REDIRECT
Now, users do not need to include a port number in the Teaming site URL.
To leverage iptables commands to enable port forwarding on any type of Linux server:
As the Linux root user, change to the /etc/init.d directory.
In a text editor, create a new file for a set of iptables commands, for example:
gedit teaming-iptables
Copy and paste the following lines into the teaming-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 from the middle of the commands, so that you have six iptables commands, each on its own line.
Replace hostname with the hostname of the Teaming server.
Save the teaming-iptables file, then exit the text editor.
Use the following command to make the file executable:
chmod +x teaming-iptables
Restart the firewall to put the iptables commands into effect:
Click
.Click
, click , then click .Exit YaST, then return to the terminal window where you are logged in as root.
Use the following command to verify that the default browser ports (80 and 443) have been forwarded to the Teaming server ports (8080 and 8443) and that the default SMTP mail host port (25) has been forwarded to the Teaming internal mail host:
iptables-save | grep REDIRECT
Now, users do not need to include a port number in the Teaming site URL.
The Novell Teaming Installation program created a teaming startup script in the /etc/init.d directory.
In a terminal window, become root by entering su - and the root password.
Enter the following command to start Teaming:
/etc/init.d/teaming start
You must execute the teaming script as root, but the script runs Teaming as the user you selected in Section 3.8.2, Linux User ID for Teaming and specified during installation.
You should see output similar to the following example:
Using CATALINA_BASE: /opt/teaming/apache-tomcat-6.0.18 Using CATALINA_HOME: /opt/teaming/apache-tomcat-6.0.18 Using CATALINA_TEMPDIR: /opt/teaming/apache-tomcat-6.0.1/temp Using JRE_HOME: /use/java/jdk1.5.0_17/jre
To make sure that Teaming is ready for work:
Change to the following directory:
/opt/novell/teaming/apache-tomcat-version/logs
where version is the version number of Tomcat that was installed along with Teaming (for example, 6.0.18)
Enter the following command to display the end of the Tomcat log:
tail --f catalina.out
At the end of the log file listing, you should see:
INFO: Server startup in nnnn ms
Press Ctrl+C when you are finished viewing the end of the catalina.out file.
You can see if Novell Teaming is running by checking for its process ID (PID).
In a terminal window, enter the following command:
ps -eaf | grep teaming
You should see the Teaming PID number, along with a listing of configuration settings.
You need to restart Novell Teaming whenever you use the Teaming Installation program to make configuration changes, as described in Section 10.0, Performing an Advanced Teaming Installation.
As root in a terminal window, enter the following command:
/etc/init.d/teaming restart
You should see the same output as when you originally started Teaming.
As root in a terminal window, enter the following command:
/etc/init.d/teaming stop
You should see the same output as when you started Teaming.
To verify that Teaming has stopped, check for its PID number:
ps -eaf | grep teaming
The Teaming PID number, along with a listing of configuration settings, should no longer be displayed.
If you move the Novell Teaming site to a different server, you can delete the Teaming files from the original server to reclaim disk space. The default Teaming file locations are:
Teaming Software |
/opt/novell/teaming |
Teaming File Repository and Lucene Index |
/var/opt/novell/teaming |
MySQL Database |
/var/lib/mysql |
For a complete list of your Teaming files, check the installer.xml file in the directory where you originally ran the Teaming Installation program.