Installation of OWA For PDA / OWA For WAP
This guide describes the installation of the OWA For PDA and the OWA For WAP applications from www.leederbyshire.com .
Please note that if you are installing over a version older than 4.50 (versions prior to 4.50 required manual installation), then you should remove the application manually before proceeding.
The installation procedure for OWA For PDA and OWA For WAP are identical, but any screen shots you see in this document will have been taken from an installation of OWA For PDA. If you are installing OWA For WAP, please assume that the word 'WAP' will appear on the screen instead of 'PDA'.
Requirements:
Windows Server
running MS Outlook Web Access 5.5, or
Windows Server running MS Exchange 2000 or 2003.
Installation:
To install the application, run the downloaded executable file by double-clicking on it. Shown here are the dialog boxes that you will see during the installation. The first dialog box to be displayed is the Welcome Dialog shown in figure 1.
Fig. 1 - The Welcome dialog.
Next, you will see the License Agreement (figure 2). Please indicate your acceptance of these Terms and Conditions if you wish to continue the installation, otherwise click 'Cancel' to terminate the installation.
Fig. 2 - The license agreement.
It is strongly recommended that you read the security information shown in the next dialog box (figure 3) before continuing.
Fig. 3 - Relevant security information.
Next, please select where you would like the application files to be installed (figure 4). The default location is a folder underneath the Default Web Site folder.
Fig. 4 - The application files destination folder.
Next, please choose a name for the Start Menu folder name (figure 5). The default folder name is 'OWA For PDA' or 'OWA For WAP'.
Fig. 5 - The Start Menu folder name.
Next, please choose which version of MS Exchange you are connecting the application to (figure 6). The default version is 2000 or 2003. Please select 5.5 if you intend to use it with this version instead.
Fig. 6 - Selecting the MS Exchange version.
Next, click Install on the next dialog (figure 7) to begin copying the files to your installation folder.
Fig. 7 - The installation tasks summary.
After the application files have been copied to the installation folder, Setup will ask you to choose which Web Site you want to add the product's Virtual Directory to (figure 8). It will list the Web Sites that are available on the server; please select the one that you wish to use. In most cases it is recommended that you use the 'Default Web Site', but if you have redirected it to your Exchange Virtual Directory then you will need to choose another. It is not recommended to choose the 'Administration Web Site'.
Some administrators redirect the Default Web Site to get it's content from the MS Exchange Virtual Directory so that their users do not need to type '/Exchange' on the end of the server URL to access Outlook Web Access. If the Default Web Site on the server has been configured in this way, then you will not be able to host any other Virtual Directories (including the one required by this product) underneath it. In this case, if there are no other suitable Web Sites configured on the server, you will need to click 'Cancel', exit the setup program, create another Web Site, and then re-run setup.
Fig. 8 - Selecting the installation Web Site.
After Setup has created the application's Virtual Directory, please read the Release Notes (figure 9).
Fig. 9 - Application release notes.
The next dialog box (figure 10) is the last one you will see, indicating a successful installation.
Fig. 10 - Installation is complete.
You should now be able to access the application by browsing to the Virtual Directory name. So, for example, if your IIS server is called MYSERVER, you can access it with HTTP://MYSERVER/OWA-PDA (for OWA For PDA), or HTTP://MYSERVER/OWA-WAP (for OWA For WAP). OWA For PDA can be viewed in Internet Explorer, and there will be a shortcut to it on your Start Menu so that you can test it. OWA For WAP can't be viewed with an HTML browser because it outputs WML, so you will need a WAP 'phone (or a PC WAP browser) to test it.
If you are using Exchange 2000 / 2003, please make sure you have given your non-Admin users the 'Log On Locally' right on the server. OWA 5.5 installations will already have assigned this right.
After Installation:
There are additional options that you can configure within a file named DEFINE.INC , these are described below. Most of the options are used to change the visual appearance of the displayed output, but when configuring the options for the WAP version of the application, you will need to remember that WAP only allows a page size of about 1500 bytes, so it is important not to make too many changes at once.
ADDRESSESPERPAGE - This defines the number of entries to display in address book lists.
APPOINTMENTSPERPAGE - This defines the number of appointments to show in appointment lists.
BANNERTEXT (PDA only) - If you put some text in here, it will be displayed on the login page. You can use HTML tags here, too, e.g.:
CONST BANNERTEXT = "<b><i>MY COMPANY NAME</i></b>"
BODYCOLOR (PDA only) - You can use this to specify a background colour (using an HTML literal) for all the application output, e.g.: "RED", "blue", "#F1F2F3", etc. If BODYCOLOR, TABLEROWCOLORA or TABLEROWCOLORB are defined in the Define.inc file, then the 'Themes' section of the 'Options' page will not be available to end users. Here is an example of a table with colors defined, or a theme applied.
CHARSET (PDA only) - You can use this to define a character set for the application output, e.g. "UTF-8" .
EX5P5 - Set to True if your Exchange server is version 5.5 . This value is normally configured by the Setup program.
EXPANDFOLDERS (PDA only) - Set to True if you want to be able to select any mail folder from the main folders page. If you have a lot of mailbox folders, though, it will make the display rather untidy.
EXPANDPFOLDERS (PDA only) - Set to True if you want to be able to select any Public Folder from the main folders page.
FOLDERDATEWIDTH (PDA only) - This defines how many characters are reserved for the date in message listings.
FOLDERSENDERWIDTH - This defines how many characters are reserved for the sender's name in message listings.
FOLDERSPERPAGE (WAP only) - This defines how many folders are shown on each page in a folder listing. Too large a value will make the page size too large for the device or the gateway.
FOLDERSUBJECTWIDTH - This defines how many characters are reserved for the subject in message listings.
FONTFACE (PDA only) - You can use this to specify a font face, or a font family, for all the application output, e.g.: "Arial", "Verdana, Arial, Helvetica, sans-serif", etc.
FONTSIZE (PDA only) - You can use this to specify a font size, or a relative font size, for all the application output, e.g.: "2", "-1", etc.
FOOTERTEXT (PDA only) - If you put some text in here, it will be displayed at the bottom of each page. You can use HTML tags here, too, e.g.:
CONST FOOTERTEXT = "<b>MY FOOTER TEXT</b>"
HEADERTEXT (PDA only) - If you put some text in here, it will be displayed at the top of each page. You can use HTML tags here, too, e.g.:
CONST HEADERTEXT = "<b>MY HEADER TEXT</b>"
HTMLBODYCONTROL (PDA only) - Use this to define whether or not the application will display HTML message bodies. Please remember that it is not always safe to display HTML messages from unknown sources. Here are the settings:
0 = Show TXT
1 = Show HTML
2 = Default to TXT, with a link to HTML body
3 = Default to HTML, with a link to TXT body
INBOXREFRESHMINS (PDA only) - If set to a non-zero value x, will cause the message listings to reload every x minutes. Take care if you use this option not to run up too high a telephone bill as the reload requires repeated page requests to the server. This option is dependent upon browser support of the
LOGOFFLINK - If you set this to True, the application will display a Log Off link at the bottom of the Mailbox page. Please note that it is not possible to make a browser 'forget' a set of Authentication credentials once they have been entered, until the browser is closed (and PDA browsers are often always running). This facility is meant only to allow users to share the same device, if you cancel the second login prompt, it will continue with the previous logon credentials.
MAILBOXPROMPT - If you set this to False, the application will bypass the Mailbox Name screen. In the WAP application, the Mailbox Name screen will appear briefly, then move to the main Mailbox screen.
MAXPAGESIZE - This controls how much of each message is displayed per page in the mobile device browser. How much you can safely display depends on the capabilities of the device you are using. This value is especially critical for the correct operation of WAP devices which have a total maximum page size (including markup etc.) of approximately 1500 bytes. The current recommended maximum message page size for WAP is 400 bytes.
MESSAGESPERPAGE - This defines how many messages are shown on each page in a message listing. It is largely a matter of personal preference with a PDA device, but again the value is critical for WAP devices.
MULTIPLEMOVE (PDA only) - If you set this to True, the application will display a 'Move Marked' button and a folder list alongside the 'Delete' button in message listings. It is off by default to save screen space and reduce the page size.
NOTESPERPAGE - This defines how many notes are displayed in a Notes listing.
OPENATTACHMENTS (PDA only) - This defines whether or not the application will display links to message attachments. Not all PDAs can display attachments.
ORIGINALMSGLENGTH (PDA Only) - This defines how much of the original, replied-to, message is shown on the display when Replying to, or Forwarding, a message. Note that all of the original message will actually be included when the message is sent; this parameter only controls how much of it is shown when composing the new message. Since messages can become quite large, it is quite possible to overload the capacity of a textarea control of a mobile browser when Replying or Forwarding. The WAP version does not show any of the original message.
PASSWORDACCESS (PDA only) - Set to True if you have configured your OWA server to allow Web clients to change their passwords, and you want to extend this functionality to PDA clients; otherwise set to False. You can also hard-code an NT Domain Name in the file PWE.htr . If you are not allowing password access you ought to delete or rename all .htr files in the application directory to reduce any security risks.
PORTNUMBER - If you are using Exchange 2000, or 2003, and you use a non-standard port number (i.e. not 80 or 443) for Outlook Web Access, then you will need to specify a value for this parameter. Do not specify a value if you are using the standard port number.
PREVIEWSIZE (PDA only) - Set this to a non-zero value if you want the application to display so many characters of the message body below the subject in message listings.
RELAYATTACHMENTS (PDA only) - In Exchange 2000 or 2003, the Exchange store will generate URLs to attachments on the Exchange server itself. If you are installing the application on a server that is not an Exchange server, then the server will have to get the attachment for you, and then relay it to the client. So, you will need to set this parameter to True if you are installing it on an IIS server that is not an Exchange server, and you are connecting it to Exchange 2000 or 2003.
SENDATTACHMENTS (PDA only) - This feature requires browser support for the File Upload control. It is mainly for those people using the application with a desktop browser, since PDA support for this control is very rare. If you set it to True, and you see the File Upload control on the display (the Browse... button illustrated below), you will be able to attach files to your messages.
SENDERSUBJECTBREAK (PDA only) - If you set this to True, the application will display the sender name above the message subject, instead of beside it. This will allow you to show more of the name and subject, but it will take up more screen space.
SERVERNAME - Normally, this will not be present, and the application will try to discover the correct Exchange server name automatically, but you can force it to use a specific server name by setting a value for this parameter. If you decide to specify this value, then it must be the computer name (or NetBIOS name) of your Exchange server, and it must be in double-quotes "" . You can also use an IP address if you prefer.
SHOWDATESINFOLDER - Set this to True if you want to show the message date in message listings.
SHOWERRORS - Occasionally, the application will encounter message/folder object errors that prevent them from being displayed. If you set this to False, the application will attempt to continue past these errors to display remaining objects.
SHOWICONS (PDA only) - Controls whether or not icons are displayed in various part of the display. Here are the settings, just add the numbers together to get the combination you want:
0 = No icons
1 = Show icons on mailbox page
2 = Show icons in folder listings
4 = Show icons in message listings
SHOWPUBLICFOLDERS - Set this to True if you want the application to display Public Folders.
TABLEROWCOLORA, TABLEROWCOLORB (PDA only) - You can use these to specify alternate row colours in the table (message, folder listings) output, e.g.: "RED", "blue", "#F1F2F3", etc. If BODYCOLOR, TABLEROWCOLORA or TABLEROWCOLORB are defined in the Define.inc file, then the 'Themes' section of the 'Options' page will not be available to end users.
TASKSPERPAGE - This defines how many Tasks are displayed in a Task listing.
TEXTAREASIZE (PDA only) - This defines the HTML settings for the message TEXTAREAs (where the message body is typed). You can define a number of rows and columns. Some PDA browsers will ignore it, though.
USELOGINNAME - If you set this to True, the application will assume that your mailbox names are the same as your network login names. This is usually the case in Exchange 2000.
USERENDERER - OWA For PDA / WAP will make use of the CDO Renderer when configured for Exchange 5.5. On rare occasions, the application will be unable to instantiate the Renderer because of problems on the server. You can use this parameter to stop the application from attempting to use it.
USETABLES (PDA only) - Set to False if your device can't display HTML tables. I-Mode devices, for example, are not able to display tables.