CHAPTER 2 Installing Sun Messaging Connectivity Services Client Software

This chapter provides instructions for installing the SMCS Microsoft Mail client as needed, discusses the basic setup to enable directory synchronization, and provides instructions for configuring LAN clients for directory synchronization. Since not all channels require client software, this chapter may not apply to you. If you are installing the Microsoft Mail Channel SMCS component, you must also install the appropriate client software. A windows-based setup is used to install the Microsoft Mail client. The SMCS client is a 16 bit DOS application.

Note - To prepare for installation, it is recommended that you complete the PC Client Install Worksheet, included as Appendix A.

LAN Client System Requirements

Each client must be configured to match settings of its corresponding SMCS channel on the server. These channels use a client program running on a PC to transfer messages between a Microsoft Mail post office and SMCS. This software can be installed on any PC with access to post offices on the network.
Before installing PC client software, please make sure:
You installed the corresponding mail programs for all of the clients you intend to install.

Make sure the system is running DOS and Windows or Windows NT

If you plan to install the Microsoft Mail client, you installed the SMTP Gateway programs supplied by Microsoft.

If you plan to use the SPX Transport, you need to note the SPX address of the SIMS host. Refer to the the Sun Internet Mail Server 3.5 Installation Guide for this information.

Running LAN Clients

For SMCS to exchange mail with Microsoft Mail via SPX, the proper application must be running. Client applications may be started manually, or via a batch file.

Note - For more information on using PC client applications, see the "Managing Channels" chapter of the Administrator's Guide.

Installing LAN-Based Clients

LAN-based clients are installed and configured using the PC setup application. This application is distributed on CD ROM. The self extracting file solstice.exe is the SMCS front end installation file for MS Mail channels. It contains the SMCS client setup.exe program. This file needs to be executed on a PC. The location of this file on the CD is:
/products/sims/win16/solstice.exe
The CD has a Windows 95/NT readable partition which will allow you to copy this file into a DOS/Windows based system.

Note - The Windows-based setup.exe application is used to install the Microsoft Mail client. Setup.exe appears in the Program Manager window.

After client setup is complete, the setup application is installed in a Windows program group so that you can revise your PC clients setup as needed.
To install the client setup program, do the following:

FIGURE 2-1 PC Clients Setup Welcome Message Screen

Choose Continue.

Indicate that you want to install the Microsoft Mail channel.

Note - You can install both Microsoft Mail and cc:Mail on the same PC.

FIGURE 2-2 PC Clients Setup Checkbox Screen

FIGURE 2-3 Installation Directory Screen

Starting Lan-Based Clients Automatically

You can create an icon to add to the Startup menu so that SMCS will automatically start when you reboot your Microsoft Windows 95 or NT system. To do so, perform the following steps:

Create an icon for the executable from the Program Manager window.

Add the icon to the Startup window.

SMCS will automatically start on reboot.

Configuring the Microsoft Mail Client

From Windows, start the Clients configs application by double-clicking on the set-up icon in the Solstice PC Clients program group.

Select the Microsoft Mail Channel.

If you are configuring more than one type of LAN channel, you can select multiple channels. If you select more than one channel, the program configures each channel in sequence.

FIGURE 2-4 MS Mail General Parameters Screen

Program Directory: The name of the PC directory containing the MS-Mail executable programs.

Data Directory: The name of the PC directory containing the MS-Mail post office files.

User Name: The SMCS administrative user name used to exchange messages with SMCS.

Password: The password for the user name listed above.

FIGURE 2-5 MS Mail Global Parameters Screen

Polling Interval: An interval value in minutes for exchanging messages with SCMS. The recommended value is 1 minute.

Maximum Log Days: Enter the maximum number of days to maintain logs for the MS-Mail client.

FIGURE 2-6 MS Mail Transport Parameters Screen

If you are using the SPX Transport, click on Use SPX, and enter the following parameters:

SPX Address: The address of the SPX server for the Solaris system. If SunNet PC is installed, use the opt/SUNWefps/sbin/ipxstat -i command to figure out the server machine's SPX address.If TotalNet Advanced Server is installed, use /opt/totalnet/bin/tnistat -i. For example, on a machine called tin, the results of the command can be as follows:

Name          Address                Ipkts   Ierr Opkts  Oerr

i_00000001    807980ac:000000000001  4833650 2478 4788939 0

The Address field contains the SPX address, 807980ac:000000000001. Specify this address either in hexadecimal or in decimal format.

Server Socket: The port number used for SPX by the server. The default value is 8000, which is appropriate for most SPX transport configurations. This maps to the server address on the server.

Server Name: The SPX name of the server. This parameter can contain from 1 to 8 alphanumeric characters, and must match the Server name specified using the Administration Console in the MS-Mail channel's Transport tab (under SPX). The default value is SPXSRV.

Client Name: The SPX name of the PC. This parameter can contain from 1 to 8 alphanumeric characters, and must match the Client name specified using the Administration Console in the MS-Mail channel's Transport tab (under SPX). The default value is MSMAICLI.

If you are using File Sharing, click on Use File Sharing, and enter the following parameter:

Root Directory: The shared server directory used to exchange mail files.

FIGURE 2-7 MS Mail Directory Sync Parameters
Provide information on the following directory synch parameters:
Updates-from Address: Enter the name of the address that is the source for MS Mail updates. The syntax is as follows:
SMTP:[channelname]@dsm.[hostname.domain]
An example is as follows:
SMTP:msmail@dsm.tin.eng.alpha.com
Updates-to Address: Enter the name of the address where MS-Mail updates will be sent. The syntax is as follows:
SMTP:[channelname]@dsm.[hostname.domain]
An example is as follows:
SMTP:msmail@dsm.tin.eng.alpha.com

Note - Hostname is equal to [machinename].[domain]

Click on OK to save changes and exit the MS-Mail setup.

If more than one channel was selected, Setup displays configuration tabs for the next channel client to be configured.

Run the client program to verify that the channel connection worked as planned.

To do so, follow these steps:

Change directories (cd) where you have installed the software:

cd c:\SMCS

Change directories (cd) to the MS-Mail directory:

cd c:\SMCS\msmail

Note - If you installed cc:Mail and Microsoft Mail at the same time, make different directories for each one. If you put one in the same directory as the last one that was installed, the original configuration file will be overwritten with the latest one.

At the prompt, run the client:

>msclient

You will see an error message, No route to host, if you have specified an inaccurate address.

Change any information in the configuration that is inaccurate.

Double-click on the Client Configuration icon. This will display your old configuration parameters that you can modify. After modifying your old responses, click on ok to register your new input.

Applications

For Internet Message Transfer Agent (IMTA) to exchange mail with Microsoft Mail via SPX, the proper application must be running. Client applications can be started manually or via a batch file. Some client applications might be run continuously, using a batch file. The following Microsoft Mail client application exchanges messages between email systems and Microsoft Mail:
msclient.exe

Note - Use msclient.exe -1 to run a DOS machine.

The following Microsoft Mail directory synch scheduler application automates directory imports and exports at selected time intervals:
msvexp.exe
To automatically reboot on a DOS machine, insert a line in the autoexec.bat file. In Windows 95/NT, create a Microsoft Client icon in the Program Menu.