NERDug 2009 Session WebAdvisor 101: From Soup to Nuts! 7/30/2009 at 2:00pm Emerald Room Jeff Butera Hampshire College

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 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 Must have SysAdmin rights Solution Updates Software Downloads WebAdvisor (6/25/2009)

WebAdvisor Installation

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

Installed Files

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

Configuration

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)

Deploying

Testing Does it work? Try accessing it! / 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

All Done! Comments? Questions? Complaints? Jeff Butera