Updating to 64-bit MAPS

MAPS is available for both 32-bit and 64-bit installations. Evisions recommends moving to the 64-bit version as soon as it is convenient for your institution. If you do not have a new server available, you can update an existing 32-bit installation to a new 32-bit version of MAPS using the instructions in Updating MAPS and the MAPS Applications.

If you are installing MAPS for the first time, refer to the MAPS Installation Guide.

Preparation

If you have an existing 32-bit installation of MAPS you must provision a new server for 64-bit MAPS, and then migrate your existing data and configuration information to the new server. Instructions are provided here for that process.

• Refer to the MAPS Suite Hardware and Software Requirements to verify that your new server system meets or exceeds these specifications.
• As with any updates, verify the MAPS 64-bit installation in a test environment prior to switching to the server for production.

Installation

Overview - Please Read

The process of updating your institution's MAPS server to MAPS 64-bit involves a number of steps, and it is important that you perform the steps in the order provided. The main process consists of the following steps:

• Updating the current 32-bit server to MAPS 6.5 (32-bit version). This ensures that all of the files that will be eventually copied to the new MAPS server are compatible.
• Installing MAPS on the new 64-bit server.
• Moving various data and configuration files from the old 32-bit server to the new 64-bit server.
• Testing and verifying that the new system is functioning as expected.

If you have any questions, or encounter problems during the process, contact Evisions Support and we will be glad to assist.

Update the Existing MAPS Server (32-bit) to the MAPS 6.5 (32-bit)

You must update the version of MAPS installed on the current server even though you may be retiring the 32-bit server. Both the existing MAPS server and the new 64-bit MAPS server must be running exactly the same MAPS version before you migrate the data and configuration files. Be sure that the build version on both servers is the same.

1. On the 32-bit server currently in use, select the Check for Updates button to update to the latest version of MAPS 6.5. See Updating MAPS and the MAPS Applications for details if you are not familiar with this process.
2. Once the update completes, stop the MAPS service on the 32-bit server.
1. Open the Services application (from Windows).
2. Locate the Evisions MAPS Service in the list of services and select Stop from the context menu.
3. If you are going to continue using the existing server while you test the new server, be sure to restart the service after copying the files to the new server.

Install MAPS (64-bit) on the New Server

1. Download the MAPS 64-bit setup software from the Evisions website, and then run the setup program to install MAPS. For details, see Standalone Installation. Note that you only need to do the installation steps at this time. Much of the configuration will be transferred from the old system in upcoming steps.
2. Follow the initial prompts, and then select the Standalone Installation option when prompted to choose the configuration.
   
3. When the Database Configuration Complete message displays, DO NOT select the Finish and Close Wizard at this time. You will do this step later, after the files are migrated from the existing 32-bit server to this new server.
   
4. Continue with the next section.

Copy Data Files from the Existing MAPS Server (32-bit) to the New 64-bit MAPS Server

The steps in this section assume that you have stopped the MAPS service on the 32-bit server, and you are using the default file locations for installations.

For each of the following, copy the files from the Program Files(x86)\Evisions\MAPS\Service folder on the 32-bit MAPS server to the Program Files\Evisions\MAPS\Service folder on the new 64-bit MAPS server.

Important Note

Do not copy the whole Service folder as this may make the system unusable.

1. Copy the contents of the Custom folder in the http_files folder.
2. Copy the Applications folder.
3. Copy the Certificates folder.
4. Copy the Keys folder.
5. Copy the Mapplets folder.
6. Copy the Scripts folder.
7. Copy the following files:
   • MapsAudit.sqlite
   • MapsData.sqlite
   • MapsDataWarehouse.sqlite (if present)

Resume the Installation on the New MAPS 64-bit Server

1. Return to the installation wizard on the new server.
2. Select Finish and Close Wizard to complete the installation and database configuration. This should automatically start the MAPS service on the new server. If it doesn't start, do the following:
1. Open the Services application (from Windows).
2. Select the Evisions MAPS Service (64-bit) from the list, then select Start from the context menu.

Configure the New 64-bit MAPS Server

1. Launch the MAPS launch page on the new server:
1. Go to http://localhost:8080 and select MAPS Config.
2. Before you log in, click on the Edit Servers link and change the Server address to the IP Address of your new server.
3. Enter your credentials to log in.
2. Select the Universal Launcher and select the "default" option. At the bottom of the menu, change the Server IP Address (or URL) to the IP Address or URL of the new 64-bit MAPS server then select Apply Changes.
3. Immediately after logging in, if your existing MAPS server (32-bit) is still live do the following:
   1. Disable the MAPS Scheduler (on the new server) if it is active by navigating to Mapplets > Argos > Scheduling > Configuration and clearing the Scheduler active check box on the top of the menu.
   2. Disable the MAPS Email Queue (on the new server) if it is active by navigating to Email > Queue and clearing the Emailing active check box on the bottom left of the menu.
4. Verify that the 64-bit version of MAPS Config is installed, and that the version is correct under Applications. The entry for the Configuration application should show (64 bit).
5. Delete any entries for the Configuration application that are not marked as "64 bit."
6. Open the Drivers list in the Data Connections section of MAPS Config. If there are any 32-bit drivers listed, do the following:
   1. Note the type of data connection for each 32-bit driver in the list.
   2. Delete each of the 32-bit drivers shown in the list.
7. Close MAPS Config, and then relaunch it from the MAPS launch page to launch the 64-bit configuration tool.
8. Navigate to the Data Connections list, and select Add Connection. Adding a data connection installs the new 64-bit version of the driver(s) that you deleted above.
   1. Select the data connection type that corresponds to one of the data connections that you are already using (typically REST or Salesforce).
   2. Select Next, then select OK. You can use the default properties for this connection since you are only adding it to install the new drivers.
9. When you log in to Argos, FormFusion, or IntelleCheck, you should see all of the data from your previous server.

NOTE: If you do not disable the Scheduler and Email Queue, the schedule or email will also execute from the new server. When you are ready to retire the 32-bit server, enable the Scheduler and Email Queue on the new server.

Install the Database Provider

Install the Oracle OLE DB Provider

Refer to Installing/Updating the Oracle OLE DB Provider document available from the Evisions support site for instructions.

Be sure to select the 64-bit versions of the files.

Installing Other Database Providers

Consult your database provider's documentation.

Configure the Data Connections on the 64-bit Server

1. Launch MAPS Config, either from the eLauncher or directly from the Applications folder, if you are familiar with that method.
2. Select Data Connections from the left-hand pane and configure the data connection for the 64-bit server.

Install Additional Items

Install Printers and Drivers

You must reinstall printers and drivers for any other devices you want to use. Note that you should now use the 64-bit drivers, when available.

Install the SSL Certificates

To create a new Certificate, see How to obtain a new Certificate for an HTTPS server. If you are using a Wildcard Certificate, then you can copy the certificate/key files to the new MAP Server and set up HTTPS. For additional information on how to install SSL Certificates in MAPS, see Installing SSL Certificates in MAPS.

Update the Server Address Configured for SAML

Update the server URL:

1. Using MAPS Config, select Single Sign-On from the left-hand pane.
2. For each SAML server, update the Issuer field to show the address of the new MAPS server (64-bit).

Install the SQLite Driver for Data Warehouse

If you are reporting off the Data Warehouse, install the SQLite 64-bit OBDC driver.

See Connecting to the Database for details.

FormFusion Users

If using FormFusion, you will need to change the IP on the evicfg file to point to the new server.

BankMobile Users

If using IntelleCheck BankMobile, you will need to reach out to BankMobile to request a new key. You will also need to provide BankMobile with your new server URL. You may reach BankMobile support at support@bankmobiledisbursements.com.

Open Ports

Open up all necessary ports. See Ports used for MAPS traffic for additional details.

Testing the Installation

See Testing Application Installation for instructions on how to test the installation.

Enable the Scheduler and the Email Queue for the new server once you are ready to put it into production.