nerdug 2009 session 10924 webadvisor 101: from soup to nuts! 7/30/2009 at 2:00pm emerald room jeff...
TRANSCRIPT
NERDug 2009 Session 10924
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
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 Installation
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
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
Configuration
Detail to SVBP – Behavior Parameters Max Report Tries: 3 JavaScript Verification: NO (mult submit) Autocomplete Enabled: NO (credit cards)
Configuration
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
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
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
Configuration
Right click on web server
Click ”Configure Servlet Parameters”
Click ”WebAdvisor” Serlet ID: WAMAIN Servlet Mapping: /WebAdvisor
Configuration
Configuration
Right click on web server
Click ”Configure Servlet Parameters”
Click ”Help Servlet” Serlet ID: WAMAINHELP Servlet Mapping: /HelpServlet
Configuration
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
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
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
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
Deploying
Deploying
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