Installing, Upgrading, or Removing Post.Office

3.1 Installation Instructions and Other Documentation

Where can I find installation instructions?

The Post.Office Installation Guide contains detailed installation instructions. The manual is available for viewing from our web site, can be obtained independently from the FTP download page, and is included as part of the standard software download package.

Some brief (1-2 page) installation guidelines for all supported platforms are also available in the README files which can be found on our web site at http://www.software.com.

Important Information for NT Users: We’ve developed a new tool to assist you through the installation process. It includes detailed information on pre-installation requirements, the installation process, and related topics such as proper configuration of DNS records. You can open the Simple Online Support (SOS) tool by launching your browser and pointing it to: http://www.software.com/tech/sos/po-install.htm.

How do I download a copy of the Post.Office manual?

You can download a copy of the manual from our web site (www.software.com). Simply follow the links from the Products page to locate the Post.Office software. Documentation associated with the software is also listed there.

3.2 Licensing Issues

NT only – How do I update my license number?

To enter your new license number, simply re-run the Post.Office Setup program. It will give you the option to update your license or serial number. Choose the update option and proceed as instructed, entering your new license number when prompted.

Note that this is a non-destructive procedure that will update your license number but make no other changes. All of your accounts and configuration information will remain intact.

UNIX only – How do I update my license number?

You will need to re-run the Setup portion of the installation program to record your new license number. All account information will remain intact during this process.

Change directory to the location in which the Setup file is stored. If you originally installed Post.Office using the default locations, it will be found in either /opt/post.office (Solaris 2 users), or /usr/local/post.office (all other UNIX users).
Type ./Setup to re-run the Setup portion of the installation program. This will allow you to modify certain configuration information including your Post.Office license number.
Respond as desired to the options presented being sure to enter the new license number where appropriate. Post.Office will use the new number to replace the old one.

Why does a notice that my license has expired appear on my web Authentication form and in the headers of all my messages?

This occurs if you have been using a trial version of the software (not the 10 user free pack) and the trial period has passed. Please contact Sales@Software.com to obtain a valid license. Once a valid license number has been entered no further expiration messages will appear.

3.3 Pre-Installation Concerns

Why can’t I use Shared Networked Drives for Post.Office?

Do not utilize network drives for storage on a mail server because you would not want your partitions to be unavailable if for some reason your remote host was not accessible but your mail server was functioning.

Will Post.Office automatically set up new accounts to replace those already in existence on my old Mail Transport Agent (MTA)?

UNIX Users

Yes, if you want to replace your present host MTA with Post.Office directly, you can choose to automatically have the Install process set up Post.Office mail accounts for each login account as it replaces your old system.

NT Users

Post.Office for NT does not automatically create accounts for users, however, if you are interested in batch entering large numbers of accounts, it can be done; however, you will be required to edit existing utilities and create your own input files. Send an E-mail message to support@software.com for additional information.

3.4 Installation Error Conditions

To avoid errors during installation make sure you double check the system requirements listed in the Introduction to Post.Office section of this FAQ. Once all pre-installation requirements have been met, proceed with the installation process.

NT only: Why can’t I log into NT to finish installation?

To complete installation you need to access the Postmaster account on Post.Office, not the Post.Office NT user.

Point your browser to the location http://hostname.domainname:port

When you are at the Post.Office Authentication Screen be sure you are typing:
postmaster@yourdomainname and using the Postmaster password you entered during installation.

UNIX only: I am getting a UNIX Install error “gethostbyname”. Why?

It appears that the system can’t resolve the fully qualified host.domain name. Your DNS server must have this defined so that it can be resolved or you can include the long name as an alias in your /etc/hosts file on each machine. We would recommend defining it in your DNS server.

UNIX only: I am getting an error that says the system is “unable to write the accounts database”. Why?

This could be caused by one of two reasons. The first is that you might not have proper permissions into the file directories specified for installation of the software. The second is if you are re-installing Post.Office on a machine and did not complete the “de-installation” instructions as defined (removing the /etc/post.office.conf file and all associated directories). Please re-perform the complete de-installation instructions covered in this document and try the installation again.

UNIX only: When I attempt to extract the Post.Office software I get a
tar: directory checksum error. What should I do?

You need to download the ftp version of Post.Office with the “bin” command first so that it downloads in binary mode. The error you are getting is what happens if the file was not transferred as a binary executable.

3.5 Upgrade Procedures

Will I be notified of new releases?

We send messages to all e-mail addresses registered with our sales department. Typically these are the e-mail addresses given at time of purchase. If you feel you are not receiving appropriate notification, please contact Sales@Software.com to verify that we have your accurate address.

You can also check our web site for information on the most recent releases.

Note: Notification messages are sent in staggered groups in an effort to avoid the frustration of unacceptably slow performance if everyone were to download the new version at the same time.

How do I upgrade Post.Office in NT?

All upgrades to Post.Office 3.0 (other than the 10 user free version) require the purchase of a new license number. If you do not have a valid 3.0 license number, please contact Sales@Software.com.

Note: The same software is used for installing Post.Office version 3.0, upgrading from an earlier version (1.9.3 or 2.0), or entering a new license number to accommodate additional accounts/mailboxes. The program checks to see if Post.Office already exists, then self-adjusts to perform the necessary installation or upgrade procedure.

The Post.Office upgrade operation is performing tests of considerable complexity including database regeneration. To ensure success you must back up your system prior to upgrading and allow adequate time to complete the upgrade operation. It is essential that the process run to completion without interruption.

A considerable portion of the time required for upgrade is spent resetting permissions on the various Post.Office directories. Installations with a large number of accounts, and therefore a large number of mailbox directories, should expect delays during that portion of the upgrade process. For example, it took approximately one hour to upgrade a server with 250 accounts.

Caution: If you have more than 30,000 mail accounts established on your server or if you are making use of linked mailbox directories, please contact Support@Software.com for assistance before attempting to upgrade to Post.Office version 3.0.

Please note that because Post.Office forms were significantly modified in version 3.0. Users working with customized versions of the Post.Office forms need to perform the following steps when upgrading their system to version 3.0. You cannot upgrade using old forms that were already customized; instead…

Get copies of the new standard forms for Post.Office version 3.0 by sending a request to Support@Software.com (ask nicely in the body of the message).
Revise the new standard forms to suit your needs.
Backup your system and upgrade the Post.Office software per instructions that follow.
Once the upgrade process is complete, re-submit your revised versions of the standard 3.0 forms for use with the upgraded system.
In addition, please note that the size of the Registry expands during upgrade. If insufficient space is available the upgrade will fail and recovery will be required. Although the exact amount of space required depends on a variety of factors including the number of Post.Office accounts currently established, a good rule of thumb is that Maximum Registry Size should be at least twice Current Registry Size. All users should verify that the Maximum Registry Size is sufficient by doing the following:

From the Program Manager double click on the Main\Control Panel\System icons in the order indicated.
Click on the Virtual Memory button in the System window.
In the Vital Memory window check the values in the fields titled Current Registry Size and Maximum Registry Size. The maximum size should be at least twice the current size. If it is not, make the necessary correction and click on the OK button.
NT Upgrade Instructions:

To permit recovery if the upgrade process is accidentally interrupted (or fails to complete for any reason), backup instructions are included as the initial steps in the upgrade process. DO NOT omit these important first steps.

1. Back up the required Registry information by launching the Registry Editor, (REGEDT32.EXE), locating the following keys, and saving each one independently (by selecting the desired key, pulling down the Registry menu, and then choosing the Save Key command).

a) HKEY_LOCAL_MACHINE\SOFTWARE\Software.com\Post.Office
(suggested name & location: anotherhost\temp\Post.OfficeRegKeyBackup)

b) HKEY_LOCAL_MACHINE\SOFTWARE\Software.com\Post.Office\MTA-Accounts
(suggested name & location: anotherhost\temp\MTA-AccountsRegKeyBackup)

2. Back up the required file system information. The exact location of the required directories can be found via the Program Manager by double clicking on the Main\Control Panel\Post.Office icons in the order indicated. When the Post.Office applet window appears look at the bottom to determine the locations of the following items:

a) The Spooling Directory containing configuration information
(suggested name & location: anotherhost\temp\Post.OfficeBackupconfig)

b) the Program Directory containing Post.Office executables
(suggested name & location: anotherhost\temp\Post.OfficeBackupexecs)

c) the Mailbox Directory containing your mailbox information
(suggested name & location: anotherhost\temp\Post.OfficeBackupmailbox)

Back up those directories in addition to the Registry keys mentioned in Step 1 above. The back up of the Mailbox directory, in particular, is of extreme importance as this directory is restructured during the upgrade process.

Note: If you aren’t already doing so, you should be backing up these items on a regular basis.

3. Verify that you are logged on properly. If you are on a workstation or non-primary domain controller server you must be logged on as the Administrator of your host machine before running Setup.exe. Only if you are on a primary domain controller server can you log in as the Administrator of your domain.

4. Locate the Post.Office package either on the CD on which it was delivered, or in the directory in which you stored a downloaded version.

5. If you obtained the software from our web or ftp site simply double-click on the Post.Office “.exe” file. The package will self extract and the Setup program will be launched automatically. If you obtained the software on CD, double-click on the Setup.exe file.

Note: The Setup program occupies only half your screen to allow for simultaneous display of Simple Online Support (SOS). SOS is intended for use as a guide during initial installation, however it contains supplemental information that may also be of interest to people upgrading their software. To access SOS, launch your browser and point it to: http://www.software.com/tech/sos/po-install.htm

6. The Installshield GUI will prompt you to choose one of three options: Remove, Update, or Set License Number.

Choose Update and click on the Next button. This installs all the new software and configuration files, retaining the values of any parameters you have customized and all information in your accounts database. When it’s finished, the Setup program will re-start Post.Office for you.

Note: You will be required to enter your 3.0 license number as one of the first steps in the upgrade process. To prevent unintended upgrades the program will not execute without a valid 3.0 license number. Please contact Sales@Software.com if you wish to purchase the required license.

Caution: If you encounter a permissions error when copying the Post.Office.cpl file, you should answer “No” (don’t bother to copy) and continue with the upgrade. The upgrade will complete successfully, but the Post.Office.cpl file will not be updated. You can contact Support@software.com after the upgrade to obtain the 3.0 version of that file and instructions on how to install it.

Remember, after the upgrade, any account which uses the NT integrated password feature *and* was deliberately locked by the Postmaster should be reviewed. (To determine an account’s status post-upgrade, access the appropriate Account Data Form and check the response to the question “Lock Account to prevent POP3 access and configuration via Web or E-Mail?”. If you wish to lock the account and prevent access, the answer should be Yes. If you do not wish to lock the account, the answer should be No.)

How do I upgrade Post.Office in UNIX?

All upgrades to Post.Office 3.0 (other than the 10 user free version) require the purchase of a new license number. If you do not have a valid 3.0 license number, please contact Sales@Software.com.

Note: The same software is used for installing Post.Office version 3.0, upgrading from an earlier version (1.9.3 or 2.0), or entering a new license number to accommodate additional accounts/mailboxes. The program checks to see if Post.Office already exists, then self-adjusts to perform the necessary installation or upgrade procedure.

The Post.Office upgrade operation is performing tests of considerable complexity including database regeneration. To ensure success you must back up your system prior to upgrading and allow adequate time to complete the upgrade operation. It is essential that the process run to completion without interruption.

Caution: If you have more than 30,000 mail accounts established on your server or if you are making use of linked mailbox directories, please contact Support@Software.com for assistance before attempting to upgrade to Post.Office version 3.0.

Please note that because Post.Office forms were significantly modified in version 3.0. Users working with customized versions of the Post.Office forms need to perform the following steps when upgrading their system to version 3.0. You cannot upgrade using old forms that were already customized; instead…

Get copies of the new standard forms for Post.Office version 3.0 by sending a request to Support@Software.com (ask nicely in the body of the message).
Revise the new standard forms to suit your needs.
Backup your system and upgrade the Post.Office software per instructions that follow.
Once the upgrade process is complete, re-submit your revised versions of the standard 3.0 forms for use with the upgraded system.
Caution: Please note that Program Delivery is turned off by the upgrade process. A reminder to re-enable Program Delivery is included in the instructions for those users to whom this feature applies.

Note: If your UNIX mailboxes and POP mailboxes currently reside in the same directory, you will need to perform one additional step at the end of the upgrade process. For details, please refer to the upgrade instructions for your particular platform.

Instructions for upgrading the UNIX version of Post.Office vary slightly from platform to platform. Read the appropriate section below for specific directions on upgrading your particular installation.

Solaris Upgrade Instructions:

To permit recovery if the upgrade process is accidentally interrupted, backup instructions are included among the initial steps in the upgrade process. DO NOT omit this important operation.

The following upgrade instructions assume that you have installed Post.Office in the default locations which are /opt/post.office (program executables) and /var/spool/post.office (the spooling directories). If you selected other locations you will need to adjust the instructions accordingly. To determine the current locations of your Post.Office, Program, and Mailbox directories list the contents of the /etc/post.office.conf file.

1. Log on as root.

2. Back up the contents of the following items:

a) /opt/post.office (the Post.Office executables)

b) /var/spool/post.office (the configuration information)

c) /var/spool/mailbox (the mailbox information)

d) /etc/post.office.conf (your configuration file)

Note: If you aren’t already doing so, you should be backing up these directories regularly.

3. Shutdown Post.Office by typing:

/opt/post.office/post.office shutdown

4a. If your software was delivered on CD: mount the CD on your computer and change directory to the location containing the Post.Office archive for your particular operating system/platform.

4b. If you downloaded the software from our ftp or web site: uncompress the file you downloaded into a temporary directory and expand the resulting archive file to create the Post.Office package (SCOM-MTA) by typing:

cd /var/tmp

uncompress PO30-solaris2.tar.Z

tar xvpf PO30-solaris2.tar

5. Remove the old package (the Solaris packaging facility will not let you overwrite an old package with a newer version) by typing:

pkgrm SCOM-MTA

Note: This will not remove your current configuration files or change your existing accounts in any way.

6. Install the new package by typing:

pkgadd -d . SCOM-MTA

This will “remember” where you had installed everything, and give you the option of skipping the typical installation Q&A.

Caution: The upgrade program will ask if you wish to change configuration information. You should answer “no”. Only under exceptional circumstances while assisted by support personnel should you modify configuration information while upgrading.

7. If you are currently using Program Delivery you will need to re-enable that feature by typing:

chmod u+s /opt/post.office/local/Program-Deliver

rm /opt/post.office/trusted/NO-PROGRAM-DELIVERIES

Caution: There are security issues associated with the use of Program Delivery. Please read the manual to ensure you understand those issues before enabling this feature.

8. Run the Post.Office configuration program: /opt/post.office/Setup

This process configures the new software, allowing retention of all pre-existing configuration parameters. All account information is maintained through this process. When the Setup program is finished, it will re-start Post.Office for you.

9. If your UNIX mailboxes and POP mailboxes are stored in the same directory, you must cd to that directory and run the following file:

/utils/FixMaildropFile *

HPUX10 Upgrade Instructions:

To permit recovery if the upgrade process is accidentally interrupted, backup instructions are included among the initial steps in the upgrade process. DO NOT omit this important operation.

The following upgrade instructions assume that you have installed Post.Office in the default locations which are /usr/local/post.office (program executables) and /usr/spool/post.office (the spooling directories). If you selected other locations you will need to adjust the instructions accordingly. To determine the current locations of your Post.Office, Program, and Mailbox directories list the contents of the /etc/post.office.conf file.

1. Log on as root.

2. Back up the contents of the following items:

a) /usr/local/post.office (the Post.Office executables)

b) /usr/spool/post.office (the configuration information)

c) /usr/spool/mailbox (the mailbox information)

d) /etc/post.office.conf (your configuration file)

Note: If you aren’t already doing so, you should be backing up these directories regularly.

3. Shutdown Post.Office by typing:

/usr/local/post.office/post.office shutdown

4a. If your software was delivered on CD: mount the CD on your computer, change directory to the location containing the archive file for the appropriate UNIX platform, copy that archive into a temporary directory, and expand it by typing:

cp XXX.tar* /usr/tmp

cd /usr/tmp

tar xvpf XXX.tar*

(where XXX represents your platform type)

4b. If you downloaded the software from our ftp or web site: uncompress the file you downloaded into the temporary directory and expand the resulting archive file by typing:

cd /usr/tmp

uncompress PO30-XXX.tar.Z

tar xvpf PO30-XXX.tar

(where XXX represents your platform type)

5. Change to the newly created directory and install Post.Office version 3.0.

cd Post.Office

./installpo

The install script will “remember” where you had installed everything, and give you the option of skipping the Q&A. This procedure will not remove your current configuration files or change your existing accounts in any way. When the installation program is finished, it will re-start Post.Office for you.

Caution: The upgrade program will ask if you wish to change configuration information. You should answer “no”. Only under exceptional circumstances while assisted by support personnel should you modify configuration information while upgrading.

6. If you are currently using Program Delivery you will need to re-enable that feature by typing:

chmod u+s /usr/local/post.office/local/Program-Deliver

rm /usr/local/post.office/trusted/NO-PROGRAM-DELIVERIES

Caution: There are security issues associated with the use of Program Delivery. Please read the Post.Office manual to ensure you understand those issues before enabling this feature.

7. If your UNIX mailboxes and POP mailboxes are stored in the same directory, you must cd to that directory and run the following file:

/utils/FixMaildropFile *

Upgrade Instructions for All Other UNIX Platforms:

To permit recovery if the upgrade process is accidentally interrupted, backup instructions are included among the initial steps in the upgrade process. DO NOT omit this important operation.

The following upgrade instructions assume that you have installed Post.Office in the default locations which are /usr/local/post.office (program executables) and /var/spool/post.office (the spooling directories). If you selected other locations you will need to adjust the instructions accordingly. To determine the current locations of your Post.Office, Program, and Mailbox directories list the contents of the /etc/post.office.conf file.

1. Log on as root.

2. Back up the contents of the following items:

a) /usr/local/post.office (the Post.Office executables)

b) /var/spool/post.office (the configuration information)

c) /var/spool/mailbox (the mailbox information)

d) /etc/post.office.conf (your configuration file)

Note: If you aren’t already doing so, you should be backing up these directories regularly.

3. Shutdown Post.Office by typing:

/usr/local/post.office/post.office shutdown.

4a. If your software was delivered on CD: mount the CD on your computer and change directory to the location containing files for your particular operating system/platform.

Digital UNIX Note: The default options used to mount a CD may not be appropriate. Be sure to specify “cdfs” as the file system type and include the Rock Ridge Interchange Protocol option “rrip”. For example, if your CD ROM device is assigned a SCSI-ID of 6 and you want to access the CD ROM from the directory /CDROM, you would use the following command:

mount -r -t cdfs -o ro,rrip /dev/rz6c /CDROM

SunOS Note: The default options used to mount a CD may not be appropriate. Be sure to specify “hsfs” as the file system type.

4b. If you downloaded the software from our ftp or web site: uncompress the file you downloaded into a temporary directory, expand the resulting archive file, and then change to the newly created directory by typing:

cd /var/tmp

uncompress PO30-.tar.Z

tar xvpf PO30-.tar

cd Post.Office

5. Install the new version of Post.Office.

./installpo

The install script will “remember” where you had installed everything, and give you the option of skipping the Q&A. This procedure will not remove your current configuration files or change your existing accounts in any way. When the installation program is finished, it will re-start Post.Office for you.

Caution: The upgrade program will ask if you wish to change configuration information. You should answer “no”. Only under exceptional circumstances while assisted by support personnel should you modify configuration information while upgrading.

6. If you are currently using Program Delivery you will need to re-enable that feature by typing:

chmod u+s /usr/local/post.office/local/Program-Deliver

rm /usr/local/post.office/trusted/NO-PROGRAM-DELIVERIES

Caution: There are security issues associated with the use of Program Delivery. Please read the Post.Office manual to ensure you understand those issues before enabling this feature.

7. If your UNIX mailboxes and POP mailboxes are stored in the same directory, you must cd to that directory and run the following file:

/utils/FixMaildropFile *

3.6 De-Installing Post.Office

How do I de-install or remove Post.Office in NT?

Launch and re-run the original Setup program. When prompted, select the De-Install option and proceed with the process to remove the Post.Office software.

If you are de-installing in order to re-install Post.Office, you should reboot prior to re-installing. Unfortunately (due to NT caching.), some of the Registry deletions do not take affect until the server is rebooted.

Note: The Add/Remove Programs control panel applet does not properly de-install the Post.Office software. Please follow the de-installation instructions above.

Setup.exe doesn’t see Post.Office to remove it. How can I delete it manually?

If your setup.exe doesn’t see Post.Office then definition for Post.Office must be missing from the CurrentControlSet Keys in the registry. You will need to delete Post.Office and all related files/directories manually.

Stop the Post.Office service.
Log on as the Local NT Administrator of your host (using the NT Username Administrator).
Define your Post.Office-User as a part of the Administrator’s Group and with the Right “Logon Locally”
Open your User Manager, Open the Administrator’s Group, Add your Post.Office-User as a member – OK
In your User Manager, Open Policies -> User Rights -> “Log on Locally” -> Add -> Show Users -> Highlight Post.Office-User -> ADD -> OK -> OK.
Log out as Administrator and Log in as your Post.Office-User
Delete the Software.com Registry Key:
Run regedt32 and open the window for HKEY_LOCAL_MACHINE
Highlight SOFTWARE\Software.com
Delete the Key Software.com (Edit -> Delete)
Delete the following Service Registry keys:
Within HKEY_LOCAL_MACHINE highlight CURRENTCONTROLSET/SERVICES/POST.OFFICE and delete that item.
Within HKEY_LOCAL_MACHINE highlight CURRENTSET001/SERVICES/EVENTLOG/APPLICATION/POST.OFFICE and delete that item.
Within HKEY_LOCAL_MACHINE highlight CURRENTSET003/SERVICES/EVENTLOG/APPLICATION/POST.OFFICE and delete that item.
Delete the Post.Office Configuration directory. (By default it is “\winnt35\system32\spool\post.office”.)
Run File Manager and highlight your “post.office” directory.
Delete the directory Post.Office (File – Delete)
Delete the Post.Office Mailbox directory (by default it is “\winnt35\system32\spool\post.office\mailbox”).
Note: If it lives under your previous directory you have already removed it.
Run File Manager and highlight your “Mailbox” directory.
Delete the directory Mailbox (File – Delete)
Delete the Post.Office Control Panel Applet File (you will only need to do this if you were running v1.9.3 or >)
Run File Manager and highlight “winnt35\system32\post.office.cpl”
Delete the file (File -> Delete)
Delete the Post.Office Executable directory (by default it is “\win32app\post.office”).
Run File Manager and highlight your “post.office” directory.
Delete the directory Post.Office (File – Delete)
If you are using our 3.0 version of Post.Office, you will need to delete the Post.Office.dll which is located in your NT system directory. (e.g. winnt\system32\post.office.dll)
Remove Post.Office user from the Administrator’s Group
Remove the Right “Logon Locally” for the Post.Office-User.
Delete all NT users that are (or were) running Post.Office for you (like Post.Office-user or MailServer-User)
Reboot your server.

How do I de-install or remove Post.Office in Solaris?

As root:

Remove the Post.Office MTA Package using the pkgrm utility:
pkgrm SCOM-MTA
If you haven’t already done this you might need to remove the original install package:
rm -rf /var/spool/pkg/SCOM-MTA
Replace sendmail in /usr/lib:
cd /usr/lib
ls -lF sendmail* (You should see that sendmail is a link)
rm sendmail
mv sendmail.bak sendmail
Edit /etc/inetd.conf (removing the # (Comments) in front of the services that were originally disabled for Post.Office); i.e., finger
Reset the inetd process:
kill -HUP innetd_process_number
Remove the postoffice directory:
rm -rf postoffice_directory
(the default is /opt/post.office)
Remove the mailbox directory:
rm -rf mailbox_directory
(the default is /var/spool/mailbox)
Remove the config directory:
rm -rf postoffice
(the default is /var/spool/post.office)

How do I de-install or remove Post.Office in SunOS4/IRIX?

Here are the instructions for PERMANENTLY removing Post.Office on SunOS 4.

Look at the file /etc/post.office.conf: cat /etc/post.office.conf
Shutdown Post.Office: /usr/local/post.office/post.office shutdown
Remove each of the listed directories and their contents:
rm -rf /usr/local/post.office
rm -rf /var/spool/post.office
rm -rf /var/spool/mailbox
Remove the /etc/post.office.conf file
rm /etc/post.office.conf
to re-enable sendmail:
cd /usr/lib; # check that sendmail is a link before removing;
ls -l sendmail
rm sendmail
mv sendmail.bak sendmail