CHAPTER 2 Installing Sun Messaging Connectivity Services Client Software

This chapter provides instructions for installing the SMCS cc: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 cc:Mail SMCS component, you must also install the appropriate client software. A windows-based setup is used to install the cc: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 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

You need to install cc:Mail Router 5.1 and above

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 cc: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 cc: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 cc: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.

FIGURE 2-2 PC Clients Setup Checkbox Screen

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

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 cc:Mail Client

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

Select the cc:Mail Channel.

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

Enter general mail parameters in the cc:Mail tab.

FIGURE 2-4 cc:Mail General Parameters Screen

Program Directory: The name of the PC directory containing the cc:Mail Import and Export programs, IMPORT.EXE and EXPORT.EXE. For example, T:\CCADMIN. The cc:Mail client does not allow filenames and directory names longer than eight characters. There is no default value for this parameter.

Data Directory: The name of the PC directory containing the cc:Mail postoffice (the MLANDATA file, or ccpombox for versions 5.x and 6.x. For example, T:\CCDATA. There is no default value for this parameter.

Postoffice: The name of the local cc:Mail post office residing in the cc:Mail data directory. There is no default value for this parameter.

Password: The password for the cc:Mail post office listed above. Do not confuse this with the password for the Administrator's mailbox. SMCS must know this password in order to use the cc:Mail Import and Export programs. There is no default value for this parameter.

Gateway Postoffice: The name of the remote cc:Mail gateway post office (specified on the server using the Administration Console) used to send messages to SMCS. There is no default value for this parameter. This parameter must match in the server and client configurations.

If you are the system administrator, you will have to create a cc:Mail `P' entry (a temporary repository/postoffice) for use by SMCS.

Gateway Postoffice Password: The password for the cc:Mail post office listed above. Do not confuse this with the password for the Administrator's mailbox. SMCS must know this password in order to use the cc:Mail Import and Export programs. There is no default value for this parameter.

FIGURE 2-5 cc:Mail Global Parameters Screen

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

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

FIGURE 2-6 cc:Mail Tranport 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 SMCS server. If you have installed SolarNet Postoffice and want to figure out the server machine's SPX address, use the /opt/SUNWefps/sbin/ipxstat -i command. If TotalNet Advanced Server is installed, use /opt/totalnet/sbin/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. (What does this map to on the server end?)

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 cc:Mail channel's Transport tab (under SPX). The default value is SPXSRV.

Client Name: The Client 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 cc:Mail channel's Transport tab (under SPX). The default value is CCMAICLI.

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.

Select the Directory Sync Tab and enter cc:Mail parameters.

FIGURE 2-7 cc:Mail Directory Sync Parameters Screen

Channel Name: SMCS's channel name for this channel. It should match the name used by the Administration Console for this cc:Mail channel that you created.

Description: A free-form text description of the channel being configured.

Export Schedule: The time interval between cc:Mail export operations. The default is one export per day (1d). Time intervals must be set in 5 minute increments. Keep in mind these files might be large, so schedule intervals accordingly. Days are based on standard 3-letter abbreviations. Hours are based on a 24-hour clock.

Other formats include:

Monthly on [days] at [hh:mm]

Weekly on [days] at [hh:mm]

Daily at [hh:mm]

Hourly at [:mm]

For example, to establish an export schedule of one export per hour, indicate the following: Hourly at :00.

Import Schedule: The time interval waited before checking for a cc:Mail update to import. Time intervals must be set in 5 minute increments. At each interval time, SMCS looks for an update, and if it finds one, it begins the import operation. The default is one import per day (1d).

Other formats include:

Monthly on [days] at [hh:mm]

Weekly on [days] at [hh:mm]

Daily at [hh:mm]

Hourly at [:mm]

For example, to establish an import schedule of one import per day 30 minutes after midnight, indicate the following: Daily at 00:30.

Administrator: The address of the cc:Mail users to receive status messages and error reports. The format is a valid cc:Mail address, such as admin. For sending status reports to more than one mailbox, separate addresses with spaces and the word AND, for example, admin and robert smith. The default value for this parameter is admin.

Note - This is the SMCS admin only and not the post office admin. We recommend a user name without a space. For example, SMCSAdmin.

Remote Address: The mail address of the user who is to receive update messages. The format is a valid cc:Mail address. There is no default value. The remote address is created by adding the host and gateway post office addresses specified using the following syntax:

[channelname]@dsm.[host] AT [gateway post office]

For example, this can be:

ccmailt@dsm.tin.eng.alpha.com at internet

Note - dsm is the Directory Service Manager that is running on your server machine.

Click on OK to save changes and exit cc: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 cc:mail directory:

cd c:\SMCS\ccmail

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:

>ccclient

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

The following cc:Mail directory synch scheduler application automates directory imports

and exports at selected time intervals:
dassist.exe
The following is the directory sync schedule utility used for cc:Mail.
sched.exe