440 likes | 556 Views
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. Outline. Assumptions Names Places ANT Installing Configuring Deploying. Assumptions. R18 Installed and running
E N D
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
Outline • Assumptions • Names • Places • ANT • Installing • Configuring • Deploying
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
Names (aka: Players) • ANT: open source from apache • WAR: web archive file • servlet: java component • deployment: location of source on PC
Places (aka: servers) • Colleague Application: windows/*nix • Web Server: windows/*nix • SA Valet PC: windows • Tomcat • apache/servletexec • Sun Java server
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
WebAdvisor Installation • Download from Datatel • http://clients.datatel.com • Must have SysAdmin rights • Solution Updates • Software Downloads • WebAdvisor 3.1.4 (6/25/2009)
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
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
Configuration • UI: UT – SVCF lookup WAMAIN (add) • Desc: Servlet for WebAdvisor • URL Pattern: WebAdvisor • User Interface: WEB • Servlet Usage: Default • Root URL Hyperlink: XWMN
Configuration • Detail to SVBP – Behavior Parameters • Max Report Tries: 3 • JavaScript Verification: NO (mult submit) • Autocomplete Enabled: NO (credit cards)
Configuration • 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
Configuration • SA Valet – Right click on env name • Click ”Add New Web Server” • Give it a name
Configuration • SA Valet - Right click on web server • Click ”Properties” • Deploy: C:\Datatel\WebAdvisor\WAMAIN
Configuration • 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)
Configuration • Right click on web server • Click ”Configure Servlet Parameters” • Click ”WebAdvisor” • Serlet ID: WAMAIN • Servlet Mapping: /WebAdvisor
Configuration • Right click on web server • Click ”Configure Servlet Parameters” • Click ”Help Servlet” • Serlet ID: WAMAINHELP • Servlet Mapping: /HelpServlet
Configuration • 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)
Configuration • 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
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!
Configuration • 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
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
Deploying • Need to deploy WAR file to web server • Different depending on • tomcat • apache/servlet exec • IIS/servlet exec • Sun Java Server (SunOne/iPlanet)
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
All Done! • Comments? • Questions? • Complaints? Jeff Butera jeff@hampshire.edu