MailLink for PowerTalk INET 1.6: ReadMe File (5/96)

This article is the MailLink for PowerTalk INET Read Me File.

Mail*Link for PowerTalk/INET 1.6

Mail*Link Internet for PowerTalk is a personal gateway for PowerTalk users. This gateway will allow PowerTalk users to send mail via SMTP and receive mail from a POP3 account. Mail can be sent and read with any PowerTalk mail-enabled application.

This release of Mail*Link¿ for PowerTalk¬/INET is the first release of this gateway by Apple Computer Inc. This gateway is functionally equivalent to version 1.5.1. Future versions of this software will be modified and enhanced.

This software is licensed to you under the Macintosh System 7.5 license agreement. All terms and conditions of this license must be followed.

Upgrade Note: If you are upgrading from version 1.5.1 or earlier it is VERY IMPORTANT that you follow the instructions in the Upgrading Section below.

The installation and upgrade procedure for this software will still install the StarNine demonstration key files (which were part of the 1.5.1 release). However the 1.6 release of the gateway has been modified to ignore the key files and thus will never expire.


It is required that you install and configure MacTCP before using this gateway. See the PT/INET User Guide for more information.


ITEMS OF NOTE
=============

OpenTransport users: This gateway does not function correctly when used with Apple's OpenTransport. The gateway will connect one time but will not reconnect without a reboot. Apple is currently investigating problem.


INSTALLATION INSTRUCTIONS
=========================

For new installations only:

We recommend that you install this software via the installer script.

1. Double click on either the "Installer" icon.
2. Select the drive on which you wish to install this software and click
  Install.
3. Reboot the system after the software has been properly installed.


UPGRADE INSTRUCTIONS
====================

If you are upgrading from a previous release of Mail*Link Internet for PowerTalk, you should follow these instructions:

1. Install the software as instructed in the section "INSTALLATION
  INSTRUCTIONS".
2. After the system has rebooted, open the "PowerTalk Key Chain".

3. Open the PT/Internet personal gateway in the key chain. The
  installation procedures change the file-id that PowerTalk uses to
  locate the Mail*Link PT/INET file. Opening and closing the PT/Internet
  Service configuration window will cause the new file-id to be written
  into the PowerTalk configuration file.
4. Close the key chain. You will be told that you must reboot the system
  before PowerTalk will activate the gateway.
5. Reboot the system.

If you have trouble with the gateway after upgrading please re-install by following the instructions in the Clean Upgrade Install section below.


CONFIGURATION
=============

Ñ Creating your PT/Internet personal gateway

Once you have installed the software and rebooted the system (as described above), follow these instructions to create your PT/Internet personal gateway.

1. Open the "Key Chain" located on your desktop.
2. Press the "Add" button.
3. You will be presented with a list of services that are available.
  Select "PT/Internet".
4. A new item with the server name of "Not Configured" and a service type

  of "PT/Internet" will appear in your "Key Chain".
5. Proceed to the "Configuring" section below.

Ñ Configuring your PT/Internet personal gateway

To configure the PT/Internet personal gateway, ensure that the "Key Chain" has been opened.

1. Double click (Open) the item with a service type of "PT/Internet". The
  PT/Internet personal gateway only allows one instantiation, so there
  should only be one item with this type in the Key Chain window.
2. You should configure each item in this window before closing the
  window. Window closing is equivalent to pressing the "OK" button in a
  dialog. The "Key Chain" configuration windows have no "Cancel"
  operation, so please ensure each item is properly filled in before
  closing the window (you can always come back and change the selections
  at a later date, but it is better if each item is properly filled in).
3. To finalize configuration YOU MUST select the preferences button on
  open the PT/INET Preference dialog. Change any preferences you need to

  (it is not necessary to change any) and close the window.
4. Once you have entered the information in the configuration window,
  close the window with a mouse click in the close box or by typing
  "<command>W". It may take a few seconds for the window to close. This
  is because PowerTalk is activating all of the personal gateway
  subsystems and informing them of their new configuration. Be patient.
5. Once the PT/Internet configuration window is closed, close the Key
  Chain window.


CLEAN UPGRADE INSTALLATION
==========================

Use this procedure if you are experiencing problems with the gateway software. You should not need to use this procedure for normal installs. To perform a "Clean Install" of the gateway software, use the following procedure.

NOTE: Some gateways may remove mail from your In Tray and Out Tray when they are reinstalled. Be sure to back up any items in your InTray and OutTray by dragging them to another folder on your hard drive.

NOTE: This will remove all services from your keychain, so be sure you have the passwords for these services handy. If you have personal gateways already installed, you will need to set them up again, so be sure you write down the setup information that is contained in each key, if necessary.


This procedure removes all "Mail*Link" gateways. If you have multiple "Mail*Link" gateways installed, you will need to re-install each of the gateways you want to use.

1. Open the Extensions folder, located inside the System Folder. Find the
  following item(s) and drag to the trash (note only the gateways you
  have installed will be in the Extensions folder):
  Mail*Link PT/QM
  Mail*Link PT/MS
  Mail*Link PT/INET

2. Open the Preferences folder, located inside your System Folder. Find
  the following items and drag them to the trash.
  StarNine (folder)
  PowerTalk Setup Preferences
  PowerTalk Startup Preferences

3. Find the "Mail*Link Extras" folder, on the top level of your hard
  drive. Drag this folder to the trash.

4. Restart your machine. After you have restarted, choose "Empty Trash"
  from the Special menu.

5. Double-click the installer for the desired software, and click Install
  at the Easy Install screen. After the installation is complete, your
  machine will restart. If you are installing more than one gateway,

  repeat this step for each gateway.

6. Open the keychain and click "Add". Select the gateway from the list of
  choices. A new item will be added to the Key Chain. Open this key,
  and configure the gateway as you normally would. The gateway should
  now be functioning.


MANUAL INSTALLATION INSTRUCTIONS
================================

The manual installation instructions are for advanced users who wish to build their own installation process or who wish to install only portions of this gateway. Installation using this process should be conducted only after you fully understand how to use your Macintosh, and how to configure and use PowerTalk gateways.

If you must install this version manually, please follow these instructions:

1. Place the distribution diskette in the floppy drive.
2. Open the folder named "Drop Contents on System Folder".
3. Select all of the items in this folder and drag them onto the "System
  Folder" icon.
4. You will be presented with a dialog box that indicates these files
  belong in special locations. Click "OK".

5. Close the "Drop Contents on System Folder" folder.
6. Open the folder named "Place Contents in Preferences Folder".
7. Select all of the items in this folder and drag them into the
  "Preferences" folder (which is located within your "System Folder".
8. If you are presented with a dialog indicating that you will be
  replacing existing files, click cancel. You should perform the
  "Automatic Installation" procedure (above).
9. Reboot the system. This is necessary because some of the software
  installed is only activated at boot time.

NOTE: With version 1.6 it is no longer required to install the key files.


KNOWN INCOMPATIBILITIES
=======================

Ñ When a mail message is forwarded, the name and address of the original sender are not preserved.

Ñ CE Software's QM for AOCE may be used to send mail, although you must select the AppleMail format when sending the message. This application may NOT be used as the default mail reader. If it is selected, AppleMail will be used instead.


SUPPORT
=======


If you need any additional help installing, configuring or using this gateway please call Apple Support at: 1 (800) SOS - APPL.



Published Date: Feb 18, 2012