This appendix provides reference information on configuring your cc:Mail channel on the server and client end. It helps ensure that the parameters are configured correctly on the server and the client to permit email transactions:

Install SIMS using the setup or setup-tty installation program. For details, refer to the Sun Internet Mail Server (SIMS) 3.5 Installation Guide.

Check the box provided for installing SMCS during installation.

Start the Administration Console on the mail server.

In order to create an SMCS channel, click on the IMTA icon seen on the main Administration Console screen.

For detailed information on each channel, refer to other relevant chapters in this manual (the Sun Messaging Connectivity Services cc:Mail Channel Configuration Guide).

The entries marked in BOLD in the tables are important, and it is essential to make sure that these entries match both on the client as well as the server side.

Pay particular attention to the entries marked with an asterisk. The asterisk indicates that the information you need to provide for these entries must be derived.

---

Note - If you are not sure what the value should be, you can retain the default values, if a default is provided.

---

cc:Mail Configuration

To configure a cc:Mail channel successfully the following parameters need to be addressed. TABLE A-1 lists the fields that need to match on the server and the client side. If your input does not match, the connection between the client and the server will fail.

TABLE  A-1   cc:Mail Required Matching Entries on the Server and the Client

Server-Side Entries	Client-Side Entries
Channel Name	Channel Name
Gateway Postoffice	Gateway Postoffice
Server Name	Server Name
Client Name	Client Name
Server Address	Server Socket
Shared Directory	Root Directory

TABLE A-2 and TABLE A-2 list the significance of the server and client parameters, their possible values, and examples. Parameters that need to match on both the server and client end are shown in boldface type. They provide a worksheet to enable you to compile configuration information prior to beginning your installation session.

To use this worksheet, copy it, and fill in the last column with configuration information specific to your site. When all pages are complete, use the information to configure each screen as presented by the Administration Console or the Client installation software.

cc:Mail Server-Side Parameters

Following is a listing of the server-side parameters. Complete this worksheet before you begin the installation of the cc:Mail server.

TABLE  A-2   cc:Mail Server Parameters and Worksheet

Server-Side Parameters	Description	Example	Your Parameters
Channel Name	The Channel Name is the name of your cc:Mail channel and should match the value on client side.	ccmailt	Refer to the channel name parameter listed in TABLE A-2. Fill in the same information in this parameter.
Restart Automatically	If selected, it starts the channel on SMCS startup. If you do not select this option, you must manually start the channel from the Administration Console.	3	Indicate your setting in the provided checkbox: o
Retain Processed Messages	Messages are normally deleted from queues after they are handled. Checking this parameter keeps a copy of each message in the queue even after the message has been delivered. Since processed messages are preserved, you can troubleshoot any problems at a later time.	3	Indicate your setting in the provided checkbox: o
Lookup Addresses in Directory	If this parameter is checked, the addresses in messages processed by this channel will be looked up in the directory. Without the directory lookup facility all the messages must contain fully qualified SMCS addresses in order to be delivered.	3	Indicate your setting in the provided checkbox: o
Poll Interval (in minutes)	This indicates how often you want the cc:Mail client to check for messages. Enter your value in minutes.	1	Choose your poll interval from the pull down menu.
Alias User Name Format	This controls the format of the user name alias automatically generated when a new user is added to the directory. The rule is formed using strings and variables which represent name attributes stored in the directory. $g Given Name $i Initials $s Surname $q Generation Qualifier	$g $i $s $q	Fill in your response in the provided text field.
Header Style	The header styles control the placement of headers within a message; whether at the top or at the bottom. To view different values click on the box right next to the Header Styles label. The default style is All at Top, None at Bottom.	All at Top, None at Bottom.	Choose the header style from the pull down menu.
Default Character Set	Default character set specifies the character set to be assigned to text body parts that do not contain character set information.	IBM-437	Choose the default character set from the pull down menu.
Gateway Postoffice	Indicate the name of the cc:Mail gateway node used by SMCS. You must add this post office directory entry manually to SMCS, not the name of the actual cc:Mail Post Office (where user mail boxes reside). This parameter must match the Gateway Node on the client side. Check with the cc:Mail system administrator to find out the name of the post office.	SMCS	Refer to the gateway postoffice parameter listed in TABLE A-2. Fill in the same information in this parameter.
Server Name	Indicate the name of SPX server for this channel. This parameter must match the Server Name provided on the PC (client) side of the link.	SPXSRV (this is the default value for this parameter)	Fill in your response in the provided text field. Retain the default value if you are unsure. Copy this information in the server name parameter listed in the client configuration table, TABLE A-2.
Client Name	Indicate the SPX name of the PC. This can be from 1-8 alphanumeric characters and must match the Client Name on PC side of the link. If you have more than one MS-Mail channel, choose a unique name for each channel.	CCMAICLI (this is the default value for this parameter)	Refer to the client name parameter listed in TABLE A-2. Fill in the same name in this parameter. Retain the default value if you are unsure.
Server Address	Indicate the hexadecimal socket number used by the SPX server. The default SPX socket number is 8000. Valid ranges are 0001-0BB8 and 8000-FFFF. If you change the default value, you must also specify the new Server Socket on the client side.	8000	Fill in your response in the provided text field. Retain the default value if you are unsure. Copy this information in the server socket parameter listed in the client configuration table, TABLE A-2.
Shared Directory	Fill out this information if you have selected the Fileshare transport and not SPX. This field specifies the name of the directory to use for file sharing. This directory must be accessible for read and write by the cc:Mail client PC using File Sharing. This should match the Root Directory on the client side.	/share/ccmail	Fill in your response in the provided text field. Copy this information in the root directory parameter listed in the client configuration table, TABLE A-2.
Directory Synchronization	In order to select a type of directory synchronization click on the button next to the label that says Directory synchronization on the channel configuration page. You have four choices when it comes to directory synchronization: None--This indicates that you do not want this channel to participate in any directory synchronization processes. Full--The very first time you create and configure a channel, choose this option to participate in a thorough, complete directory synchronization process. Since this entails a comprehensive synchronization procedure, it is time consuming. Full Foreign--This option helps resynchronize channels apart from the current channel. For instance, though your MS-Mail channel may already be synchronized, your cc:Mail, NJE/PROFS, or ldap channels may not be. By choosing this option, the directory information for the other channels will also be synchronized.	Full	Indicate your directory synchronization choice from the pull down menu.
	Incremental--After your channel participates in a full directory synchronization process, to register any subsequent directory changes, choose this option. It helps incorporate your directory changes and resynchronize the directory information.
Client Address*	Enter the client address. This will be of the form: cc:Mailadmin@postoffice.channelname.localhostname	admin@ccmail.ccmailt.tin.eng.alpha.com	Fill in your response in the provided text field.
Copy New/Deleted Entries	When the directories are synchronized, both parameters specify how the propagation of new or deleted entries flow to and from the directory. To select an option, click on the box next to propagation label. Retain the default values if you are unsure. To Central Directory (CD): This enables you to copy any new or deleted directory information from the channel directories (also known as the subordinate or slave directories) to the central directory (also known as the LDAP directory). From Central Directory: This enables you to copy any new or deleted directory information from the central directory (also known as the LDAP directory) to the channel directories (also known as the subordinate or slave directories). Bi-directional: Changes made to either the central or the channel directories are propagated to and from both directories.	Bi-directional	Choose to propagate new/deleted entries in directory from the pull down menu.
Copy Modified Entries	When the directories are synchronized, this parameter specifies how the propagation of modified entries flow to and from the directory. To select an option, click on the box next to propagation label. Retain the default values if you are unsure. To Central Directory (CD): This enables you to copy any modified directory information from the channel directories (also known as the subordinate or slave directories) to the central directory (also known as the LDAP directory). From Central Directory: This enables you to copy any modified directory information from the central directory (also known as the LDAP directory) to the channel directories (also known as the subordinate or slave directories).	To Central Directory	Choose to propagate modified entries in directory from the pull down menu.

cc:Mail Client-Side Parameters

Following is a listing of the client-side parameters. Complete this worksheet before you begin the installation of the cc:Mail client.

TABLE  A-3   cc:Mail Client Configuration Parameters and Worksheet

Client-Side Parameters	Description	Example	Your Client-Side Parameters
Program Directory	This is the directory where cc:Mail client is installed, and where the import and the export files are located.	T:\CCADMIN	Fill in your response in the provided text field.
Data Directory	This indicates the location where the cc:Mail gateway postoffice data files reside.	T:\CCMAIL	Fill in your response in the provided text field.
Post Office*1	Enter the name cc:Mail postoffice where the user mail boxes reside.	ccmail	Fill in your response in the provided text field.
Password*	Enter the password for the postoffice.	*******	Fill in your response in the provided text field.
Gateway Postoffice2	Enter the gateway post office name you created for SMCS. This is the `P' entry in cc:Mail (a temporary repository/ postoffice) to hold messages for SMCS.	SMCS	Fill in your response in the provided text field. Copy this information to the gateway postoffice parameter listed in the server configuration table, TABLE A-2.
Gateway Post Office Password	Enter the password for the gateway post office.	*******	Fill in your response in the provided text field.
Polling Interval	This indicates how often you want the cc:Mail client to check for messages. Enter your value in minutes.	1	Fill in your response in the provided text field.
Maximum Log days	The number of days for which you want the log files to be maintained.	7	Fill in your response in the provided text field.
Server's SPX*	Fill out the information in this field if you have selected the SPX transport. The server's SPX will be of the format xxxxxxxx:yyyyyyyyyyyy, where xxxxxxxx is the hostid or the network number of the server, where as yyyyyyyyyyyy is usually a mask set to 000000000001 (eleven zeros and a one). To find out this address, you can go to the /opt/SUNWefps/sbin directory on your server and execute the ipxstat -i command. This will give you the required address.	807980AC:000000000001	Fill in your response in the provided text field.
Server Socket	Fill out the information in this field if you have selected the SPX transport. The Server socket address is usually set to 8000 by default. This should match the Server Address on the server side.	8000	Copy this information from the server address parameter listed in the server configuration table, TABLE A-2. Retain the default value if you are unsure.
Server Name	Fill out the information in this field if you have selected the SPX transport, that is the name of the cc: Mail SPX server. If you change the default name, make sure that you change the corresponding Server Name on the server side.	SPXSRV (this is the default value for this parameter)	Copy this information from the server name parameter listed in the server configuration table, TABLE A-2. Retain the default value if you are unsure.
Client Name	Fill out the information in this field if you have selected the SPX transport. The client name should be the SPX name of the PC.	CCMAICLI (this is the default value for this parameter	Fill in your response in the provided text field. Retain the default values if you are unsure. Copy this information to the client name parameter listed in the server configuration table, TABLE A-2.
Root Directory	Fill out the information in this field if you have selected the Fileshare transport and not the SPX transport. The root directory is the DOS path of the shared directory. This should match the Shared Directory on the server side.	N:\ccmail	Copy this information from the shared directory parameter information listed in the server configuration table, TABLE A-2.
Channel Name*	This is the name of your cc:Mail channel. It should match the Channel Name on the server side.	ccmailt	Fill in your response in the provided text field. Copy this information to the channel name parameter listed in the server configuration table, TABLE A-2.
Description	This indicates a brief description of the channel.	cc:Mail channel on TIN	Fill in your response in the provided text field.
Export Schedule*	Indicate the time interval between cc:Mail export operations. Exporting entails propagating user directory information changes to the central directory. Formats include: Monthly on [days] at [hh:mm] Weekly on [days] at [hh:mm] Daily at [hh:mm] Hourly at [:mm]	Hourly at :10	Fill in your response in the provided text field.
Import Schedule*	This is similar to the export schedule, but the schedule is for cc:Mail import operations. Importing entails propagating user directory information changes from the central directory.	Hourly at :55	Fill in your response in the provided text field.
Administrator*	This should be the name of a cc:Mail administrative user on the cc:Mail Gateway postoffice.	admin	Fill in your response in the provided text field.
Administrator Password	Administrative user's password. This should be the password for the administrative user.	*******	Fill in your response in the provided text field.
Remote Address*	This is the address for the channel at the postoffice on the server side. Use the following syntax: channelname@dsm.host.domainname at <gateway po>	For example, ccmailt@dsm.tin.eng.alpha.com at SMCS	Fill in your response in the provided text field.

1 Parameters marked with an asterisk (*) require information that needs to be derived before entering them in the space provided. 2 Parameters shown in Bold font need to match on the server and the client end. To ensure that you are comparing the correct entries on the server and the client end, refer to TABLE A-1 on page 66.