Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Table of Contents Section 1 2 3 4 5 6 7 8 9 10 Title Getting Started Installation User Interface Server Configuration Client Configuration UUPlus Logs Setting up Mailers UUPlus Console Mailer Setting up a Local Area Network Connecting to the Internet Page 2 3 7 12 25 29 36 40 43 44
Page: 1
Getting Help. The following is a list of the available Help features UUPlus has to assist you: Press: <F1> For context sensitive pop up help in UUPlus. Press: <F2> To view this user guide in Adobe Acrobat Reader. UK Office: uktech.support@codan.com.au +44 1252 717 272 +61 8 8305 0422 Asia Office: asiatech.support@codan.com.au
Page: 2
Installing UUPlus Codan Server from the CD. Place the CD in the CD-ROM. The CD should automatically start. If the CD does not automatically start, access the CD-ROM and open [setup.exe]. The Installation window should appear. Select [UUPlus Codan Server] to begin the installation process. Follow the instructions on the screen. It is strongly recommended that you install in the default directory. When prompted, enter the Software Key that was provided with the CD.
Enter your Internet Name. This is your Fully Qualified Domain Name (FQDN) for your site. If you are connecting to a corporate server you should use that server's FQDN. If you are connecting to an ISP, use your registered domain if you have one or your ISP's domain. If you are using Codan Server as a down-stream multi-user client and you connect to a UUPlus Codan Server Pro Server, use the same Internet Name as the master server. If this is a captive network (no Internet connection), use a name of your choice followed by the ".uucp" extension. Example: privatenet.uucp
Page: 3
If you are fetching mail from a corporate or ISP mail server, enter the IP address of that server. You can enter either domain (mail.server.ext) or a static IP address in dot notation (192.168.0.1). Leave this field blank or enter "none" if you are connecting to a UUPlus SOHO Server or this is a captive network.
You will now be presented with several more informational screens, followed by the UUPlus Codan Setup screen. You are now finished entering the basic information for your system, however, there are a number of other options you should look at. You should look over each tab to familiarize yourself with the features and settings. Most of these are self explanatory and pop-up help available by selecting a field and pressing <F1>. Each tab is covered in greater detail later in this manual. Within Setup, you have the ability to add users, configure the fetching and sending options, schedule calling, and a number of other items.
Page: 4
Page: 5
You will now be presented with several more informational screens, followed by the UUPlus Codan Setup screen. You are finished entering the information for your system, but check over all the settings to make sure they are correct and to set your preferences. Help available by selecting a field and pressing <F1>. Each setting is covered in greater detail later in this manual.
Hint: UUPlus programs use the mouse right-click menu feature in a lot of places for short cuts and feature/settings selection. Hint: UUPlus doesnt include a lot of menus and fancy Icons, including ones for basic operations such as undo-do, cut, copy, and paste. You can use the Window short-cut keys for these operations: undo <ctrl-z> cut <ctrl-x> copy <ctrl-c> paste <ctrl-v>
Page: 6
The UUPlus Codan Client and Server user interfaces consists of a number windows: The Console. The main user interface. The Dialer. The mail and file transport agent. The Mail Router. Optional, displays mail routing, POP/ SMTP sessions in real time. The Setup Editor. A tabbed window for all configuration settings. The Mailer. Provided for those who have fairly simple email needs. The Log Viewer. For viewing the accounting and debugging logs The Mail Queue Viewer. For viewing outbound mail queues.
This section discusses the console, dialer and router windows in detail. Setup, the mailer, log and queue viewers are discussed in separate sections. The Server Console. The console provides access to all the features of UUPlus Codan Server. The button bar includes a Call / Mail button, a selected item field, Send File, Logs, Queue, and Setup buttons, and optionally includes a list of users configured on your site.
Call / Mail Button. The function of the Call / Mail button changes with the selected item in the Sites / Users list. If "internet" or your mail server site is selected, a connection to your ISP, corporate mail server, or up-stream mail server can be started. Clicking the Call button or double clicking on the item in the Site/Users list will initiate the call. Note that in Answer mode Codan Server may take several seconds for the call to begin. If a user is selected and the user does not have a station ID, a Mail button will appear and the selected user will be displayed to the right of the button. Clicking the Mail button or double clicking on the user in the Sites/Users list will bring up UUPlus' console mailer. If Password Protection is set you will be prompted for a password. If the selected user has a Station ID, rather than bringing up the mailer, Codan Server will call the user. Note that the user must be set to answer inbound calls.
Send File. Codan Server provides the ability to send a file directly to a remote site. Select the user to send to and click [Send File] or drag and drop the file onto the console.
Logs. Clicking the Logs button will bring up the Log viewer. The log viewer lists all of the UUPlus logs detailing all the actions of all UUPlus functions.
Queue.
Page: 7
The Client Console. The Client console is very much like the Server console except that it is limited to the mail server, the user, and a the anonymous file transfer feature.
Call / Mail Button. The function of the Call / Mail button changes with the selected item in the list. To make a call to your mail server, select your mail server in the list (this is always the first item) and then click the call button. You can also double click the item in the list to initiate the call. Note that in Answer mode Codan Client may take several seconds for the call to begin.
Page: 8
Page: 9
The dialer has a number of options depending on the version. Reset/Stop Button. When a call is active there is a [Stop] button. Clicking the Stop button will try to end the session gracefully and shut down the modem. Should there be a problem shutting down the session, a second click will end the program forcibly. When idle, there will be a [Reset] button. Clicking notifies Codan Server that the dialer is going to exit and wishes to be restarted. A right click will afford the following options: Answer Enabled. Answering inbound calls can be temporally turned off. This is helpful with Codan modems and you need to make a voice call. Available only in Answer mode. Debug Mode. If checked, the log will display a fairly detailed account of the call. Reading and understanding this log is really intended for UUPlus tech support, but it is good for trouble shooting a modem init string. Normally you should not have this checked. Available only in Answer mode. Test Mode. Displays a command line to send commands directly to the modem and a very high level of debug information. Available only in Answer mode. Wide Display. Set to suit your preference. Display Log. Allows turning off the real-time log display. Though watching a UUPlus connection may prove to be more entertaining than the programming on your local TV station, you have the option of not displaying the log. Exit. Closes the dialer without notifying Codan Server to restart it.
Note that Debug and Test modes in the call mode dialer are set from the Client console. The Mail Router. The mail router is usually a behind the screens type of program, but again, due to the lack of good television programming (or well written mail server manuals) we found it interesting to watch. The mail router window is displayed when you either: Check the Show Mail Server box in Setup. Right-click on the console and check Debug Mode. Right-click on the console and click Test Mail Routing.
The above diagram shows the router in normal mode. Note that mail routing, POP, and SMTP sessions will be displayed in real mode. If you put UUPlus in debug mode and expand the
Page: 10
The above digram show the router in test mail routing mode. Enter an address into the To: address box and click [Test]. The destination of a message to the address will be displayed. This is very helpful in determining the best settings to use on the routes tab and allows you to design a mail routing architecture for your system without risking sending annoying test messages. Note that this feature does not send any messages, it only simulates how a message will be routed. Accessing Mail, Codan Server. Mail can be accessed by calling in, popped over a local area network or directly from Codan Server console using UUPlus mailer. UUPlus Console Mailer. If the user is local or calls directly into the Codan Server server, double-clicking on a user in the console Site / User list brings up the UUPlus mailer for the selected user. If password protection is enabled you will need to know the user's or the postmaster's password. Local Area Network (LAN). Codan Server includes POP and SMTP servers which allows users access to their mailbox over a LAN using a POP3 compatible mailers such as Eudora, Outlook, Outlook Express, and Pegasus Mail. Mail can also be accessed from a mailer running on the same computer as Codan Server. Use the static IP address of the Codan Server computer in the mail server fields of the mailer. Accessing Mail, Codan Client. UUPlus Console Mailer. Mail can be read using the console mailer by selecting the user in the console list and clicking the Mail button or double-clicking on the user. If password protection is enabled you will need to know the user's or the postmaster's password. Note that this is more an "administrators" mailer so it lacks many of the features of a full-featured mailer. POP3 Mailer. Codan Client includes a POP and SMTP server which allows access to mail using POP3 compatible mailers such as Eudora, Outlook, Outlook Express, and Pegasus Mail. The mailer must be running on the same computer as Codan Client.
Page: 11
This section is broken down by the tabs in UUPlus Codan Server Setup. Settings Tab The Station Settings tab contains the basic information about the site, display options, security options, and the unknown local mail routing options.
Answer Calls. Check this option to answer inbound calls. Station ID. The is your station ID or address that identifies you on the HF network. Smart Host. A smarthost is simply a mail server that knows what to do with any given email address. Your smarthost is the site that you receive your Internet mail from and send Internet mail to. This is either an Internet service provider (ISP), a corporate mail sever, or a up-stream UUPlus SOHO Pro Server site. If your mail server is an ISP or corporate, select "ISP". If you wish to specify a UUPlus SOHO Pro server, select "UUPlus Site" in the drop down box and enter in the details for connecting to the SOHO server. If you are running a "captive" network, that is, you don't connect to the Internet or other mail server, select "none" in the drop down box and use the ".uucp" domain extension (see Full Internet Name). Examples:
ISP tree none
UUPlus Site Name. The UUPlus Site Name is the name other sites know you by. It is usually sent as your login when calling and you usually send it when a site calls you. A sitename should be from 3 to 12 characters in length and can contain only alpha-numerics and a single underscore (_) or dash (-). Dots and spaces are not permitted. For UUPlus Codan Servers, this will usually be the first part of your Internet Name. For example, if your Internet Name (FQDN) is "tree.ext", your UUPlus name is "tree". Example:
tree
Page: 12
If you are running a "captive" network, that is, you don't connect to the Internet or other mail server, use the ".uucp" domain extension. Example:
privatenet.uucp
Enable POP / SMTP Servers. On some systems you may not want to run UUPlus POP and SMTP servers, such a when you are using UUPlus only for HF connections and are co-locating it on a network or computer that is running another email server for handling local POP/SMTP.
POP / SMTP Ports. UUPlus allows you the flexibility to change the IP port numbers from the standard POP and SMTP ports. Setting a port to 0 will disable the service. If you need the SMTP service to handle inbound mail but don't need the POP server, set the POP Port to 0.
Product Key. Click to change the UUPlus Codan Server product key. Show Site / User Status. This is the site / user list in the Codan Server console window, which lists the sites and users, the number of messages, mailbox/queue size, and the time elapsed since last accessed. For security reasons you may wish to hide this window. If your users will be accessing their mail directly from the Codan Server software with the Console Mailer, this needs to be checked.
Show Mail Router. If checked the mail router will be displayed. This options provides a real-time log of mail routing and the POP/SMTP servers.
Load UUPlus at Startup. When checked UUPlus will load when the computer is booted and logged into. Note that UUPlus does not run as a service, but as an application, so the computer must be logged into by a user for UUPlus to start. This is usually not a problem on todays computers as they will not boot without user intervention after a power outage.
Enable Password Protection. If checked, the postmaster's password will be needed to view the logs, queue, or enter the Setup screen. Accessing mail will also require the user's password.
Unknown Local Mail To. In most mail systems mail to unknown users is returned to the sender, or bounced. Because UUPlus is often used where this might not be desirable, UUPlus gives you a number of options. Delete. The message is deleted and the action is noted in the logs. Return. The message is returned to the sender. Forward to Postmaster. The message is placed in the postmasters mailbox. Forward to Smarthost. The message is sent to the smarthost. Note that this assumes that unknown mail can not be delivered to your site by the smarthost and they will know
Page: 13
User IDs. Click to view the serial numbers of the Codan Clients that are connecting to your server. Postmaster. Use the drop-down list to select the user designated as the site postmaster. Adding / Removing Users. To add a new user click the [Add User] button. The fields for the user will be set blank so you can enter the new username password, and their station ID if you will be calling them. See the User Name section below for restrictions for usernames. If your smarthost is ISP and you are fetching your users, it is recommended that you use the same username and password as on the server you are fetching from. This will greatly simplify things. If you have entered the maximum number of users and sites permitted by the registration key(s) the [Add User] button will be disabled. To remove a user click the [Remove User] button. Note that all configuration and mail files will be deleted for this user with the exception of the user's mail Archive if mail archiving is enabled.
Import List. Use the [Import List] button to import or export the list of users. This is a comma separated text file in the format:
username, password
No other fields are permitted and spaces will be removed. User Name. Users are assigned a username which can contain the letters A-Z, a-z, the numbers 0-9, a dot (.), a dash (-), or an underscore (_). Usernames should be from 2 to 16 characters in length and are not case sensitive.
Page: 14
Connection Via: Select "LAN" or one of the Windows Dial-up Networking entries when fetching mail from an ISP or corporate mail server over a PSTN, MPDS, or any other Windows Dial-up Networking connection. If you are fetching from a corporate mail server over a LAN or other full time connection, select LAN. When using a Dial-up Networking, you can select the connection you wish to use in the dropdown box. Note that you must already have a dial-up account configured in Windows before you can set this. The [Edit Entry] button provides to access the settings for the selected entry. The [Settings] button will display a setting window to override the settings in Windows Dial-up Networking. If a Dial-up Networking session is already active, the active session will be used. When the fetch is complete, the connection will be left in the state it was found.
Phone Number. Enter the complete phone number to dial. UUPlus uses this number rather than the number settings in Windows. Leave blank to use the Windows setting.
Page: 16
mail.isp.net
192.168.0.3
Enter the Local User to fetch for, the Mail Server to fetch from and optionally an alternate port to use, the POP Account to fetch and the Password for the account. The mail server can be specified in dot notation (192.168.0.2) or in Internet notation (mail.myisp.ext). If you wish to override the default POP port setting, enter the alternate port in the box following the Mail Server field (mail.myorg.ext:995). Note that the mail server field must have one or more dots in the field, a machine name is not accepted. Note also that using dot notation eliminates the need for a DNS lookup, thus
Page: 18
Remote UUPlus Site Name. The UUPlus Name of the SOHO Server Password. The password to use to connect to the SOHO server. Remote Site's Station Address. The SOHO server's station address. Max Message Size to Send. The maximum message size to send to this site. Login Timeout. The answer login timeout when this site calls you. Schedule Call. Click to schedule a call to this site. Send Attachments Separately.
Page: 19
Com Port. Select the com port the modem is connected to. Only active ports are listed. If the correct port is not listed, the port must be activated before entering Setup for it to be selected. If you are connecting with a USB / Serial Adapter, and the adapter is not plugged in, the port will not be listed. To list the port, shutdown UUPlus, plug the USB adapter in, restart UUPlus and click Setup. The USB com port should now be listed. If it is not, you may have to reboot your computer to get it to recognize the USB adapter.
Login Timeout. The length of time to wait for modem negotiation (sync) on an inbound call before giving up. This timer is set when the modem goes off hook, then it is set again when the two modem sync for the login/password exchange. If the timeout is set at 30 seconds, it will be at most 60 seconds before the call attempt is abandoned. For inbound PSTN calls, the timeout should set at 30 seconds unless it often takes more time for the modems to sync. For inbound HF radio calls, the timeout should not be set less than 120 seconds. If Codan Server seems to be hanging up a call before the two modems negotiate sync, increase the timeout.
Max time. The maximum time allowed for a answered connection. A setting of 0 will disable the timer. Modem: Select the option for your modem. If you have an older 9002 that has not been upgraded (do so as soon as possible) to the current firmware, select the Older 9002 option. The Custom option is provided just in case, but it shouldn't ever be needed.
Init String: The AT initialization string to initialize the modem. For the most part, you shouldn't ever need to change this from the default and it is not recommended that you do so.
Page: 20
Page: 21
Header Kill. The kill file is used to search message headers only. Any message with a keyword or phrase found in the header is automatically deleted. Mail from unwanted email addresses or domains can be places in this filter. Each keyword or phrase is placed on its own line, there are examples in the default file. If the @ symbol is placed on a line by itself, Codan Server will delete all inbound mail, so be careful with this. @spammers.com will kill all mail from that domain.
Subject Kill. The subject kill file only searches the Subject: line in the message header. There are examples in the default file.
Body Kill. The body kill file searches the first 50 lines of a message body. Spam is usually HTML
Page: 22
Events Tab. UUPlus Codan Server contains an event scheduler to allow for regularly scheduled calling.
Enable/Disable. Existing events can be quickly enabled or disabled by selecting the event and toggling the Enable/Disable button. A disabled even will have a # character preceding the event field.
Add Event. Click the [Add] to add a new event. Note that you can select an existing event, then click the Add button and the information in the existing event will be used to set up the Add Event screen.
In the event add/edit screen, set the hours and minutes with the [+/-] buttons or type in the value. Care should be taken so that events are not scheduled so as to conflict. The Event field is a drop-down list and will contain most of the valid events. You can schedule calling remote sites as well as enable and disable answering on the enabled modems (this can be helpful in an HF setup to schedule times for voice calls and data calls).
Page: 23
Page: 24
This section is broken down by the tabs in UUPlus Codan Client Setup. Settings Tab The Station Settings tab contains the basic information about the site, display options, security options, and the unknown local mail routing options.
Station Settings. Client Station ID. This is the station address or ID of your site. Mail Server Station ID. This is the station address or ID of your mail server. Full Email Address. This is your full email address in the format: username@domain.ext. The "username" part of the address must match your username on the server and the "domain.ext" part of the address must match the Internet Name on the server. Password. This is the password used to login to the mail server. Answer Calls. Check this option if the server will be calling you. Load UUPlus at Startup. Check this option if you want UUPlus to automatically load when you start your computer. Show UUPlus Console. Check this option if you would like the the UUPlus console to always be displayed on the desk top. If not displayed, you can access UUPlus by clicking the tray icon (by the Windows clock). Always Show UUPlus Dialer. Check this option if you wish the dialer to be displayed when connected.
Page: 25
Com Port. Select the com port the modem is connected to. Only active ports are listed. If the correct port is not listed, the port must be activated before entering Setup for it to be selected. If you are connecting with a USB / Serial Adapter, and the adapter is not plugged in, the port will not be listed. To list the port, shutdown UUPlus, plug the USB adapter in, restart UUPlus and click Setup. The USB com port should now be listed. If it is not, you may have to reboot your computer to get it to recognize the USB adapter.
Page: 26
Page: 27
Page: 28
UUPlus records most of what it does in logs. These logs can be viewed by clicking the [Logs] button in the UUPlus console.
There are two types of logs, record keeping and debugging. The Call and Routed logs are for record keeping, the rest are used primarily for debugging. Since longs can often be quite large and you may only want to see the end of the log, the viewer can be set to read in only the last 500k or so of a log. The "Read In:" setting can be set to your preference. Clicking the Read In label will load the entire log, overriding the setting one time. Entries in the logs start with a time stamp, with the exception of the Call log, which first has the line number followed by the time stamp. The log segments shown here have this time stamp removed with the exception of the call log so the entries will fit on the page. Call Log [Calls] UUPlus Codan Client uses a single file for all calls. UUPlus Codan Server uses a monthly call log where the calls for each calender month are placed in a new file each month. A drop-down list is provided to the right of the [Calls] button listing the available monthly logs. Selecting a log from the list displays the log. The call log is in the following format: line time-stamp site time sent rcvd cps sync cntmsg pkts line. The line used in the call. In Personal and Codan Server client, the line will always be 1. time-stamp. The month, day, hour and minute of the call. site. The site connected to. time. The off-hook time in seconds. sent. The number of bytes sent in the session. Note that in the case of failed connections this number is cumulative and indicates the progress for the combined connections. rcvd. The number of bytes received in the session. Note that in the case of failed connections this number is cumulative and indicates the progress for the combined failed connections. Cps. The characters per second rate for the session. sync. The time, in seconds, used for the modems to negotiate the connection. [msg]. The CONNECT message, if any, received by the modem. This is primarily used by answer sites to determine the remote modem type that called. {#}. The maximum number of un-acknowledged packets (window size) used in the connection.
Page: 29
Routed Log [Routed] The Routed log is a summery of all messages processed, one entry per message. The entry is a duplicate of the final entry for a job in the rmail log. The general format of the routed log is: timestamp jobname placed sender recipient length jobname The inbound or starting job name. placed Either local if the mail is placed in a local mail box, sitename if spooled to a UUPlus site, or internet if spooled to an SMTP server. sender The address the message is from. recipient The address or local user the message is to. If the message is to a local user, the mailbox ID is included. This ID is also recorded in the POP log or if the user is remote, in the Cico log. length The uncompressed message size. Examples:
D03D7 local, From:[user@domain.ext] To:[user1:D03D7] Len: 8118 D0193 uuplus, From:[user1@uuplus.com] To:[user@domain.ext] Len: 1068 D0015 internet, From:[user1@uuplus.com] To:[user@domain.ext] Len: 13407
If you have any entries in the Inbound Mail Filter file there will also be entries like this:
Kill: To: user1@uuplus.com From: spam@spammer.org Found:[spammer.org]
Rmail Log [Rmail] The Rmail log records in some detail how mail is processed and routed. There are several processes associated with mail routing, such as uuxqt, which is the process that reads commands from a remote system and executes them. uzip is the un-zipping process, ubat unbatches the file into individual messages, and mail (actually rmail, for route mail) is the process that determines where to copy a message to, either to a local mail folder, spooled to a UUPlus (UUCP) site, or placed in the outbound mqueue (mail queue) directory for delivery via SMTP. The general format of the rmail log is: timestamp process jobname [information][action taken] Note that the job name, sometimes referred to as the message ID, corresponds to the file name of the message or batch file. This does not necessarily have any relationship to the message ID listed in the header of a mail message. UUPlus uses a sequenced 4 digit hexadecimal number in the range of 0001 to FFFF, proceeded by a D character, for file names to insure that no two will ever be the same (unless you keep some 65,000 messages in a single directory) The following log segment shows processing an inbound mail batch from another UUPlus site, in this case the site name is uuplus.
-- Rmail started -UXQT -- uuplus UXQT D06B4 bMail, Msgs: 4 UZIP D06B4 (19811 -> 66721) 70% UBAT D06B4 From:[Full Name <user@domain.ext>] To:[user1] MAIL D03CE local, From:[user@domain.ext] To:[user1:D03CE] Len: 41941 UBAT D06B4 From:["Full Name" <user@domain.ext>] To:[user1] MAIL D03CF local, From:[user@domain.ext] To:[jhb:D03CF] Len: 7335 UBAT D06B4 From:["Full Name" <user@domain.ext>] To:[user1] Page: 30
The next log segment shows processing a locally generated message being added to a batch file to be sent to another UUPlus site, in this case the site name is uuplus.
MQUE -MQUE D0192 From:[user1@uuplus.com] To:[user@domain.ext] MAIL D01F2 BCHD uuplus, From:[jhb@uuplus.com] To:[user@domain.ext] Len: 6380
Following are some of the error and informational messages and an explanation of what caused them.
MAIL ERROR: (L) Could not copy attachment: [input filename] to [output filename] MAIL Attachment not included: d:\uuplus\spool\attach\A.uuplusF0030
The above is caused when a message arrives without it's attachment it is generally caused by the call being cut off after the mail batch was received but before the attachment was fully received. In this case the attachment will be sent later when all of it arrives.
ZIP: ERROR Could not zip: d:\uuplus\spool\attach\SUNDAY
The mostly likely cause of the above is that the mailer (and perhaps the user that was running the mailer) did something unanticipated when composing the message and the attachment was corrupted, or not even included, when the original message was sent.
ATCH Decode: file not encoded: d:\uuplus\spool\attach\A.sitenameF4656 ATCH Could not Decode: d:\uuplus\spool\attach\A.sitenameF4656
The above was caused by a malformed email attachment. When the sender forwarded the message, the mailer they were using used the wrong MIME format to include the message, rendering it unreadable before it ever left their computer.
UXQT F0036, Route Attach To: address::address, File: filename.ext, From: daemon ATCH To:[address] From:[address] File:[ filename.ext ]
An attachment was received after it's host message and was routed to the recipient.
MAIL Warning: Unknown local user <localuser>
Page: 31
Most of the error messages in the POP log are beyond the scope of this manual and should be referred to UUPlus tech support of you don't understand them. The following message, however, should be self-explanatory.
Please close all UUPlus programs restart UUPlus. If the problem persists there may be another program preventing UUPlus from working correctly which will need to be turned off, or TCP/IP may be incorrectly configured or not installed.
Sometimes certain mailers seem to loose messages. If this seems to be the case, the POP log shows definitively if the message was delivered to the mailer or not, and if it was, the message is somewhere in the mailer. Note that the most common cause for loss of messages in a POP session is that the user has neglected to move messages from the inbox to another folder and often has hundreds of messages in their inbox, only 6 to 10 or so are visible at any one time. SMTP Server Log [SmtpSrv] The SMTP server log shows all inbound messages received via SMTP. The general format of the SMTP log is: timestamp session address action [jobname len sender recipient] session. Indicates which one of any concurrent sessions the log entry is for. address. The IP address of the remote client. action. The action being logged jobname. The message ID for this message. There will be a match for a MQUE job in the rmail log. len. The length of the message as received. sender. The sender as listed in the SMTP header envelope. recipient. The recipient as listed in the SMTP envelope. Example:
SMTP [uuplus.com] listening on port: 25 0) [127.0.0.1] Accepted, relay OK. 0) [127.0.0.1] Rcvd: D0168, len: 3176, FROM:<user1@domain.ext> TO:<user@mydomain.ext>
Page: 32
Cico Logs [Cico 1] Cico, which stands for Copy In, Copy Out, is the program that transfers the mail to and from your system. It is basically a file copy mechanism designed for satellite phones, HF modems, or any either slow, error prone, or expensive connection. Cico also handles the modem configuration and dialing.
Mon Feb 10 Version: Modem: Calling: Connect: CnctSync: CnctSync: Sending: Interact: Expecting: Expecting: Received: Received: Received: Sending: Connected: Done... 10:35:45 2003 UUPlus uuCico startup, unregistered version. UUPlus Personal 4.6.11.21.03 +Codan 9002/9003 Modem on COM4 38400 bps UUPlus, Number:[18055349398] at 02/10-10:35:47 To: UUPlus @ 9600 bps. Requesting all messages under 25k bytes. StartPkSz: 256, MaxPkSz: 256, WinSz: 256. 'H' message. Done chan 1, D.jhbD06AB len 7121 chan 2, D.jhbD06AA len 20728 D06AB, len: 7121 [msgs: 2][jhb] D06AA, len: 20728 [msgs: 10][jhb] 'H' message, remote has no more work 'HY' message. uuplus, Time: 68 Sent:0 Rcvd:27849 cps:773 Sync:32 []{18}
The above log segment starts with a full date statement when Cico was started. Version: The UUPlus version number. Modem: The modem name, comport, and the data rate to the modem. Calling: The site and the number dialed (in [brackets]). Connect: The remote site name and actual speed of the connection. CnctSync: The requested protocol parameters, including the size of messages to download. Sending: Commands and files to be sent to the remote. Interact: Interactive mode messages. Expecting: Files we are expecting from the remote. Received: Commands and files we have received from the remote. Connected: Summery of the call. This is also recorded in the Call logs. Debug mode level logs are far more detailed. Here are some of the things you will see. Our current debug level:
Startup: Debug Level: 5
Page: 33
The prompt we are expecting to receive, note that this is a partial string to allow for dropped characters:
Expecting: ogin:
The next prompt we are expecting to receive, note that this is a partial string to allow for dropped characters:
Expecting: ssword:
Didn't get what we expected, so report it to the log and wait for our expect string (note that the remote keeps sending Login: until it gets something from us):
-mdmRcvd: [Login:]
Protocol level parameters, note that these are set dynamically based on connect speed:
PktPrams: Buf: 1, Delay: 128, StSz: 244, MxSz: 244, MnSz: 32, MxPk: 80, Hack: 122, RSWn: 128
Page: 34
There will also be a number of error messages regarding modem init, login, and account authentication. They are as follows:
Modem Command Timeout. Check modem / modem configuration.
The remote never answered. There could be a variety of reasons for this, from a modem error that the modem didn't report (such as no dial tone), no circuits available (effects land line, cell phone and satellite phones), the call didn't go through, the remote didn't pick up, the modems didn't sync, or any number of other reasons. This error triggers a redial.
Error: NO DIAL TONE. Please check modem.
You have the wrong comport selected in the modems tab. This is most often caused by not plugging the USP/Serial adapter in before making the call.
Modem ERROR: [ERROR] Please check modem INIT string.
One or more of the AT commands sent to the modem caused an error. If you are running Win2000 Pro on a Dell laptop and are using an Iridium phone you might get this error, if this is the case, in the Modem configuration tab, check Ignore Init Err. In most other cases you should set debug on, click the Call button, and go over the modem response entries to determine the bad init command.
Page: 35
UUPlus Codan Client software includes POP/SMTP servers allowing any POP/SMTP mailer to communicate directly with Codan Client. Codan Client acts as a mail server, allowing you to use your mailer the same way your would while connected through your standard ISP. Outlook and Outlook Express. Microsoft Outlook and Outlook Express are widely used mailers, Outlook Express is usually preinstalled on most Windows computers. The configuration process is similar for both and for simplicity we refer to both as Outlook". 1. Open Outlook Express. 2. On the menu bar, select [Tools Accounts]. 3. The Internet Accounts window will appear. Click the [Add] button and select [Mail]. 4. Type in your name and click [Next]. This name is what will appear next to your email address in the header. 5. Select I already have an email address and enter your UUPlus email address. Click [Next] when finished. 6. Select POP3 as your incoming mail server. 7. Enter localhost for your Incoming and Outgoing mail servers and click [Next]. 8. Enter your UUPlus account name (username) and password. The password is casesensitive. Check the Remember Password box and click [Next]. Do not check the box for Secure Password Authentication. 9. In Outlook, you will be asked how you are going to connect to the Internet, select Connect using my local area network and click [Next]. 10.You are now done configuring Outlook Express. Click [Finish] to save the configuration. 11.Assuming there is no need for any trouble-shooting, you can now send and receive your email to and from UUPlus Personal Pro. To test sending and receiving mail, make sure UUPlus is running and it's log window is displayed. It is also helpful to size UUPlus and Outlook so you can see UUPlus' log and Outlook at the same time, 1. On Outlook, on the main window, click the [New Message] button to create a test message, address it to your UUPlus address. 2. When finished with the test message, click [Send]. 3. If the email disappears, is not listed in Outlook's Outbox, and UUPlus' log indicates it received and processed a message, then sending works. 4. On the main Outlook window, on the file menu select [Tools Send and Receive Localhost (or the account name for the UUPlus server)]. 5. This should activate a POP session. Any mail in the UUPlus Personal Pro mailbox (if you sent a message to yourself there should be at least one) should appear in the Outlook Inbox. The process should take less then a second (unless there is a large quantity of mail). If UUPlus Personal Pro is configured to call on mail check, it might automatically begin calling or request you to make a call. If that happens, it means Outlook is communicating to the POP server. You should also see some activity in UUPlus' log window.
Page: 36
Page: 37
Eudora. Eudora is a popular mailer developed by Qualcomm. 1. Install Eudora if it is not already installed. 2. Open Eudora. If you are opening Eudora for the first time, Eudora will begin the New Account Wizard. Follow the instructions for creating a new account. Click [Next] to begin. 3. Select Create a brand new account and click [Next]. 4. Type in your name and click [Next]. 5. Type in your UUPlus email address and click [Next]. 6. Type in your UUPlus account name. Your account name is what precedes the @symbol in your email address. Eudora should correctly guess your account name. Click [Next] to continue. 7. Enter localhost as your incoming server, choose POP as the type of server, and click [Next]. 8. Enter localhost as your outbound server. Eudora should already have this listed. Click [Next] to continue.
Page: 38
Page: 39
The UUPlus mailer is a simple, limited feature mailer built into UUPlus software. It is easy to use and requires little configuration. All mail in this mailer is viewed and composed in plain ASCII text. The UUPlus Mailer does not support formatted text and does not display embedded images. It does, however, support sending and receiving file attachments, as well as including a spell checker. Main Window. The UUPlus Mailer is composed of three panels: the Folders panel lists the folders for storing mail, the Contents panel lists the mail in the selected folder, and the Preview panel displays the currently selected message. New mail is always placed in the Inbox folder.
[UUPlus Mailer]
New Message: Starts a New Message. Address Book: Opens the Address Book. Each mailbox contains its own address book. Add To Book: Adds the selected email to the Address Book. Search: Searches for any message containing a keyword or phrase. Any messages containing the keyword or phrase will be listed in the Contents Panel. Settings: Opens the Mailer Settings window. Re-Scan: Updates the listings in the Contents Panel. By re-indexing the mailbox, any new mail will appear. Done: Exits the mailer. Folders Panel. The Inbox, Receive, Sent, Draft, and Trash folders are reserved and cannot be removed. Any folders below the dotted line are defined by the user and can be added and deleted as needed. To view the contents of a folder, double click on the folder. Add Folder: Right click in the Folders panel and select [Add Folder]. Delete Folder: Right-click in the Folders panel and select [Delete Folder]. Contents Panel. Move To: Moves the selected email to a specified folder. This helps keep the users mail organized. When the UUPlus Mailer opens, it re-indexes all the mail in the Inbox folder. As the number of messages in the Inbox increases, the longer it will take for the software to open. To prevent this slow down, store mail in a folder other than the Inbox. Del: Moves the selected email to the Trash folder. Reply: Creates a reply to the sender of the selected email message. Reply All: Creates a reply to all address (except yours) in the To: line and Cc: line of the selected email message. Forward: Forwards the selected email message to a new recipient.
Page: 40
Reply-To Address: The address which will display on the From line in your mail. This address will be used to route mail back to your mailbox when somebody replies to mail you sent. [Edit] To the right of the Reply-To field is an edit button. The UUPlus mailer allows you to enter up to three alternate addresses for the From: field. Clicking the Edit button brings up a text editor where you can add up to three more address, the first address in is your default Reply To address. Be sure to format the addresses you enter correctly. Edit Signature: Allows the user to edit the signature file. The signature file contains information that needs to be added to every outbound message. Automatically add Replies to Address Book: When checked, addresses you reply to will be automatically added to the address book. Close Mailer When Inbox is Empty: Closes the UUPlus Mailer automatically when there is no longer mail in the Inbox. Empty Trash on Exit: If you want deleted mail to actually delete on exit, check this option. Autosize Columns: The mailer will size the Subject, Sender, Date, and Size columns to fit the mailer window size. Show grid lines in Mail Boxes: Displays grid lines in the pane listing mail. Always Refresh. Check this to always refresh the message list after a call, regardless of what window has focus. If you are using Chat mode, check this option. Always use Raw Message View: Displays the selected email in raw mode. Any formatting code or attachments will be displayed as ASCI characters. Scan for New Mail: While open, the mailer scan for new mail while the mailer is open.
Page: 41
Send. Sends the message. You can also use the <ctrl><Enter> short-cut keys to send. If you have not entered an address you will be prompted to do so. Address Book. Click to bring up the Address Book. See section 18.7 Spell Check. Spell checks the message. You can also set your spell checking options. Save. Saves a copy in the Draft folder. Note that messages are not automatically saved. Print. Prints the message body. Cancel. Close the mail composer without sending or saving the message. Attachments. Brings up a file selector. You can also just drag and drop attachments on the composer. A window will appear showing the attached files. To delete an attached file, select it, right-click and click Delete. Add To Book. Add the addresses in the To: and Cc: fields to the Address Book. Note that you can have this done automatically, see section 18.5. From: The composer supports up to 4 From: lines, use the drop-down box to select. See section 18.5 for more information. To:, Cc:, Bcc: Click the appropriate button for To:, Cc: and Bcc: (blind cc) addresses. Note that you must have a To: address. Subject: The subject for the message.
Address Book. The UUPlus Console Mailer Address Book is very simple, it's features should be self evident.
To add an address to the To:, Cc:, or Bcc: fields, select one or more addresses and click the respective button. If you are selecting only one address you can dbl-click on it and you will be returned to the composer. Use the [New], [Edit], and [Del] buttons as needed. Clicking the [Memo] button brings up a text editor for attaching notes to the selected address.
Page: 42
This section briefly covers setting up a small local area network (LAN) for email access to a computer running UUPlus Codan Server. It is assumed that all computers have network cards installed and these are working, and that you already have the necessary cabling and a hub, and the computers are connected to the hub. Using a Web browser to access the Internet will not be discussed. It is also assumed that you know how to bring up a command window and how to access Windows Networking. For use in private networks two ranges of IP addresses have been set aside: 10.0.n.n and 192.168.n.n, where n is replaced with a value between 0 and 254 inclusively. For our examples, we will use a network using the range of 192.168.0.0 to 192.168.0.254 and all machines will have a subnet mask of 255.255.255.0. In our system we will not be using a DHCP server, so all computers will have static IP addresses. We will also set aside address 192.168.0.1 for future use by a fire wall. In our example, our UUPlus Codan Server computer is assigned the address 192.168.0.2. This is done by right-clicking on Network Neighborhood (on the Windows Desktop), selecting Properties, selecting the adapter we wish to configure (this is probably labeled Local Area Connection, rightclicking on the connection and clicking Properties, then selecting Internet Protocol (TCP/IP), clicking and clicking Properties. You should now have a window that shows Obtain IP address automatically and Use the following IP address (note that the exact wording varies from version to version of Windows). Check Use the following IP address, enter 192.168.0.2 for the IP address, 255.255.255.0 for the subnet mask, and 192.168.0.1 for the default gateway. If you have any DNS server address you can enter them, but they are not needed for accessing mail from the Codan Server server, so we wont cover that here. Repeat the above for all computers on the network, assigning each computer a unique address in the 192.168.0.n range. Note that 192.168.0. will be the same on each computer, you will need to increment the value of n for each computer. All the rest of the settings will be the same on each machine. At this point you should be able to open the command line window and type ping 192.168.0.2 from each computer on the network and get a positive return. If you do not, check your hardware connections, make sure the networking drivers are installed correctly, and check your IP address configuration. Once all the computers are able to ping each other, all you have to do is run Codan Server, then in the mailers on each machine type in the IP address for the Codan Server server (in our example network this will be 192.168.0.2) in the POP and SMTP server fields and if your usernames and passwords match the accounts on the Codan Server server, you are good to go!
Page: 43
This section presents five scenarios for connecting a UUPlus Codan Server to send and receive Internet email. The first three detail the settings for connecting to a standard Internet Service Provider (ISP) using Windows Dial-up Networking or a full time connection and the POP/SMTP protocols. The forth scenario details the settings for connecting to a corporate mail server across a local area network (LAN). The last scenario details the settings for connecting to a UUPlus SOHO Pro server via HF for the mail feed. Numerous different mail setups are available from ISP's, the most common by far is POP3 for receiving mail and using SMTP for sending mail. POP3 accounts come in basically 2 forms, a single user account (one mail box for each user), and a multi-user account (several user's mail is put in a single mail box). ISP's provide email address in one of two formats, either under their own domain, such as: <user@isp.net>, or under a domain that you have registered, such as <user@yourdomain.ext>. Fetching mail refers to the process of connecting (either by dial-up or by full-time connect) to an ISP or corporate mail server to get the contents of one or more mail boxes using the POP protocol while concurrently sending outbound mail using the SMTP protocol. If more than one mail box is POPed, the term multi-POP is used to describe the process. If more than one user shares a single mail box, the process is called multi-drop. When UUPlus fetches mail, it can access any combination of multi-POP and multi-drop accounts from any number of accessible mail servers, not just the ISP's server. Configuring UUPlus for ISP Multi-POP Accounts (no domain). In the case where your organization has no registered domain and has several mail boxes at an ISP, your email addresses will be in the format of <user1@isp.net>, <user2@isp.net>, etc. In UUPlus Codan Server Setup, the Station Settings tab, the following settings are suggested, note that myorg could be any 16 or less character string using the characters a-z and the dash (-) and underscore (_) characters.
Smart Host: ISP UUPlus Name: myorg Full Internet Name: myorg.isp.net
UUPlus Codan Clients that connect to this server should be set as:
Full Email Address: user1@myorg.isp.net
Page: 44
or <user1@myorg.isp.net>
This setup is very clean, but you will not be able to send messages to any other users at isp.net as the Server will determine they are unknown local users and send the mail to the postmaster. For this reason you might consider getting a registered domain name. All other mail will flow as expected.
Configuring UUPlus for ISP Multi-POP Accounts (registered domain). In the case where your organization has a registered domain and has a mail box for each user at an ISP, your email addresses will be in the format of <user1@yourdomain.ext>. In UUPlus Codan Server Setup, the Station Settings tab, the following settings are needed:
Smart Host: ISP UUPlus Name: yourdomain Full Internet Name: yourdomain.ext
UUPlus Codan Clients that connect to this server should be set as:
Full Email Address: user1@yourdomain.ext
The email address set in the mail user agent (Outlook, Eudora, Pegasus, etc.) should be <user1@yourdomain.ext>. yourdomain is used only as the identifier between the Client and Server during transmission. There are no mail routing problems with this setup, however, you must contact your ISP to
Page: 45
Configuring UUPlus for an ISP Multi-Drop Account (registered domain). In the case where your organization has a registered domain and your ISP puts all mail to that domain in a single mail box, you must use UUPlus' multi-Drop setting. Your email addresses will be in the format of <user1@yourdomain.ext>. In UUPlus Codan Server Setup, the Station Settings tab, the following settings are needed:
Smart Host: ISP UUPlus Name: yourdomain Full Internet Name: yourdomain.ext
UUPlus Codan Clients that connect to this server should be set as:
Full Email Address: user1@yourdomain.ext
The email address set in the mail user agent (Outlook, Eudora, Pegasus, etc.) should be <user1@yourdomain.ext>. yourdomain is used both as as the identifier between the Client and Server during transmission and in routing mail. The problem with mail routing with a multi-drop account is when receiving mail from a list-serve or when an email address is a BCC. Messages are routed based on the To: and Cc: lines in the message header, so if the message is addressed to multiple recipients of..., the message will go to the postmaster mail box. It can then can be forwarded to the correct user (If you can guess who it's actually to).
Configuring UUPlus for a Corporate Mail Server Multi-POP. In the case where your Codan Server connects to a corporate mail server it is assumed that there is a mail box for each user. Email addresses will be in the format of <user1@yourdomain.ext>, or whatever form your corporate email addresses are in. Note that these settings will work over a LAN, a full time Internet connection, or a dial-up connection to a local ISP.
Page: 46
UUPlus Codan Clients that connect to this server should be set as:
Full Email Address: user1@yourdomain.ext
The email address set in the mail user agent (Outlook, Eudora, Pegasus, etc.) should be <user1@yourdomain.ext>. hfusers is used only as the identifier between the Client and Server during transmission. In the above examples, a static IP address in dot notation is used for the POP and SMTP servers. On a corporate network mail servers usually are assigned static IP addresses so these can be used. This eliminates the need for UUPlus to perform a DNS lookup for a mail server on the network and the need to configure a local DNS server. There are no mail routing problems with this setup. Each user on the Codan Server must have a mail box on the cooperate server (unless the user does not receive corporate email). It is also possible to have the corporate mail server route mail directly to the Codan Server rather than using fetch. In this case, the corporate mail server and the Codan Server must be in the same Class C, that is, the first three groups of numbers in the IP address of both servers must match. If the corporate server is 192.168.0.2 and the Codan Server is 192.168.0.5, all is good. However, if the Codan Server is 192.168.1.2, it will refuse connections from the 192.168.0.* branch of the network.
Codan Server as a Multi-user Client to a UUPlus SOHO Pro Server. In addition to fetching mail from POP/SMTP servers, UUPlus Codan Server can receive it's mail feed via Codan HF modem from a UUPlus SOHO Pro server. The Codan Server can function as a multi-user client as well as a branch node, servicing remote users who connect to it via HF as shown in the following diagram: ISP <=LAN=> SOHO_Pro <=HF=> Codan_Server <=HF=> Codan_Client Email address format will vary from setup to setup depending on the parameters set on the SOHO Pro server, but the most likely email format for the Codan Server and Clients will be in the format of <user@subdomain.yourdomain.ext>. In the examples below, we will use the following names in our system, given that we have the registered domain of bishop.org:
Page: 47
UUPlus Codan Clients that connect to this server should be set as:
Full Email Address: pawn@knight.bishop.org
The email address set in the mail user agent (Outlook, Eudora, Pegasus, etc.) should also be <pawn@knight.bishop.org>. knight is used both as the identifier between the Client and Server during transmission and by bishop to route the mail to knight
Page: 48