Installation Guide for Multi-User Sites

WirelessMail version: 4.x

The WirelessMail installer lets users easily install and uninstall the software to their own mailboxes, as well as options for administrators to install to other people's mailboxes. This guide illustrates three options for installing WirelessMail to other users' mailboxes:

  • A) install to all users via the current mail design template. This will install it for ALL users on the mail server. They don't all have to enable it, but it will be there for all users to activate if they wish.
  • B) install to selected users via a new alternate mail design template. Similar to A, but where only *some* of the mail users will use WirelessMail, yet more users than you wish to install individually.
  • C) install individually to selected users. This is an ad-hoc installation for small numbers of installations at one time, requiring you to run the installer once for each user, each time pointing the installer to a different user's mail file. It takes 10 seconds to several minutes per install depending on the speed of the network connection from your workstation.

In all cases, the software runs the same. The difference is in how you get the software to the mailfiles and how many users you wish to install for at one time. You can do a mix of installations, too. Some users could be ad-hoc (C), while others are using a template reference in their database properties (B).

When installing to individual mail files (C), the installer sets the "Prohibit design refresh/replace from modifying" property in all WirelessMail design elements so that WirelessMail is not removed each night when the Design task runs or when you refresh the mailbox from a new mail template. In the template options (A) and (B), the installer UNchecks this property, so that when you can upgrade WirelessMail such changes will flow down to the mailfiles through the Design process.

The latest version of WirelessMail is always available at http://MartinScott.com/WirelessMail.

A) Install to the current template for all users

The easiest way to install WirelessMail for all users is to install to the existing mail template. Note: When installing WirelessMail to a template, we recommend that any users who already have an individually installed copy first uninstall those individual copies. Otherwise, they will end up with two copies of each WirelessMail agent and form. The uninstall ideally should be performed before the server installation, because after the server installation propagates to those users' mail files, they will see duplicate installations.

To do a template install for all users, click the "Advanced..." button in the WirelessMail installer application and then choose "Install to a mail template." Enter the filename of your mail template. If you don't know it, use steps 1 and 2 in option B below to determin the mail template filename.





The installer UNchecks the "Prohibit design refresh/replace from modifying" property in all WirelessMail design elements so that you can upgrade WirelessMail and such changes will flow down to the mailfiles through the Design process. Design updates take effect the next morning at 01:00 by default, or you can refresh all mailboxes immediately by loading the Design task on the Domino Server console.

Also, see Automatically populating the registration key below.

B) Install to an alternate template for selected users

If you want WirelessMail installed to selected mailboxes only, you can create a special template for those users.
NOTE: When installing WirelessMail to a template, we recommend that any users who already have an individually installed copy first uninstall those individual copies (use the WirelessMail installer to uninstall it, too). Otherwise, they will end up with two copies of each WirelessMail agent and form. The uninstall ideally should be performed before a template-level WirelessMail installation (A or B), because after the server installation propagates to those users' mail files, they will see duplicate installations.

To install to an alternate template...

1. determine your mail template NAME using File\Database(Application)\Properties, then look at the Design tab for the "Inherit design from master template", which might be something like StdR7Mail, StdR85Mail, etc.

2. determine the mail template FILENAME - From Notes, choose Ctrl-O, Server=[mail server name], Filename=Catalog. Look in the view "Applications by Title" for entries sorted under "Mail...". Open template document titles beginning with "Mail..." to see which template has a Design Template Name equal to the template NAME you determined in the step above. The FILENAME is usually named something such as mail7.ntf or mail85.ntf.

3. Make a copy of this template using File\Database(Application)\New Copy..., and add something such as WirelessMail to the end of the filename to differentiate it from the regular mail template. After creating this copy, it will open in Notes. With this template open in Notes, Choose File\Database(Application)\Properties and append -WirelessMail to the name of the template in "Database is a master template".

4. Download and run the WirelessMail installer, and choose the Advanced button then the "Install to a Mail template" option to select the filename of the new template copy you created in Step 3 above.

5. Set users' mailboxes to inherit from that new template name (instead of the regular mail template).

Database Properties (Design tab) for WirelessMail copy of template. WirelessMail is installed to this database

Database Properties (Design tab) for user's mailbox

The installer UNchecks the "Prohibit design refresh/replace from modifying" property in all WirelessMail design elements so that you can upgrade WirelessMail and such changes will flow down to the mailfiles through the Design process. Design updates take effect the next morning at 01:00 by default, or you can refresh all mailboxes immediately by loading the Design task on the Domino Server console.

Also, see Automatically populating the registration key below.

Automatically populating the registration key (for Template installations only)

In either of the two template install options above, you can optionally enter the Server-wide or OU-wide, or O-wide registration key (if purchased) in a central place so that you do not have to distribute it to each user. After you have installed to a template, open the design of the template with Domino Designer. Open the form "WirelessMail Configuration" that is enabled for use with Notes (a check appears in the Notes column of the form list). Add your 5-digit key, surrounded by double quotes " and " in the Default Value property of the regKey field (see attached image). Exit and save this form. This will cause the key value to default for users when they open their WirelessMail Configuration.




C) Install to individual users' mailfiles

You can install directly to users' mailfiles. Use the Advanced... button on the WirelessMail installer. Change the File Name and Server values to that of the user. Also, set the user's forwarding address. Then click the green "Install WirelessMail" button.






Support

For support, please Contact Us