Multiple Application Platform Server. MAPS 4.3 Release Guide. Document version 4.3

Multiple Application Platform Server

MAPS 4.3 Release Guide

Document version 4.3 Last Updated 7/7/2014

Trademark, Publishing Statement, and CopyrightNotice

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 third-party 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.

Table of Contents

What's New in MAPS 4.3?

4

MAPS Updates 4

Product versions 4

Installation 5

1. Prepare test environment and ensure current backup 5

2. Check for updates 5

3. Allow update process to complete 5

4. Verify the latest version is installed 5

All Users

6

Updated Help and Release Documentation 6

MAPS Administrators

8

eLauncher Timeout 8

Auditing Database 9

Data Warehouse 10

MAPS 4.3 Release Notes

11

What's New in MAPS 4.3?

Evisions is pleased to announce the release of MAPS version 4.3, which contains the following new features and changes:

n Data warehouse designed specifically for reporting against MAPS (and Argos, if

licensed) data allows you to query against the database without degrading the performance of your production environment. Tables in the data warehouse contain the information most likely to be useful, in an easy to understand format.

n MAPS administrators can now specify the idle timeout for the eLauncher and Argos

Web Viewer. The default timeout is 15 minutes.

n _{Created a new database to separate auditing records from the MAPS database,}

resulting in increased stability and performance.

n Added support for nested Active Directory groups. If an LDAP user is a member of

group A, and group A is a member of group B, then adding group B to MAPS with nested groups enabled will include the nested user.

n Added an option to the LDAP server configuration that allows MAPS to search the

LDAP server to locate a user if their DN lookup fails. Automatically detecting changes to user DNs means that the MAPS administrator does not need to manually update the user's DN in MAPS due to changes on the LDAP server.

n When configuring an email server, you can now specify an SMTP port other than

the default of port 25.

n Product release notes are available in a new online format that includes both the

release notes and the relevant release documentation. The release documentation is fully searchable, and includes a version matrix of all Evisions products.

n Additional enhancements and resolved issues.

More detailed information is contained in this guide and in the MAPS in-product Help. For a complete list of changes, please refer to theRelease 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 toopen a HelpDesk ticketand let us know.

MAPS Updates

MAPS 4.3 includes updates to the MAPS service and the MAPS Configuration tool. You should upgrade both components to the latest version concurrently. This guide contains a description of the changes.

Product versions

The latest version of MAPS included in this release is:

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

To install MAPS 4.3, click theCheck for Updatesbutton 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 Guidefor 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.

4. Verify the latest version is installed

To ensure that you are on the most current version, continue clicking theCheck for Updatesbutton and applying the updates until no new updates are available.

Please Provide Us with Your Feedback!

As always, we welcome anyfeedback or suggestionsyou may have. We very much appreciate your thoughts and suggestions, so please keep the great ideas coming!

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.

Do NOT cancel reconnection attempt

The update process may take a few minutes; you will be reconnected when the update has been applied.

All Users

UpdatedHelpandRelease Documentation

The MAPS release notes and release guides are now available in a new online format similar to the format of the in-product Help. To access the release documentation, click theRelease Noteslink on the Server screen:

The latest release notes for the current release launch in your web browser:

The release documentation also includes a version matrix of all Evisions products.

SelectRelease Guideto view the latest MAPS release guide. You can choose to view the guide online, or download a PDF copy. The release documentation contains all release notes and guides from MAPS 4.0 onward.

To search the release documentation, type your query in the search box in the upper right. You can enter keywords, issue numbers, or any other text you wish to search for.

MAPS Administrators

eLauncher Timeout

Many clients have requested the ability to extend the timeout for the eLauncher and the Argos Web Viewer. We have added an option in the MAPS configuration that allows administrators to choose the best timeout value for their institution. The default is 15 minutes, but you can make it as long or as short as you need in order to balance security concerns with convenience for your users.

AuditingDatabase

In order to improve performance, we have removed the auditing tables from the MAPS database and created an entirely new database that holds only the auditing data. The data in the tables has not changed from MAPS 4.2.5. The new database can be found in the MAPS Service folder, and is called MapsAudit.sqlite.

ERD for the MAPS Auditing Database

n For more information on the auditing feature, refer to theMAPS Help.

n For detailed information on the tables in the Auditing and other databases, and how to use the information in them, refer to

Data Warehouse

Many institutions wish to report against the MAPS and Argos databases to gather information on users, DataBlocks and reports, security information, etc. While it is possible to gather some of this information by querying the databases, there are some

disadvantages to doing so.

MAPS 4.3 introduces the data warehouse, which is a new feature that allows you to run reports against a copy of some of the most commonly-requested data from the MAPS and Argos databases. By using a separate copy of the data, you can run very detailed queries and reports without impacting the performance of your production databases.

If you enable this option, MAPS will copy select information from the MAPS and Argos databases to a separate data warehouse database immediately following the nightly MAPS backup. (You can also migrate the data manually.) You can then report against the data warehouse rather than directly against the MAPS and Argos application databases. For information on using Argos to report against the data warehouse, seeCreating Argos Reports from MAPS Databases.

The Data Warehouse settings in MAPS are located in theAuditing & Data Warehouse

section:

n Migrate daily after MAPS automatic backup- If you have enabled nightly

automatic backups in MAPS, you can check this box to automatically migrate data to the data warehouse after the backup.

n _{Number of days to store auditing records- Choosing a lower length of time to}

store records from the auditing table can help to limit the disk space used by the data warehouse, as well as speed up queries that use the auditing tables.

n _{Migrate Data Now- Click this button to migrate data to the data warehouse}

immediately. The date of the last manual migration appears underneath in red text.

Licensed Products

n If you are licensed for Argos, you will see

data for both MAPS and Argos tables in the Data Warehouse.

n If you do not have Argos, you will only see

MAPS 4.3 Release Notes

MAPS Service 4.3.0.922 / Configuration Tool 4.3.0.325

Enhancements

Area Description Issue number

ADO connections Added a menu option to rename connection pools on the ADO Connections page. MAPS-350 Auditing Added the "Last logged in" date for each user to the User Properties dialog and to

the Users page in the MAPS configuration. MAPS-555

Auditing A new database has been created to separate auditing records from the MAPS

database, resulting in increased stability and performance. MAPS-606 Auditing Added the Last Log On date for each user to the Users page, allowing MAPS

administrators to sort users by this date. MAPS-505

Auditing The User Properties dialog now shows the created, modified, and last log on date

for that user. MAPS-457

Authentication

Added an optional SSO mode that allows MAPS to accept requests coming through an authentication server that is behind the same firewall as the server where MAPS is installed.

MAPS-690

Data Dictionary On the Data Dictionary -> Users tab of the Configuration tool, you can specify

group permissions for each data dictionary in addition to adding users individually. MAPS-443 Diagnostics On the Diagnostics tab of the Configuration tool, added notes indicating which

system printers have been added to MAPS. MAPS-352

Documentation

Product release notes are available in a new online format that includes both the release notes and the relevant release documentation. The release documentation is fully searchable, and includes a version matrix of all Evisions products.

MAPS-626

eLauncher Removed DataMasque from the eLauncher for institutions that are not licensed for

DataMasque. MAPS-684

Email When configuring an email server, you can now specify an SMTP port other than

the default of port 25. MAPS-462

Executables

MAPS administrators can now specify the directory where client applications are downloaded to on end user's machines. This may be useful in cases where you need to add a scan exception for antivirus software that requires an exact path.

MAPS-631

HTTP server MAPS administrators can now specify the idle timeout for the eLauncher and Argos

Web Viewer. The default timeout is 15 minutes. MAPS-139

Help The in-product Help has been updated to use static links, allowing you to share

URLs or link to specific Help pages. MAPS-465

LDAP

Administrators can now disable individual LDAP servers in MAPS to prevent users from authenticating to MAPS via that server. This can be useful when testing, configuring a new LDAP server, or making changes to a copy of an existing LDAP server.

MAPS-706

LDAP

Added an option to the LDAP server configuration that allows MAPS to search the LDAP server to locate a user if their DN lookup fails. Automatically detecting changes to user DNs means that the MAPS administrator does not need to manually update the user's DN in MAPS due to changes on the LDAP server.

MAPS-470

LDAP

Added support for nested Active Directory groups. If an LDAP user is a member of

Area Description Issue number

Log files Added the institution name to the log file upon server start up, as well as to the

information on the Diagnostics screen. MAPS-335

Product Updater When downloading a new MAPS application or a new version of an existing

application, the product updater now shows a download status bar. MAPS-452 Scheduling Added a "Last Run Date" column to the Scheduling screen in the MAPS

Configuration. MAPS-542

Security

Added a version number check before overwriting the SSL .dll files, which allows you to replace the files immediately (without waiting for a MAPS update) if OpenSSL releases a new version.

MAPS-783

Stability Made stability improvements relating to management of jobs and handling

process termination. MAPS-574

User interface Made the Edit Servers link more visible on the login screen. MAPS-741

User interface

Clarified the MAPS application login dialog by changing the "remember

username"/"remember password" check boxes to a drop down menu that allows you to remember only your username, neither username nor password, or both your username and password (if the server permits password saving).

MAPS-288

User roles

On the User Roles screen, enabled scrolling for the list of operations belonging to each non-editable system role if there are more operations than will fit on the screen.

Resolved Issues

Area Description Issue number

ADO connections Deleting a queuing rule for an ADO connection does not enable the "OK" button to

save the changes. MAPS-372

ADO connections Ampersand (&) characters in an ADO connection name are replaced with an

underscore (_) unless escaped with another ampersand. MAPS-329 ADO connections When copying an ADO connection, the option to "Allow Scripts (non-DML)" does

not carry over if it is enabled. MAPS-771

API In the Configuration tool, deleting the name of an API referrer creates a referrer

with no name that cannot always be deleted or renamed. MAPS-373 Antivirus Trend Micro antivirus software sometimes flags the Java product launcher as a

threat. MAPS-639

Authentication When using CAS to authenticate to the eLauncher, clicking "Log out" results in a

CAS authentication error. MAPS-516

CAS When using CAS to authenticate to MAPS, the eLauncher and the Argos Web Viewer

time out after 1-2 minutes instead of the default 15-minute timeout. MAPS-625 FTP Exception thrown when adding or editing an FTP server with a trailing white space

in the name. MAPS-477

Licensing Exception thrown when applying a new license file in the Configuration tool if

there is a password in the MAPS database that uses a non-standard character. MAPS-461 Printing

When running the Configuration tool from a machine other than the MAP server, test printing shows the name of the local machine as the "server name" on the printout.

MAPS-473

Stability

Resolved an issue where jobs occasionally error out when MAPS looks for available updates (MAPS looks for updates four times daily if the "Server will periodically check for updates" option is enabled in MAPS).

MAPS-724

User interface When checking for updates while the Mapplets page is open, the mapplet version

displayed does not update until you refresh the page. MAPS-331 eLauncher Errors relating to the "Last-chance HTTP exception handler" sometimes appear in

the MAPS log file but do not signify any actual issue that would affect users. MAPS-600 eLauncher The Windows application clients will not launch in Chrome or Firefox on a device

running a touchscreen-enabled version of Windows 8. MAPS-521

eLauncher

Downloading a new version of the Argos client on a machine running antivirus software throws an error "The directory name is invalid." Renaming the installation directory manually or adding an exception to the antivirus software resolves the error.

MAPS-270

eLauncher

When MAPS is configured to show only installed applications, users see all applications the very first time they log in regardless of this setting. Refreshing the page causes the applications to display correctly.

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 athttp://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.