1. NERDug 2009 Session 10924 WebAdvisor 101: From Soup to Nuts! 7/30/2009 at 2:00pm Emerald Room Jeff Butera Hampshire College jbutera@hampshire.edu

2. Outline Assumptions Names Places ANT Installing Configuring Deploying

3. Assumptions R18 Installed and running SA Valet installed on a PC Java installed on PC with SA Valet Must have full Java SDK (dev kit) JRE will NOT suffice for ant! Must set JAVA_HOME environment variable

4. Names (aka: Players) ANT: open source from apache WAR: web archive file servlet: java component deployment: location of source on PC

5. Places (aka: servers) Colleague Application: windows/*nix Web Server: windows/*nix SA Valet PC: windows Tomcat apache/servletexec Sun Java server

6. Installing ANT http://ant.apache.org Download (binary, if available) Must also have java installed Unzip Must set PATH variable, eg:...;C:\Program Files\ant-1.7.1\bin

7. WebAdvisor Installation Download from Datatel http://clients.datatel.com Must have SysAdmin rights Solution Updates Software Downloads WebAdvisor 3.1.4 (6/25/2009)

8. WebAdvisor Installation

10. WebAdvisor Installshield Must have client ID/password to run Place in ”typical” location, eg: C:\Datatel\WebAdvisor Deployment directory Use typical value, eg: WAMAIN Files get placed into (need this for SA Valet!) C:\Datatel\WebAdvisor\WAMAIN

11. Installed Files

12. Configuration Some config in UI, some in SA Valet UI: UT – HLKM lookup 'XWMN' (add) Desc: WAMAIN Servlet Open in New Window: NO Link Type: http/https Target Server Addr: server.college.edu Target Server Port: 80, 44,3 8080, 8443, etc Target Server Path List: WebAdvisor User Interfaces: WEB

13. Configuration

14. UI: UT – SVCF lookup WAMAIN (add) Desc: Servlet for WebAdvisor URL Pattern: WebAdvisor User Interface: WEB Servlet Usage: Default Root URL Hyperlink: XWMN

15. Configuration

16. Detail to SVBP – Behavior Parameters Max Report Tries: 3 JavaScript Verification: NO (mult submit) Autocomplete Enabled: NO (credit cards)

17. Configuration

18. UI: UT – SVCF lookup WAMAINHELP (add) Desc: Help Servlet for WebAdvisor URL Pattern: HelpServlet User Interface: WEB Servlet Usage: Default Root URL Hyperlink: XWMN Save out, then go back to SVCF for WAMAIN Add WAMAINHELP under Help Servlet

19. Configuration

20. SA Valet – Right click on env name Click ”Add New Web Server” Give it a name

22. Configuration SA Valet - Right click on web server Click ”Properties” Deploy: C:\Datatel\WebAdvisor\WAMAIN

23. Configuration

24. Right click on web server Click ”Configure Global Parameters” DMI Host: Colleague server (name/IP) DMI Port: APP Listener port (in SA Valet) App. Environment: name_rt Secure Flag: Y/N (ssl)

25. Configuration

26. Right click on web server Click ”Configure Servlet Parameters” Click ”WebAdvisor” Serlet ID: WAMAIN Servlet Mapping: /WebAdvisor

27. Configuration

28. Right click on web server Click ”Configure Servlet Parameters” Click ”Help Servlet” Serlet ID: WAMAINHELP Servlet Mapping: /HelpServlet

29. Configuration

30. Right click on web server Click ”Update License Key” Enter client ID/password Will verify your license Will write key and configuration to web.xml Only needs to be done once (Unless you delete deploy directory/web.xml)

31. Configuration

32. Setup ”guest” user Add a new PERSON record (NAE) for ”guest” Add a username however you do this Setup DRUS with Opers Equiv: DMI_REG_GUEST Security Classes: DMI_REG_GUEST

33. Configuration UT-SOD setup Add username & PERSON ID User Interface/Menu/Timeout UI * null WEB CORE-WBMAIN 600 Security Classes Build list like UI security Do NOT list process ID instead of mnemonic!

34. Configuration

35. WSPM setup: Guest Users Opers: your SOD record User Name Output Format (see help for options) Default Menu Mnemonic: CORE-WBMAIN Default Theme: ORIGINAL Security Token Expires: 600 Excessive Hook Threshold: 600

36. Configuration

37. Deploying Need to build WAR file Open DOS window (run cmd.exe) Change into Deployment directory cd C:\Datatel\WebAdvisor\WAMAIN Run ANT ant Will take 5-10 seconds, build webadvisor.war

38. Deploying

39. Need to deploy WAR file to web server Different depending on tomcat apache/servlet exec IIS/servlet exec Sun Java Server (SunOne/iPlanet)

40. Deploying

43. Testing Does it work? Try accessing it! http://address:port / path_list / url_pattern Address: (UI) HLKM Port: (UI) HLKM Path list: (UI) HLKM + name of WAR file Url pattern: (UI) SVCF + (SA) Servlet Properties https://thehub.hampshire.edu:8443/WebAdvisor/WebAdvisor

44. All Done! Comments? Questions? Complaints? Jeff Butera jeff@hampshire.edu