Messageway Web Client Installation and Configuration
Total Page:16
File Type:pdf, Size:1020Kb
Version 6.0.0 MessageWay Web Client Installation and Configuration Document History Part Number Product Name Date MW600-590 MessageWay Web Client Installation and Configuration 04/2013 MW600-MR01 MessageWay Web Client Installation and Configuration 06/26/15 MW600-MR02 MessageWay Web Client Installation and Configuration 10/14/16 MW600-MR03 MessageWay Web Client Installation and Configuration 03/16/18 MW600-MR04 MessageWay Web Client Installation and Configuration 03/13/20 Copyright ©1991-2020 Ipswitch, Inc. All rights reserved. This document, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by such license, no part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the express prior written consent of Ipswitch, Inc. The content of this document is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Ipswitch, Inc. While every effort has been made to assure the accuracy of the information contained herein, Ipswitch, Inc. assumes no responsibility for errors or omissions. Ipswitch, Inc. also assumes no liability for damages resulting from the use of the information contained in this document. WS_FTP, the WS_FTP logos, Ipswitch, and the Ipswitch logo, MOVEit and the MOVEit logo, MessageWay and the MessageWay logo are trademarks of Ipswitch, Inc. Other products and their brands or company names, are or may be trademarks or registered trademarks, and are the property of their respective companies. This document was published on Tuesday, February 11, 2020 at 16:13. MessageWay Web Client Installation and Configuration i Contents MessageWay Web Client Installation and Configuration 1 Overview of the Web Client ................................................................................................................. 1 Installing the Web Client ...................................................................................................................... 2 Licensing Requirements for the Web Client .............................................................................. 3 Default Ports for MessageWay Web Client ............................................................................... 3 MessageWay Web Client Default Locations .............................................................................. 3 Tested Browsers......................................................................................................................... 6 Components and Processes of the Web Client .......................................................................... 6 Critical Dependencies ................................................................................................................ 7 Pre-installation Tasks ................................................................................................................. 8 Uninstall the Web Client ............................................................................................................ 9 Install the Web Client ..............................................................................................................13 Post-Install Task for the Java Applet ........................................................................................20 Start and Stop the Web Client Servers ....................................................................................23 Configuring the Web Client ................................................................................................................26 Web Client Configuration Files ................................................................................................26 Rebranding the Web Client Logon Page with Your Company Logo and Text ..........................37 Enabling or Disabling Remaining Logon Idle Timer Display .....................................................50 Replacing Test Certificates with One Signed by A Certificate Authority .................................51 Configuring MessageWay Users and Locations to Test the Web Client ..................................54 Testing the Web Client Connections .......................................................................................68 Troubleshooting the Web Client ........................................................................................................77 1 MessageWay Web Client Installation and Configuration The MessageWay Web Client allows users to upload and download messages to and from MessageWay using their Internet browser. This installation and configuration document describes: ▪ What you can do from the Web Client ▪ High-level view of components and processes of the Web Client ▪ How to uninstall the Web Client ▪ How to install the Web Client ▪ How to configure and administer the Web Client ▪ How to rebrand the Web Client with your logos and verbiage ▪ Testing the Web Client connections and configurations For a description of how to use the Web Client, see the Web Client User's Guide available as online help. Overview of the Web Client The MessageWay Web Client allows external users to access MessageWay from an Internet browser to review information about messages and to upload and download messages. There are two modes available from a browser: Java mode and non-Java mode. Java mode uses an applet to provide many user friendly features that are not available in the non-Java mode. Both modes provide the following functionality: ▪ Provides HTTPS transfer method between the browser and the Web Client ▪ Controls user access to information as defined in MessageWay ▪ Allows users to change their passwords ▪ Allows users to access other mailboxes as rights permit ▪ Allows users to search for messages by filename or class ID, with wild card options ▪ Allows users to upload and download messages NOTE: Non-Java mode downloads are limited to a maximum file size of 250 megabytes, and uploads are limited to the message size upload limit of your browser. 2 MessageWay Web Client Installation and Configuration Version 6.0.0 ▪ Shows results of transfers by category: Available, Downloaded, Canceled, Uploaded ▪ Supports different file formats for uploaded and downloaded messages: ▪ Upload: Binary or Text ▪ Download: Binary, Text or Zip (file is compressed before downloading) ▪ Displays related messages and reconciliation information when appropriate NOTE: Related Messages in Web Client is not the same as Get Related Messages in the Manager. Related Messages only show output messages related to the input message that was uploaded. Get Related Messages show all messages in the work flow related to the input message into MessageWay. In Java mode, the Java applet provides the following additional file transfer functionality: ▪ Supports transfer of very large files: Maximum file size is controlled by the operating system and available system resources ▪ Uploads multiple files with simultaneous file transfers ▪ Shows progress of transfer and status information ▪ Updates detail lists automatically ▪ Provides ability to pause, resume and cancel transfers, and retry failed or canceled transfers ▪ Supports manual retry for upload and download of failed or canceled transfers: ▪ From the point of the end of the last data previously received for binary files only ▪ From beginning of the file for all other supported file formats ▪ Displays additional error information for failed transfers Installing the Web Client MessageWay version 6.1 MR03 (6.1.0.3) or newer supports a Web Client that allows remote users to submit files to MessageWay and retrieve files from MessageWay via a standard Web browser. The Web Client requires that you install MessageWay version 6.1 MR03 (or newer) first. You should perform the following tasks as an administrative user. 1 Review the default ports used by the install process to avoid any port conflicts. (on page 3) 2 Review the critical dependencies before you begin the actual installation. (on page 7) 3 Perform any pre-installation tasks, including uninstalling prior versions of Web Client. (on page 8) 4 Install the MessageWay Web Client. (on page 13) 5 Perform post-install task to update the certificate fingerprint for the Java applet. (on page 20) 6 Test to make sure you can start and stop the Web Client servers. (on page 23) MessageWay Web Client Installation and Configuration 3 Licensing Requirements for the Web Client The MessageWay Web Client includes a new MessageWay Service Interface Proxy Server and uses the MessageWay Service Interface, which is installed with the MessageWay Server, to access MessageWay. Therefore, the use of Web Client is granted with a base MessageWay product license. Default Ports for MessageWay Web Client These are the default ports for MessageWay Web Client (DMZ tier). For a list of MessageWay default ports for other MessageWay components, refer to the MessageWay Installation Guide. Server Port # Description MessageWay 443 Apache HTTPS listener Web Client 3003 MessageWay Service Interface Proxy Server HTTP listener 3000 Mongrel Server HTTP cluster start port 3001 Mongrel Server HTTP cluster port 3002 Mongrel Server HTTP cluster port MessageWay Web Client Default Locations The following are the default locations where MessageWay Web Client files are installed. The locations vary depending on the system, Windows or UNIX/Linux. MessageWay