Applications Manager Client Installation

Spring 2024 Upgrade

A new client download is required for the Applications Manager upgrade alongside Spring 2024 Banner upgrades.  This new client will need to be downloaded and used for all QUAL testing and for production after the upgrade goes live.

The new version of the client is attached to this article as QUAL_client_2024_spring.zip .

Once the upgrade goes live, the regular download file will be replaced with the new version.

Overview

Applications Manager is an enterprise automation tool that helps schedule and run tasks that streamline university operations.  It integrates tightly with Banner and is important for many employees of the university.

Prerequisites

  • To use Applications Manager connect to the EMU wired administrative network or VPN on a Windows computer.
  • Ensure 64-bit Java is installed on the machine and updated to the latest version.  For assistance with installing Java software on your computer, contact the IT Help Desk or Submit a HD Ticket.
  • If you have any issues installing or accessing Applications Manager using this procedure,contact the IT Help Desk or Submit a HD Ticket.

Client Download

  • The client files are attached to this article.
  • Uploaded Image (Thumbnail)Right-click on the link for emich_am_client.zip .
  • Choose "Save Link As..." or "Save Target As...".
  • Choose a location and save the zip file to your computer.

Extract Client Files

  • Right click the downloaded zip file.
  • Choose 'Properties'
  • Check the box to 'Unblock' the file. If the 'Unblock' checkbox is not present, no action is needed.Uploaded Image (Thumbnail)
  • Click OK
  • Right Click on the zip file again.
  • Choose Extract All 
  • Open the extracted folder.
  • Relocate the extracted Applications Manager directory to a desired location.  (C:\ or the Desktop is recommended).
  • During AM upgrade testing, keep different versions of the AM client in separate folders.  Do not combine files from different Applications Manager versions, as the client version must match the server version to function.

Install Keystore Files

  • Applications Manager requires keystore files to be installed in the .AppWorx directory in your user home directory.  If you have a working previous version installed on your machine, you may skip this step.
  • Browse to your home directory (example: C:\Users\emich_user\).
  • Copy the .AppWorx directory from the client install folder to your home directory.

Launch Applications Manager Client

  • In the Applications Manager directory, there are two run options:
    • Double-click the RunClient.jar file.  The ability to launch .jar files directly through Java may not work properly depending on all Java or Windows versions.  If the client does not launch through the .jar file, try the .bat file.
    • Double-click the run_am_client.bat file.  This is a batch file that will launch the Client to get around file association issues.
  • The Applications Manager should launch and present a log in screen. Uploaded Image (Thumbnail)

Logging Into Applications Manager

  • Select the instance you want to connect to via the "Connection" drop down on the logon screen. The Applications Manager client uses a single application to connect to multiple environments.  Note: After selecting a Connection, you may click the "Remember logon" button to save your username and default Connection choice. Uploaded Image (Thumbnail)
  • Enter your user name and password.
  • Applications Manager is protected by Duo two-factor authentication. To proceed with login, do the following depending on your Duo notification options:
    • For users with Duo push notifications, click OK. This will automatically trigger a Duo push for confirmation.
    • For users with Duo call-based notifications, add ",phone1" (without quotes) after your password in the Password field. Then, click OK. This will send a call-based request to your phone for verification.
  • There is no indicator on the AM login page while it is waiting for Duo verification until it logs in successfully or times out (logon failure).
  • After Duo verification is complete, you should be successfully logged into Applications Manager.

Details

Article ID: 1
Created
Fri 5/12/23 11:58 AM
Modified
Wed 4/24/24 10:10 AM