Banner Employee Self-Service / Installation Guide
Total Page:16
File Type:pdf, Size:1020Kb
Banner Employee Self-Service Installation Guide Release 9.7 July 2018 Notices Notices © 2017-2018 Ellucian. Contains confidential and proprietary information of Ellucian and its subsidiaries. Use of these materials is limited to Ellucian licensees, and is subject to the terms and conditions of one or more written license agreements between Ellucian and the licensee in question. In preparing and providing this publication, Ellucian is not rendering legal, accounting, or other similar professional services. Ellucian makes no claims that an institution's use of this publication or the software for which it is provided will guarantee compliance with applicable federal or state laws, rules, or regulations. Each organization should seek legal, accounting, and other similar professional services from competent providers of the organization's own choosing. Ellucian 2003 Edmund Halley Drive Reston, VA 20191 United States of America ©2018 Ellucian. Confidential & Proprietary 2 Contents Contents Before you get started.............................................................................................................. 7 Use Ellucian Solution Manager to install your product upgrades.................................................7 Supporting documentation............................................................................................................ 7 Hardware requirements.................................................................................................................8 Software requirements.................................................................................................................. 8 Oracle database......................................................................................................................8 Web application servers......................................................................................................... 8 Middle tier (application server) platforms............................................................................... 9 Developer requirements..........................................................................................................9 Single sign-on (SSO) support................................................................................................ 9 Java dependencies...............................................................................................................10 Browsers............................................................................................................................... 10 Internet Explorer Compatibility view...............................................................................10 F5 load balancer configuration.............................................................................................10 Configure Application Navigator..................................................................................................11 Upgrade the database............................................................................................................. 12 Update login.sql...........................................................................................................................12 Verify that the required products are applied............................................................................. 12 Verify the banproxy database account....................................................................................... 13 Verify the ban_ss_user database account..................................................................................13 Verify Oracle user accounts to connect through banproxy.........................................................13 Set up access for application users with an administrative account.......................................... 13 Migrate staged files to the permanent directories...................................................................... 14 Unix....................................................................................................................................... 14 Windows................................................................................................................................15 Update the version numbers.......................................................................................................15 Restore original roles for accounts modified.............................................................................. 16 Undeploy existing application............................................................................................. 17 Undeploy applications by using the Tomcat Manager web application...................................... 17 Undeploy applications manually on UNIX.................................................................................. 17 Undeploy applications manually on Windows............................................................................ 18 Undeploy applications by using WebLogic................................................................................. 19 Customize the WAR file..........................................................................................................20 Unzip the release package......................................................................................................... 20 Prepare the installer....................................................................................................................20 Install into the product home directory....................................................................................... 21 Configure shared settings........................................................................................................... 23 JNDI datasource................................................................................................................... 23 Link to Self-Service Banner 8.x............................................................................................23 Navigational MEP support from Employee Self-Service to Banner Self-Service 8.x............24 ©2018 Ellucian. Confidential & Proprietary 3 Contents Session timeouts...................................................................................................................25 banner.transactionTimeout............................................................................................. 26 AJAX timeout..................................................................................................................26 defaultWebSessionTimeout............................................................................................ 26 Location of photographs.......................................................................................................27 Configure application-specific settings by modifying the groovy file...........................................27 JMX MBean name................................................................................................................28 Location of the logging file................................................................................................... 28 Logging level.........................................................................................................................29 Institutional home page redirection support......................................................................... 29 Proxied Oracle users............................................................................................................29 Logout URL...........................................................................................................................30 Provide the CAS logout page with a redirect URL........................................................ 30 Provide only a redirect URL.......................................................................................... 31 Password reset..................................................................................................................... 32 Redirect pages in a MEP environment................................................................................ 32 Theme Editor tool................................................................................................................. 32 Google Analytics...................................................................................................................35 Employee Self-Service Web app extensibility......................................................................35 Web app extensibility for UNIX......................................................................................36 Web app extensibility for Windows................................................................................36 Hibernate Secondary Level Caching in MEP environment.................................................. 37 Migrate messages.properties file to the database......................................................................37 Configure application-specific settings by modifying messages.properties file...........................37 Customize the messages.properties file.............................................................................. 38 Display name support...........................................................................................................38 Format employee addresses................................................................................................ 39 Change the phone format...................................................................................................