You should have already reviewed Planning Your Novell Messenger System and filled out the worksheet. The following sections guide you through the installation process:
IMPORTANT: If you are setting up your Novell Messenger system in a cluster, see the appropriate section of the GroupWise 6.5 Interoperability Guide before beginning to install Novell Messenger:
Before starting the Messenger Installation program, make sure that your system has been prepared for the Messenger system configuration for which you have planned:
Follow the setup instructions for the platform where you are creating your Messenger system:
At a Windows workstation or server, insert the Novell GroupWise Messenger CD.
Click Start > Run.
Enter d:\setup.exe (where d is your CD drive) to display the main Novell Messenger Installation page.
Click Install Server.
Select the language in which you want to run the Installation program, then click OK.
Click Yes to accept the License Agreement.
Continue with Creating Your Messenger System.
The Installation Options page lets you select what type of installation you want to perform.
Throughout the installation process, you can refer to the Installation Guide by clicking Installation Guide in the lower left corner of each Installation program page.
Select Create or Update a System, then click Next to display the Server Information page.
Select NetWare or Microsoft Windows Server.
If you selected Microsoft Windows Server, set the Windows server options as planned under item 2 of the worksheet.
Specify the directory path or browse to and select the directory where you want to install the Messenger agents as planned under item 3 of the worksheet, then click Next to display the System Configuration page.
Provide the Messenger system configuration information as planned under item 4 through item 6 on the worksheet, then click Next to display the Installation Components page.
Leave all the components selected for your initial Messenger installation, then click Next.
If you are installing the Windows Messenger agents and selected to install them as Windows services, the Windows Service Options page appears.
For the Windows Messenger agents, provide the Windows service information as planned under item 8 on the worksheet, then click Next to display the Directory Access page.
If eDirectory is installed on the server, the Replica Address field does not appear.
Provide the eDirectory access information as planned under item 9 on the worksheet, then click Next to display the Directory Authentication page.
Provide the eDirectory authentication information as planned under item 10 on the worksheet, then click Next to display the User Configuration page.
The context of the eDirectory user is automatically added to the context list.
If necessary, click Add, then browse to and select another user context as planned under item 11 on the worksheet.
If necessary, select Include Subcontexts if User objects exist in nested container objects beneath the selected context.
IMPORTANT: If you do not select Include Subcontexts, User objects in containers beneath the selected context are not considered part of your Messenger system.
Click OK to add the context to the contact list.
Repeat Step 10 through Step 12 for each context where User objects reside, then click Next to display the Server Address page.
Verify the IP Address or DNS Host Name of the server where the agents will run, and the port number that each agent will use as planned under item 12 on the worksheet.
If the NetWare server you are installing to is already part of an existing cluster, select Configure Agents for Clustering.
Click Next to display the Security Configuration page.
If planned under item 15 on the worksheet, select Enable SSL and specify the necessary information, then click Next to display the Admin Configuration page.
If ConsoleOne 1.3.4 is already installed, verify the path.
or
If ConsoleOne 1.3.4 is not already installed, click Install ConsoleOne to update ConsoleOne, then follow the prompts until you return to the Admin Configuration page.
Click Next.
If you are installing Messenger in a cluster, see the appropriate section of the GroupWise 6.5 Interoperability Guide for additional instructions:
Continue with Installing the Messenger Software.
The installation summary lets you review the information you have provided before the installation actually begins.
Review the summary of the selections you have made.
If necessary, click Back to change information as needed before proceeding with the installation.
Click Next to begin the installation.
When the installation is complete, you can choose to view the Readme, start the Messenger agents immediately, and, for the NetWare Messenger agents, update the autoexec.ncf file so that the Messenger agents will start automatically whenever the server restarts.
Select one or more post-installation options, then click Finish.
Continue with What's Next.
At the Linux server, become root by entering su and the root password.
Change to the /server directory on the Novell GroupWise Messenger for Linux CD.
Enter the following:
./install.sh
Press Enter to continue and display the license agreement.
Press Enter or Spacebar to scroll through the license agreement. At the end of the license agreement, enter y to accept the agreement, or enter n to not accept the license agreement.
If you accept the license agreement, the necessary .rpm files are installed to the server. Enter y to continue with the installation.
Continue with Configuring Your Messenger System on Linux.
After the packages are installed, enter y to configure the Messenger system.
The following options are displayed:
Enter 1 to create a new system.
The following options are displayed:
Enter 1 or 2 (worksheet item 9).
If eDirectory is not installed on the Linux server, only the option for using LDAP is displayed.Continue with the next step.
If you selected LDAP in Step 3, enter the following information: the IP address of the LDAP server, y or n to select whether or not to use SSL, and the port of the LDAP server (worksheet item 9).
If you select to use SSL, you next need to enter the path to the LDAP server's root certificate (worksheet item 15). For more information, see Messenger System Security.
or
If you selected direct access, enter the following information: the name of the eDirectory tree to extend and create objects in, and the replica address for that tree (IP address of the server running eDirectory) (worksheet item 9).
Enter the context to create the objects in, for example, ou=linuxsystem,o=novell (worksheet item 5).
Enter the Messenger system object name (worksheet item 6).
You can press Enter to accept the default name of MessengerService.
Enter the Messenger server object name (worksheet item 6).
You can press Enter to accept the default name, which is the Linux server name plus the word server.
Enter the full context of the directory user object that will be used by the agents to access the directory, for example, cn=admin,ou=linuxsystem,o=novell (worksheet item 10).
For more information, see eDirectory Access and Authentication.
Enter the password for this user twice (worksheet item 10).
Enter the default contexts where Messenger will authenticate and search for users. For example, ou=linuxsystem,o=novell (worksheet item 11).
For more information, see Messenger User Locations.
Enter the IP address of the Linux server (worksheet item 12).
A summary of the information you supplied is displayed.
Enter y to continue with the installation.
After the installation and configuration are complete, enter n to not start the agents at this time.
Continue with Configuring the Linux Messenger Agents for SSL.
The Messenger Cross-Platform client requires an SSL connection with the Messenger agents. If you are not already familiar with SSL, or if SSL is not already set up on your system, you can add SSL security to your Messenger system, as described in "Establishing Messaging Security with SSL Encryption" in "Managing the Messaging Agent" in the Messenger 1.0 Administration Guide.
NOTE: The Messenger Windows client does not require an SSL connection with the Messenger agents.
The required SSL connection is most easily configured in ConsoleOne. On Linux, ConsoleOne does not automatically authenticate to any eDirectory trees when it starts, so the NDS object is not immediately expandable.
In ConsoleOne, select NDS, then click File > Authenticate.
Fill in the following fields:
Login Name: Provide a Novell eDirectory username that has rights to modify eDirectory objects.
Password: Provide the password for the username.
Tree: Type or select the eDirectory tree where you created your Messenger system.
If the eDirectory tree is located on a Windows server, you might need to specify the IP address of the server instead of the tree name.
Context: Provide the full context of the User object associated with the username you provided.
Click Login.
Under the NDS object, select the tree where you created your Messenger system.
Browse to and right click the Server object in your Messenger system, then click Properties.
Click Server > Security.
Fill in the fields (worksheet item 15).
Click OK to save the security settings.
Continue with Starting the Linux Messenger Agents.
To start the agents manually, use the startup scripts provided in the /etc/init.d directory.
Change to the /etc/init.d directory.
To start the Messaging Agent, enter the following command:
./novell-nmma start
To start the Archive Agent, enter the following command:
./novell-nmaa start
You can also use the stop, restart, and status options for these agents from the same directory.
Messenger agent log files are created in /var/opt/novell/log/messenger directory. The Messenger agents can be monitored using the agent Web consoles from your Web browser, as described in "Using the Messaging Agent Web Console" in "Managing the Messaging Agent" in the Messenger 1.0 Administration Guide.
For additional agent startup alternatives, see "Starting the Messaging Agent" and "Starting the Archive Agent" in the Messenger 1.0 Administration Guide.
If you want to be able to download the Windows Messenger client from your Linux Messenger system, continue with Setting Up the Windows Client Download from a Linux Messenger System.
or
Skip to What's Next.
Messenger 1.0 for Linux does not include the Windows Messenger client. If you want Messenger users to be able to download the Windows Messenger client software from your Linux Messenger system, you must manually copy the Windows Messenger client files to the appropriate location on the Linux server.
If you did not use the Linux Messenger Installation program to set up your Messenger system on Linux (for example, you manually installed the RPMs), you must manually copy the Linux and Macintosh client files to the appropriate location on the Linux server so that they will be available for download by Messenger users.
If you have installed a Linux Messenger system, the Messenger Windows client software is not copied to the server. You need to copy the files from your Novell GroupWise Messenger CD.
Open a new terminal window.
Create a directory for the Windows client files by entering the following command:
mkdir -p /opt/novell/messenger/software/client/win32
Copy the Windows client files from /client/win32/* on the Novell GroupWise Messenger CD to this directory by entering the following command:
cp -r mount_point/client/win32/* /opt/novell/messenger/software/client/win32
where mount_point is the full path to the directory where you have mounted the Novell GroupWise Messenger CD.
Restart the Messaging Agent so that the Windows client extractor (nvlmsgr.exe) can be built.
Change to the /etc/init.d directory.
Enter the following command:
./novell-nmma start
Skip to What's Next.
If you copied both the server and client directories to your server before you performed the server installation, the server installation program copies the files for the Linux client to the appropriate directory on your server, and configures the Linux client executable with the IP address and port of the Messenger system. If the client directory was not copied to your server, you need to copy and configure these files manually.
To make the Linux Messenger client software available for download by users:
Open a new terminal window.
Create a directory for the Linux client files by entering the following command:
mkdir -p /opt/novell/messenger/software/client/linux
Copy the Linux client files from /client/xplat/linux/* on the Novell GroupWise Messenger for Linux CD to this directory by entering the following command:
cp -r mount_point/messenger/client/xplat/linux/* /opt/novell/messenger/software/client/linux
where mount_point is the full path to the directory where you have mounted the Novell GroupWise Messenger for Linux CD.
If you need to change configuration information for the Linux Messenger client, continue with Configuring the Linux Client Executable with IP Address and Port Information
or
Skip to What's Next.
To configure the Linux client executable file you have manually copied, or to change the configuration information so that it points to a different Messenger system, complete the following:
Open a new terminal window.
Change to the /opt/novell/messenger directory.
Enter the following:
./configure-client-installer.sh
Supply the IP address and port information that you want the clients to point to.
Skip to What's Next.
If you copied both the server and client directories to your server before you performed the server installation, the server installation program copies the files for the Macintosh client to the appropriate directory on your server. If the client directory was not copied to your server, you need to copy these files manually.
To make the Linux Messenger client software available for download by users:
Open a new terminal window.
Create a directory for the Macintosh client files by entering the following command:
mkdir -p /opt/novell/messenger/software/client/mac
Copy the Macintosh client files from /client/xplat/mac/* on the Novell GroupWise Messenger for Linux CD to this directory by entering the following command:
cp -r mount_point/messenger/client/xplat/mac/* /opt/novell/messenger/software/client/mac
where mount_point is the full path to the directory where you have mounted the Novell GroupWise Messenger for Linux CD.
Continue with What's Next.