Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Launching Delft-FEWS 2017.01

to be inserted!!!!

 

There are a number of options when configuring the launch of your Delft-FEWS application. The most simple is to double click on the appropriate executable in the bin directory e.g. C:\FEWS\bin\Your_Region.exe - this will launch FEWS directly.

A typical FEWS installation has the following subdirectories in the FEWS root directory:

  1. bin: The FEWS binaries, scripts and native code.
  2. jre: The java runtime
  3. RegionHome: The region home with the FEWS configuration

Windows 32 and 64

Since 2017.01 FEWS is launched from the RegionHome directory. In the bin/launcher directory there are startup scripts available for all supported platforms (windows32, windows64, linux). Depending on a 64 or 32 bit environment copy the appropriate scripts to the RegionHome, for example Delft-FEWS_x64.ini and Delft-FEWS_x64.exe. Running Delft-FEWS_x64.exe will launch FEWS. The .exe can be renamed. This is convenient when having multiple FEWS system so you see the difference in the Windows Task Manager. The .ini file should always have same name as the .exe.

Linux

On linux the fews.sh script can be copied from the bin/launcher/linux directory to the FEWS root directory. Make sure the fews.sh script has executable permissions set. To run FEWS from the root directory run: ./fews.sh RegionHome. The fews.sh script also specifies the java heap size that is used by FEWS. To increase the size, this script should be tuned.

Sample Delft-FEWS_x64.ini

Code Block
main.class=nl.wldelft.fews.gui.explorer.Application
classpath.1=../bin/*.jar
vm.location=../jre/bin/server/jvm.dll
#start up heap memory size
vmarg.1=-Xms512m
#max heap memory size, limited to 1024m for windows 32 bits
vmarg.2=-Xmx1024m
splash.image=fews-splash.jpg


Since 2014.02 configure a ini file

...

The two executables are copies of java launchers provided by winrun4j. (see http://winrun4j.sourceforge.net)

Sample Delft-FEWS.ini

Code Block
#Delft-FEWS ini file
main.class=nl.wldelft.fews.gui.explorer.Application
classpath.1=*.jar

#Java Runtime jvm.dll location
vm.location=../jre/bin/client/jvm.dll
vmarg.1=-Xms512m
vmarg.2=-Xmx1024m

#location of the bin dir
working.directory=.

#region_home directory - <region_home> to be replaced with actual region home directory
arg.1=../<region_home>

#optional splash file - <region_home> to be replaced with actual region home directory
#splash.image=../<region_home>/splash_screen.jpg

#optional debug log - enable these #log and #log.overwrite for obtaining debug logging when the application fails to start, <region_home> to be replaced with actual region home directory
#log=../<region_home>/startup_debug_log.txt
#log.overwrite=true

...

vm.location=../jre/bin/client/jvm.dll

The location of the jvm.dll (from the Java JRE). On 64 bit JRE's the path is ../jre/bin/server/jvm.dll

 
vmarg.<index>=-Xms512mInitial amount of memory available for FEWS 

vmarg.<index>=-Xmx1024m

Amount of memory available for FEWS

 
vmarg.<index>=-XX:MaxPermSize=128mSet PermSize (default 64m, which is sometimes too low and results into PermSize errors) 
vmarg.<index>=-Dsun.java2d.noddraw=trueturns on/off all usage of Direct3D 
vmarg.<index>=-Djava.net.useSystemProxies=trueUse the LAN system proxy settings (default FALSE) 
vmarg.<index>=-DautoRollingBarrel=false

 switch on/off the rolling barrel (default TRUE)

 

classpath.1=*.jar

all the jars in the Delft-FEWS bin dir forming the classpath

 

main.class=nl.wldelft.fews.gui.explorer.Application

 Main class.

  • for the config manager use

main.class=nl.wldelft.fews.configmanagement.ConfigManagementApplication

  • for the launcher use

main.class=nl.wldelft.fews.launcher.Launcher

 

 

working.directory=.

Location of the Delft-FEWS bin dir

 

arg.1=../Anglian_SA

Path to the folder containing the configuration. Note that when the tag $USER_HOME$ is part of the foldername, it will be resolved by Delft-FEWS to the user.home directory.

 

...