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.
Colleague software
Install Colleague software that supports Ellucian Mobile
Course section delimiter workaround for Colleague
Colleague institutions should use the "/" character as a delimiter for their converted course section IDs, creating IDs such as "HIST/100/001".

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.
- Banner software
  Install Banner software that supports Ellucian Mobile.
- Colleague software
  Install Colleague software that supports Ellucian Mobile
  - Install Colleague software update for Mobile
    Colleague institutions must install SU60901.19-1805 for Ellucian Mobile.
  - Install Colleague Web API
    Ellucian Mobile requires Colleague Web API 1.8 or later.
  - Set up a Colleague proxy user
    Set up the Colleague proxy user that supports Ellucian Mobile access to Colleague using the Colleague Web API.
  - Course section delimiter workaround for Colleague
    Colleague institutions should use the "/" character as a delimiter for their converted course section IDs, creating IDs such as "HIST/100/001".
- 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

Course section delimiter workaround for Colleague

Colleague institutions should use the "/" character as a delimiter for their converted course section IDs, creating IDs such as "HIST/100/001".

Colleague institutions that were previously live on Release 13 might experience problems with the Grades and Courses modules. The format of course section IDs changed with Release 14.

Ellucian Mobile uses those course section IDs in requests to the Colleague Web API. A slash in a course section ID creates an incorrect URL, which causes Ellucian Mobile to fail when it requests data for those course sections.

As a workaround for this situation, you can add the following parameter to your colleague-mobileserver-config.groovy file that causes Ellucian Mobile to ignore course sections that are older than a specified date:

ellucian.colleague.hideAcademicDataBefore = "1997-01-01"

The date format is year-month-day. You can enter the start date of the first Academic Term that you created in R14. You can enter a more recent date if you want to further limit the data that is returned.