wiki:InstallServerWindows-en
Last modified 12 months ago

(quickly updated for SCENARIserver 3.7, need to be confirmed by testing)

SCENARIserver Windows

Downloads / Requirements

Attention !

Tomcat Install Path A JVM bug may require that the tomcat server is installed in a path with no spaces. If it's not the case, you might get this error : 'java.net.URISyntaxException: Illegal character in path ...'.

Setup

  • You need to create some environment variables if they doesn't already exists. With windows XP, go to configuration panel -> system -> advanced -> environment variables -> system variables-> new
    • name = OOO_DISABLE_RECOVERY, value = 1
    • name = ANT_HOME, value = c:\... (path were you installed ant, without the bin folder)
    • name = JAVA_HOME, value = c:\...
    • name = JAVA_OPTS, value = -Xmx1500M -Xms1500M -verbose:gc (you can try "800M" if you have only 2Gb memory on the system, but we suggest not using any server with less than 4Gb memory except for test purpose or really small projects)
  • unzip the SCENARIserver
  • Tweak the file build.property in the SCENARIserver directory that you just extracted.
    • server.work.path = create a new empty directory on your filesystem, and set the workpath to this directory
    • server.URL = replace 127.0.0.1 by your server IP or hostname , if you let it commented out, it will try to detect it automatically

Build

  • Run the WebApp build file: "buiWebApp.bat"

<TODO: i should check this step, maybe it need to be better described, there may be some other things to do>

Post-build

  • Install the WebAPP on Tomcat <TODO: comment this step, i guess you just have to copy the .war file in the tomcat webapp directory but not sure>
  • Copy/past the "libext" directory content in the "common\lib" subdirectory of Tomcat
  • Copy/past the "data" directory content in the "server.work.path" directory that you changed the first time
  • Restart Tomcat
  • Check the page :  http://127.0.0.1:8080/SCENARIserver3/s/chain/u/ping (admin/test), it should print "OK" (replace 127.0.0.1 by the server name or the server IP, as specified in the build.properties file)
  • take any necessary steps to have tomcat started if the computer reboot (set it as a windows service ?)

Attention !

Dont forget to properly setup and test some backups, especially for the source XML files. Hard drive failure or user accidental deletion is a serious risk.

Usage

For your first connexion or if you lost your password, you can edit the password file manually : <server.work.path>/users/ac/admin/acdef.xml

Attention !

password file are not encrypted and you should make sure only authorized users can access them.