Home
Install Supporting Software
Before you can install the Ellucian Mobile components, there are several prerequisite software components that must be installed. Note that Grails is also required, but does not need to be installed separately because all Grails components that you need are included in the WAR file that you install later.
Apache Tomcat
Ellucian Mobile has been tested on Apache Tomcat 7 and 8.

Implementation Guide, May 2023, Release 5.6.3
This online help contains comprehensive information about how to install, set up, and maintain Ellucian Mobile.
Ellucian Mobile Overview
Ellucian Mobile, powered by Ellucian Ethos, provides faculty, prospects, students, staff, and other constituents with access to key campus information and services from their mobile devices. This section provides an overview of Ellucian Mobile.
Before You Begin
This section describes some advance preparations that you can make to help your Ellucian Mobile setup process to go as smoothly as possible.
Install Supporting Software
Before you can install the Ellucian Mobile components, there are several prerequisite software components that must be installed. Note that Grails is also required, but does not need to be installed separately because all Grails components that you need are included in the WAR file that you install later.
- Java Development Kit
  Apache Tomcat requires Java Development Kit (JDK) 8.
- Apache Tomcat
  Ellucian Mobile has been tested on Apache Tomcat 7 and 8.
  - Change Tomcat to use UTF-8 encoding
    By default, Tomcat uses ISO-8859-1 encoding, which only supports Latin-based languages and does not fully support some characters in some of the Latin-based languages. To correctly send characters for all the languages supported by Ellucian Mobile, the default encoding needs to be changed to UTF-8.
- Banner software
  Install Banner software that supports Ellucian Mobile.
- Colleague software
  Install Colleague software that supports Ellucian Mobile
- PowerCampus software
  Install PowerCampus software that supports Ellucian Mobile.
Install Ellucian Mobile Software
Install the Ellucian Mobile WAR file and perform basic configuration steps.
Set up the Mobile Cloud Configuration System
Set up the Ellucian Mobile Cloud Configuration System. Description of the process for signing from the Ellucian Hub, how to create and enter the configuration settings, and how to specify the SIS credentials.
Manage Users and User Permissions for the Mobile Cloud Configuration System
You can give selected people access to modify specific elements of your mobile configurations, such as user management, configuration management, branding, or sending push notifications.
Customize the Appearance of Ellucian GO
Set up the home screen, select background and text colors, and set up the About screen.
Set Up Location-Aware Features
Set up Ellucian Mobile features that are location-aware; that is, based on proximity to a beacon.
Set Up Application Modules
Set up the application modules that are displayed in Ellucian GO.
Test and Publish a Configuration
To view your configuration on a device, you must place the configuration into test status. When you are ready to make your configuration available in the public list of institutions on Ellucian GO, you publish the configuration.
Analyze Usage
The Google Analytics Platform lets you measure user interactions across various devices and environments. You can use Google Analytics to view detailed usage statistics of your school's Ellucian Mobile implementation.
Manage Configurations
In addition to the ability to add a new configuration manually, you can create a new configuration by copying an existing one, export configuration information, import configuration information, and migrate a configuration to a different database.
Set up multiple Mobile Integration Server Web Service Apps
If you want to have multiple active configurations at the same time, you need to set up multiple Mobile Integration Server web service apps.
Set up Load Balancing and Redundancy
Multiple Mobile Integration Servers can be set up for a single configuration. This can be done to scale the solution to support more mobile users, or for redundancy. Deployment of multiple Mobile Servers requires a shared data storage using either a Microsoft SQL Server or an Oracle database.
Ellucian Mobile on Wearable Devices
Users can view push notifications on their Android Wear and Apple Watch devices. Users with Apple Watches can also view ILP assignments and maps.
Debugging
Send detailed information from Ellucian Mobile to the log file to support troubleshooting.
Appendices

Apache Tomcat

Ellucian Mobile has been tested on Apache Tomcat 7 and 8.

Download Tomcat from http://tomcat.apache.org/ and install it. Tomcat documentation can also be found at that website.

You should install Tomcat on a machine with 8 GB RAM and a dual-core processor. Tomcat should have a memory allocation of at least 4 GB, including 3.5 GB for the main JVM and an additional 512MB for PermGen space. The recommended storage space for the Mobile Integration Server web service app is 700 MB, plus an additional 100 MB for each active configuration that the server will support. The Tomcat HTTPS port needs to be accessible to the public, outside of any firewalls.

Make note of the Tomcat server URL. You will need this in future installation steps and to test the installation. It is referenced as <externalMobileServer.my.edu> throughout these instructions. This URL needs to be a fully qualified external domain name.

HTTPS is required

Always set up and configure https for your Mobile Server. This protects the information being transferred back and forth between user devices and the Mobile Cloud Configuration tool, and is required by Apple App Transport Security (ATS) for any iOS app.

Requirements for the certificate:

Your Mobile Server should use certificates from common certificate authorities. Self-signed certificates will not work. See Article 000031063 for a list of supported certificate authorities.
Your Mobile Server must support at least Transport Layer Security (TLS) protocol version 1.2. If your Mobile Server does not support TLS 1.2, you will get a warning message in the Mobile cloud configuration tool suggesting that you update your SSL certificate to support TLS 1.2.
The server certificate hashing algorithm must be Secure Hash Algorithm 2 (SHA-2) with a digest length of at least 256 (that is, SHA-256 or greater).