Multiple Application Platform Server MAPS 4.4 Release Guide Document version 4.4 Last updated 1/16/2015
Trademark, Publishing Statement, and CopyrightNotice 2015 Evisions, Inc. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. No part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Evisions, Inc. The information contained herein is subject to change without notice and is not warranted to be error-free. Product features referenced herein for a period of time may not match product contents. Evisions, Inc. does not warrant that the functions contained in the software will meet your requirements or that the operation of the software will be uninterrupted or error free. Evisions, Inc. reserves the right to make changes and/or improvements in the software without notice at any time. This software and documentation may provide access to or information on content, products, and services from third parties. Evisions, Inc. and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Evisions, Inc. and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of thirdparty content, products, or services. Evisions, Inc. does not endorse the content or developer of any products or web sites mentioned. All information in this guide is designed for instructional purposes only. Evisions, Inc. makes no guarantees regarding the accuracy or performance of any techniques used in this guide. Software configurations and environments may vary, and some techniques used in this guide may not operate efficiently under all configurations. This guide may contain examples of various technologies or products, which are the sole property and responsibility of their creators. Trademarks are the property of the respective owners for any products mentioned herein. www.evisions.com MAPS 4.4 Release Guide Page 2 of 9
Table of Contents What's New in MAPS 4.4? 4 MAPS Updates 4 Product versions 4 Installation 4 1. Prepare test environment and ensure current backup 4 2. Check for updates 4 3. Allow update process to complete 4 4. Verify the latest version is installed 5 Content Delivery Network (CDN) 6 MAPS 4.4 Release Notes 7 Getting Help 9 www.evisions.com MAPS 4.4 Release Guide Page 3 of 9
What'sNew inmaps 4.4? Evisions is pleased to announce the release of MAPS version 4.4, which contains the following new features and changes: The MAPS elauncher is now hosted on Evisions' servers. This Content Delivery Network (CDN) allows us to deploy updates to the launch page without requiring an update to MAPS. MAPS contains local copies of the files to ensure continuous access in the event of a network outage. MAPS administrators can also specify whether MAPS should use the CDN or the local version. Removed the optional widgets from the elauncher in order to streamline the page and focus on providing software content. Logging in to the MAPS application clients should be slightly faster now, providing performance gains in environments with large numbers of users. Added support for PROT P encryption (private data channel encryption) when sending files via FTPS. More detailed information is contained in this guide and in the MAPS in-product Help. For a complete list of changes, please refer to the Release Notes. We appreciate the feedback received from all of our users. Our products would not be what they are today without your continued support. If you have any comments or suggestions, please do not hesitate to open a HelpDesk ticket and let us know. MAPS Updates MAPS 4.4 is an update to the MAPS service and the MAPS Configuration tool. You should upgrade both components to the latest version concurrently. Product versions The latest version of MAPS included in this release is: MAPS Service 4.4.0.978 / Configuration Tool 4.4.0.362 / elauncher 4.4.0.5 Installation 1. Prepare test environment and ensure current backup We highly recommend installing updates in a test environment before applying them to your production environment. You should make sure that a current backup is available in case of any unforeseen issues. 2. Check for updates It is possible to apply updates when users are on the system; however, to avoid the possibility of losing unsaved work we recommend applying updates during off hours. To install MAPS 4.4, click the Check for Updates button in the MAPS Configuration tool to view available updates. Note: If you are not already running MAPS 4.x, please refer to the MAPS 4.0 Upgrade Guide for additional upgrade information. 3. Allow update process to complete When applying updates to the MAPS service you will be temporarily disconnected from the server. Do not manually restart the server during this process, as you will be reconnected automatically when the update has been applied. Do NOT cancel reconnection attempt www.evisions.com MAPS 4.4 Release Guide Page 4 of 9
4. Verify the latest version is installed To ensure that you are on the most current version, continue clicking the Check for Updates button and applying the updates until no new updates are available. Please Provide Us with Your Feedback! As always, we welcome any feedback or suggestions you may have. We very much appreciate your thoughts and suggestions, so please keep the great ideas coming. The update process may take a few minutes; you will be reconnected when the update has been applied. www.evisions.com MAPS 4.4 Release Guide Page 5 of 9
ContentDelivery Network(CDN) The web files for the elauncher and Argos Web Viewer are now loaded on demand from Evisions servers. This allows us to deploy updates to the product launch page and Argos Web Viewer without requiring you to update the MAPS service or the Argos mapplet. Evisions uses a Content Delivery Network (CDN) to host the pages. The Content Delivery Network (CDN) URL field on the HTTP File Server screen contains the location where MAPS looks for the CDN: The default URL points to the hosted content on Evisions servers, located at https://webapp01.evisions.com/. Altering this URL will cause MAPS to look in a different location for the elauncher and Web Viewer files and should only be done when working with an Evisions tech to resolve a support issue. If you do not wish to use the hosted files, you can continue to use the local versions included in the MAPS service and Argos mapplet by blanking out the CDN URL field (remove the URL entirely). In this case, you will need to wait for new releases of MAPS and Argos before you can get the latest updates to the elauncher or Web Viewer. When the CDN is enabled, if a user cannot access the CDN resources for some reason, MAPS serves up the local versions of the launch page and Web Viewer. This ensures seamless access in the event of a network outage or other issue that interferes with accessing the hosted content. You can check the version number at the bottom of the elauncher or in the Help -> About in the Web Viewer to see which version of the software you are currently running, in case the local and hosted versions are different. Note: In order to retrieve content from the CDN, end users must be able to access the CDN URL over the internet. If users are unable to access this location, MAPS will load the local version of the elauncher and Argos Web Viewer. www.evisions.com MAPS 4.4 Release Guide Page 6 of 9
MAPS 4.4 Release Notes MAPS Service 4.4.0.978 / MAPS Configuration Tool 4.4.0.362 / elauncher 4.4.0.5 Enhancements Diagnostics Email FTP Log files Performance Product Updater Web Server Users User interface elauncher elauncher Area Description Issue number Added an entry to the Diagnostics page indicating whether MAPS is using the CDN or the local version of the elauncher and Argos Web Viewer, and what the CDN URL is. When renaming an email server in MAPS, any Argos schedules using that email server will now automatically update to use the new name. Added a new table to the Argos database called XRef_EmailServer to facilitate this change. Added support for PROT P encryption (private data channel encryption) when sending files via FTPS. When an error occurs while executing a very large SQL statement, MAPS now truncates the SQL included in the error message in the log file to 10k characters to reduce the size of the logs and increase readability. Logging in to the MAPS application clients should be slightly faster now, providing performance gains in environments with large numbers of users. When MAPS is set to periodically check for updates, instead of checking every six hours it now checks for updates three hours after the service starts, and every six hours after that. The server can no longer check for updates during backups or shut-down, which would occasionally cause errors in the logs or prevent the service from restarting. Added a field to the HTTP File Server screen that specifies the web address for hosted content. Added the ability to sort the Users screen on any field. Right-click in the column header to see additional field options (Notes, Start Date, Stop Date, CAS Id, Created By, Created Date, Modified By, and Modified Date). Added slide-in save/undo buttons to several screens in the Configuration tool to prevent MAPS administrators from making unintended changes. Removed the optional widgets from the elauncher in order to streamline the page and focus on providing software content. Also removed corresponding widget settings from the Configuration tool. Removed the ability to link a MAPS account with an Evisions HelpDesk account via the elauncher, since this was only used by the widgets that have been removed. MAPS-863 MAPS-345 MAPS-842 MAPS-826 MAPS-802 MAPS-837 MAPS-857 MAPS-827 MAPS-362 MAPS-855 MAPS-854 elauncher Added the elauncher version number to the page footer. MAPS-856 elauncher The MAPS elauncher is now hosted on Evisions' servers. This Content Delivery Network (CDN) allows us to deploy updates to the launch page without requiring an update to MAPS. MAPS contains local copies of the files to ensure continuous access in the event of a network outage. MAPS administrators can also specify whether MAPS should use the CDN or the local version. MAPS-829 www.evisions.com MAPS 4.4 Release Guide Page 7 of 9
Resolved Issues ADO connections Authentication Authentication Permissions Stability Stability Stability elauncher Area Description Issue number Copying an ADO connection that has one or more queuing rules results in the error "XML node 'Start' is missing". When logging in as an LDAP user who is part of an LDAP group in MAPS but not added as an individual LDAP user, MAPS creates multiple resource users if the user logs in by typing their username with different capitalization than they used previously. This can cause problems with scheduled Argos reports if the user changes their password, because the changes do not propagate to the duplicate usernames, which may be used to run the reports. Removed minimum length checks for passwords when logging in to the elauncher and Web Viewer, since there is no way to update the password from the login screen. Password requirements are enforced when changing the password, making the login check unnecessary. This resolves an issue where users whose passwords do not meet MAPS requirements are unable to either log in or to change their passwords. The account administration area of IntelleCheck displays printers that have not been authorized for use with IntelleCheck in MAPS. MAPS sometimes does not restart after the nightly backup, with the error " (ETimeOut) Timeout waiting for write lock" appearing in the logs. Fixed an issue with multithreading that may have caused MAPS or the MAPS applications to crash. When under heavy load, MAPS may terminate abnormally due to synchronization issues when accessing the auditing database. In MAPS 4.3 and higher, applications will not launch when using Internet Explorer version 8. MAPS-770 MAPS-689 MAPS-532 MAPS-733 MAPS-147 MAPS-846 MAPS-847 MAPS-811 www.evisions.com MAPS 4.4 Release Guide Page 8 of 9
Getting Help For information on using the software, please refer to the in-product Help, which contains detailed information on all aspects of the product. If you are having problems with the installation or configuration, you can search our knowledge base of common issues and their resolutions at http://helpdesk.evisions.com. If you are unable to find the solution, submit a HelpDesk request with a detailed explanation of the problem you are experiencing. Please do not hesitate to contact the Evisions HelpDesk if any questions or problems arise. We are here to help you and want to ensure your success. If you find that areas of this documentation could benefit from additional detail or clarification, please let us know. We are constantly trying to improve the installation process to make it as easy as possible. www.evisions.com MAPS 4.4 Release Guide Page 9 of 9