
  ----------------------------------------------------------------------
  Passage Server Installation
  ----------------------------------------------------------------------

  [Windows 7/8/10, Windows Server 2003/2008/2012]

  Step #1: Install Java SDK
  Step #2: Install Passage Server folders and files
  Step #3: Create ODBC Data Sources for Passage Server
  Step #4: Check Passage Server configuration file
  Step #5: Start Passage Server


  ----------------------------------------------------------------------
  Step #1: Install Java SDK
  ----------------------------------------------------------------------
  1. Install Java SE Development Kit 7.17 or higher from Oracle
  2. Add to system PATH two locations: SDK files [javac.exe, jar.exe, ...] and JVM file [jvm.dll].
     Example: c:\program files\j2se_7.17\bin;c:\program files\j2se_7.17\jre\bin\client;

  ----------------------------------------------------------------------
  Step #2: Install Passage Server folders and files
  ----------------------------------------------------------------------
  Extract folders and files from passage_server.zip into your location.
  For example into "c:" drive

  Folder Name                     Folder Description
  --------------------------------------------------
  c:\passage_server
  c:\passage_server\app           applications
  c:\passage_server\bin           exe, dll, cfg, log
  c:\passage_server\db            system databases
  c:\passage_server\dev           development
  c:\passage_server\dev\data      
  c:\passage_server\dev\images    
  c:\passage_server\dev\requests
  c:\passage_server\doc           documentation
  c:\passage_server\java          jar, SSL keystore

  File Name                       File Description
  ------------------------------------------------
  passagesrv.exe                  Passage Server [Windows service]
  passagesrv.cfg                  Passage Server configuration file

  wcontainer.dll
  whttpp.dll
  wjni.dll
  wreq.dll
  wsql.dll
  wtable.dll
  wtrace.dll

  mail.jar                       Mail                  [Oracle]
  ws.jar                         Java library          [PASSAGE]

  ws.mdb                         Passage Server system database       
  wsdev.mdb                      Passage Server system database

  ws_start.log                   Passage Server start log
  ws_sys.log                     Passage Server system log
  ws_app.log                     Passage Server application log
  ws_run.log                     Passage Server execution log


  ----------------------------------------------------------------------
  Step #3: Create ODBC Data Sources for Passage Server
  ----------------------------------------------------------------------
  Before starting Passage Server create two system ODBC data sources
  - Run Control Panel/Administrative Tools/Data Sources (ODBC)
  - Go to "System DSN"

  1. Data Source Driver:  Microsoft Access
     Data Source Name:    ws
     Description:         Passage Server
     Database File:       ws.mdb            [Passage Server system database]
     Example: c:\passage_server\db\ws.mdb 

  2. Data Source Driver:  Microsoft Access
     Data Source Name:    wsdev
     Description:         Passage Server
     Database File:       wsdev.mdb         [Passage Server system database]
     Example: c:\passage_server\db\wsdev.mdb 


  ----------------------------------------------------------------------
  Step #4: Check Passage Server configuration file
  ----------------------------------------------------------------------
  Passage Server does not use Windows Registry, it uses system
  configuration file passagesrv.cfg
  Example:
  c:\passage_server\bin\passagesrv.cfg 
  
  IP=127.0.0.1
  Port=80
  SysTrace=1
  AppTrace=1
  RunTrace=1                         
  ClassReload=1
  AppDir=c:\passage_server\app
  JavaDir=c:\passage_server\java
  DevDir=c:\passage_server\dev
  DbDir=c:\passage_server\db
  SSLDir=c:\passage_server\java\mykeystore.kdb

  SSLPwd=mypassword
  SmtpHost=127.0.0.1
  SmtpUser=someuser
  SmtpPwd=somepassword

  ----------------------------------------------------------------------
  Step #5: Start Passage Server
  ----------------------------------------------------------------------
  1. Install service
     The executable passagesrv.exe is a Windows service.
     - Go to c:\passage_server\bin
     - Run cmd.bat
     - Run passagesrv.exe ?          [to see all options]
     - Run passagesrv.exe -install   [to install service]

  2. Run service
     - Run Control Panel/Administrative Tools/Services
     - Start "Passage Server" service

  Check ws_start.log file.
  Example:
  c:\passage_server\bin\ws_start.log 
  15.01.2016 13:12:45:191  *** Server Start ***
  15.01.2016 13:12:45:191  Version              2.1
  15.01.2016 13:12:45:191  Load:
  15.01.2016 13:12:45:211  Applications         OK
  15.01.2016 13:12:45:216  Applications Users   OK
  15.01.2016 13:12:45:221  Requests             OK
  15.01.2016 13:12:47:154  Requests Parameters  OK
  15.01.2016 13:12:47:224  Requests Users       OK
  15.01.2016 13:12:47:322  Users                OK
  15.01.2016 13:12:47:652  Data Sources         OK
  15.01.2016 13:12:47:224  
  15.01.2016 13:12:47:224  Data Source Connections:
  15.01.2016 13:12:47:268  ...  
  15.01.2016 13:12:47:354  
  15.01.2016 13:12:47:356  JVM  
  15.01.2016 13:12:47:357  Class Path [Jars]:  
  15.01.2016 13:12:47:388  c:\passage_server\java\mail.jar
  15.01.2016 13:12:47:391  c:\passage_server\java\ws.jar
  15.01.2016 13:12:47:392  Class Path [Applications]:
  15.01.2016 13:12:47:395  ...
  15.01.2016 13:12:47:674  Start JVM            OK
  15.01.2016 13:12:47:674  
  15.01.2016 13:12:47:674  Folders:
  15.01.2016 13:12:47:674  Applications         c:\passage_server\app
  15.01.2016 13:12:47:674  Java                 c:\passage_server\java
  15.01.2016 13:12:47:674  Dev                  c:\passage_server\dev
  15.01.2016 13:12:47:674  DB                   c:\passage_server\db
  15.01.2016 13:12:47:674  
  15.01.2016 13:12:47:679  SmtpHost:            127.0.0.1
  15.01.2016 13:12:47:693  
  15.01.2016 13:12:47:694  IP:                  127.0.0.1 [mycomputername]
  15.01.2016 13:12:47:694  Port:                80

  Possible start up errors:
  -------------------------
  Error #1:
  Could not start the Passage Server service on Local Computer.
  Error 1053: The service did not respond to the start or control request in a timely fashion.
  [appears on the screen]

  Reason:
  jvm.dll not found. Even if you installed Java SDK and set PATH to jvm.dll location correctly,
  Windows still cannot find it.

  Solution:
  - Install Java SDK from Oracle version 1.17 or higher
  - Check PATH for jvm.dll location
  - Reboot computer and start service again
  -------------------------
  Error #2:
  File ws.mdb not found.  
  [appears in ws_start.log]

  Reason:
  Windows ODBC manager cannot find ws.mdb file.

  Solution:
  - Check/correct ODBC settings for ws.mdb
  - Stop service
  - Start service

