1. A Community of Learning SUNGARD SUMMIT 2007 | sungardsummit.com Luminis 101 and More Presented by: Brad Vacura SunGard Higher Education March 21, 2007 Course ID 881

2. About Me Brad Vacura Luminis Technical Consultant, SunGard Higher Education Portal Administrator and onsite consultant for Montgomery College Long-time experience with SunGard products Banner Campus Pipeline – Luminis

3. Course ID 881 Topics of Discussion Luminis environment overview How to get started Portal troubleshooting Proactive vs. reactive Key log files to monitor in the portal How to work with the Luminis LDAP Some helpful tips on maintaining a sound Luminis environment Housekeeping procedures

4. Course ID 881 Luminis environment overview Luminis Server Calendar and Platform RDBMS Server for Luminis Group/Course Studio uPortal E-mail Server(s) Integrated e-mail with Luminis Microsoft Exchange, etc. Banner Self Service or other ERP Web Interface WebCT/Blackboard or other DL System Other external systems Library Bookstore, etc.

5. Course ID 881 For starters Luminis System Administration Class held monthly at Salt Lake City Enrollment information found on www.sungardhe.com Suggested reading material Luminis System Administration Guide Subscribe for your SunGard Customer Service Center account Subscribe to SunGard Higher Education ListServs: LUMTECH LUMPLATFORM Get yourself a great text editor that supports macros

6. Course ID 881 Overall portal troubleshooting Learn ways to become proactive vs. reactive Learn how to become more self-sufficient Learn what signs to look for before little problems become serious problems Log monitoring – I’ll show you some of the key log files to routinely monitor Server maintenance Making it easier to have a life outside of portal administration

7. Course ID 881 Proactive vs. Reactive Proactive Performing routine maintenance on your system. Checking log files on regular basis for errors. Take static copies of log files when things are running well to compare against when system is having trouble. Subscribing to/checking SunGard Higher Education ListServs Checking “recommended patches” FAQ and applying any patches recommended as by our Customer Support Center. ListServs notify you of supported releases and updated patch levels, and new FAQs. Maintaining OS patches on Luminis and other dependent servers.

8. Course ID 881 Proactive vs. Reactive Reactive Waiting until system is down or situation is critical before checking log files. Not regularly checking filesystem for OS to see if disk is filling up. Using Customer Support Center only to log calls, not to check for FAQs or viewing FAQs after a problem, not before.

9. Course ID 881 Log files to monitor $CP_ROOT/logs/cp.log Contains messages most pertinent to Luminis components $SCT_LMG_HOME/Events/logs/event_data.log Message Gateway logs of events set to the Message Broker $CP_ROOT/logs/datapipeline-main.log Contains error and status information for Message Broker $CP_ROOT/logs/datapipeline-audit.log Contains actual XML of events processed by Message Broker $CP_ROOT/logs/mb-broker.log Log information of events processed by the Message Broker

10. Course ID 881 WebServer troubleshooting When users get this instead of a login page, first, look at the WebServer to ensure that it’s running. ● Check “errors” log ● Run pingcp Or when page loads are sluggish, check the WebServer “errors” log to review problems ● errors and access log files located in $CP_ROOT/products/ws/https-cp/logs

11. Course ID 881 Know what’s supported and what’s not Don’t corrupt your LDAP There are supported ways to manage data in the LDAP and non-supported ways. LDAP browser edits are not supported cptool, ldapmodify are supported ways to modify the LDAP

12. Course ID 881 Working with the LDAP: Configman configman Used to work with configuration information from the configuration directory within the LDAP configman -x EXTRACT configuration directory to a file configman -i IMPORT parameter settings from a file configman –s SUBSTITUTE/SET values for parameters configman –g GET value for single parameter configman -g pds.ldap* configman –r [ -c all ] REMOVE parameter and value from the configuration directory

13. Course ID 881 Display and update user attributes Display, add, and remove courses in the system and update the instructors and students associated with the courses List and terminate active user sessions Configure the secret recovery process Stop and start the system or its services Import and export files Process files of multiple cptool commands Set up an interactive cptool session cptool process file interactive type “quit” to end the interactive session Get help on cptool commands Luminis Management: cptool

14. Course ID 881 Luminis Management: cptool Syntax: cptool example: cptool get user stu5 Major Note: Issue cptool commands as administrative user (i.e., cpadmin, lmadmin, etc.). Issue cptool commands in a Bash (NT) or console (Solaris) window.

15. Course ID 881 Luminis Management: ldapsearch ldapsearch allows you to search the LDAP from the command line Entries appear just as they would in ldap browser Located under $CP_ROOT/products/ds/shared/bin $./ldapsearch -h localhost –D "$BINDDN" -p "$PDSPORT"-w "$BINDPASS" -b "ou=People,o=slclab17.sct.com,o=cp" -s sub "uid=stu1" > $HOME/ldapsearch_results.txt

16. Course ID 881 Luminis Management: ldapmodify ldapmodify allows you to perform updates or inserts into the LDAP from the command line Located under $CP_ROOT/products/ds/shared/bin $./ldapmodify -h localhost -D "$BINDDN" -w"$BINDPASS" -p "$PDSPORT" -f$HOME/credentialexpired2.ldif dn: uid=USERN, ou=People,o=slclab17.sct.com, o=cpchangetype: modifyreplace: pdsCredentialExpiredpdsCredentialExpired: true

17. Course ID 881 checkluminis Checks the Luminis services via pingcp Checks the Message Broker via mbtool list brokerstatus Checks the Self Service Authenticator and LMG (Learning Management Gateway) Sweeps the cp.log and other pertinent log files for errors in order to have a proactive response to them Checks overnight batch processes like backups Verifies automated processes that are scheduled to run, like restarting the WebServer Verifies tab statistics have run, compiled and posted Checks user statistics Checks filesystem Checks CPU usage Process ran on demand

18. Course ID 881 checkluminis results

19. Course ID 881 checkluminis script clear echo "Checking Luminis Services" echo "Please wait..." echo " " #Checking Port 80: WebServer" pingcp -u http://luminis.university.edu:80 -v > $HOME/port80check.txt #Checking Port 443: WebServer" pingcp -u https://luminis.university.edu:443 -v > $HOME/port443check.txt #Checking Port 389: LDAP" pingcp -u https://luminis.university.edu:389 -v > $HOME/port389check.txt #Checking port 6785: Calendar" pingcp -u http://luminis.university.edu:6785 -v > $HOME/port6785check.txt #Checking port 7677: MessageBroker" pingcp -u http://luminis.university.edu:7677 -v > $HOME/port7677check.txt #echo " "; echo " " grep "success=false" $HOME/port80check.txt > $HOME/port80check2.txt grep "success=false" $HOME/port443check.txt > $HOME/port443check2.txt grep "success=false" $HOME/port389check.txt > $HOME/port389check2.txt grep "success=false" $HOME/port6785check.txt > $HOME/port6785check2.txt grep "success=false" $HOME/port7677check.txt > $HOME/port7677check2.txt If.

20. Course ID 881 checkuser results version: 1 dn: uid=jsmith,ou=People,o=luminis.university.edu,o=cp uid: jsmith pdsRole: admin pdsRole: Student pdsRole: Classified_Admin pdsRole: prospectivestudent pdsRole: applicantaccept pdsRole: employee sn: Smith pdsAccountStatus: enabled. pdsEmailDefaultAddress: jsmith@luminis.university.edu icsCalendarOwned: jsmith$Mr Jonathan J Smith pdsTimeOut: 7200 pdsLoginSuccess: 2005-12-17 20:49:25.0206Z pdsLoginFailure: 2005-12-16 14:56:32.0602Z

21. Course ID 881 checkuser script clear stty erase ^H echo " " echo "Checking for user $1. Please wait..." PDSPORT=`cpproperty pds.ldap.host.port` PDSCONTEXT=`cpproperty pds.ldap.naming_context` BINDDN=`cpproperty pds.ldap.directory_manager.userid` BINDPASS=`cpproperty pds.ldap.directory_manager.password` cd /cproot/products/ds/shared/bin./ldapsearch -h localhost -D "$BINDDN" -p "$PDSPORT" -w "$BINDPASS" -b "ou=People,o=luminis.university.edu.edu,o=cp" -s sub "uid=$1" > $HOME/ldapsearch_results.txt cd echo " " echo "Search completed." echo " " cat $HOME/ldapsearch_results.txt

22. Course ID 881 Luminis housekeeping procedures Re-indexing the LDAP Hot re-indexing vs. Cold re-indexing Rebuilding calendar database Mailbox, mail store reconstructs Cleaning up orphaned mailboxes Banner event table cleanup (see next slide) Keep up with the updates Removal of old terms in Luminis Duplicate PIDM cleanup Duplicate PIDMs in Banner often make duplicate Luminis accounts.

23. Course ID 881 Banner Table Maintenance Size them appropriately in advance Size for peak periods GOBEQRC is considered a medium size table GORERRC and GOREQER are considered large Purge data to conserve space Sample scripts in /general/plus directory gdeleqrc – purges GOBEQRC and GOREQRC gdeleqer – purges GOREQER data Do not truncate tables (can’t delete events Ready for/In Process) Will need to defragment occasionally

24. Course ID 881 Key Banner Forms GUASYST System Identification form Query-only form Good first step in troubleshooting GOREQNM Event Queue Name Definitions form Used to turn on or off LDI Events GOAEQRM Event Queue Record Maintenance form Used to view events that have processed, failed or are ready to be processed GOATPAD or GOATPAC Third-party access forms Used to reset PINs for SSB or another external application like WebCT

25. Course ID 881 GUASYST

26. Course ID 881 GOREQNM

27. Course ID 881 GOAEQRM

28. Course ID 881 GOATPAD

29. Course ID 881 GOATPAC

30. Course ID 881 Thank You! Brad Vacura Brad.Vacura@sungardhe.com Please complete the online class evaluation form Course ID 881 SunGard, the SunGard logo, Banner, Campus Pipeline, Luminis, PowerCAMPUS, Matrix, and Plus are trademarks or registered trademarks of SunGard Data Systems Inc. or its subsidiaries in the U.S. and other countries. Third-party names and marks referenced herein are trademarks or registered trademarks of their respective owners. © 2007 SunGard. All rights reserved.