How to setup the launch of Delft-FEWS
...
Launching Delft-FEWS 2017.01
A typical FEWS installation has the following subdirectories in the FEWS root directory:
- bin: The FEWS binaries, scripts and native code.
- jre: The java runtime
- 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 |
...
Explanation of .ini entries
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>=-Xms512m | Initial amount of memory available for FEWS | |
vmarg.<index>=-Xmx1024m | Amount of memory available for FEWS |
| vmarg.<index>=-Dsun.java2d.noddraw=true | turns on/off all usage of Direct3D | |
| vmarg.<index>=-Djava.net.useSystemProxies=true | Use 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.
main.class=nl.wldelft.fews.configmanagement.ConfigManagementApplication
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. |
Notice that JAVA system properties should be defined after the -D keyword. JVM arguments are all specified with an integer index in ascending order without gaps, e.g.
...
In the bin from before 2014.02 there will also be a file of the same name with the extension .jpif (e.g. Your_region.jpif). Since the executable is generic (except for the name) this file contains all the information required to launch your application.
..\jre | The location of the JRE folder |
-mx512m | Amount of memory available for FEWS |
-cp |
|
$JARS_PATH$ |
|
nl.wldelft.fews.gui.explorer.Application | Application type* |
Anglian_SA | Name of folder containing the configuration |
*If wanting to use the config manager use line: nl.wldelft.fews.configmanagement.ConfigManagementApplication or for the launcher use nl.wldelft.fews.launcher.Launcher
It is possible to add JAVA runtime options the .jpif file.
..\jre | JRE Folder |
-Xms768m | Set initial java heap space |
-Xmx1024m | Set maximum java heap space |
-XX:MaxPermSize=128m | Set PermSize (default 64m, which is sometimes too low and results into PermSize errors) (not used in Java 8 and higher) |
-Dsun.java2d.noddraw=true | turns on/off all usage of Direct3D |
-Djava.net.useSystemProxies=true | Use the LAN system proxy settings (default FALSE) |
-DautoRollingBarrel=false | switch on/off the rolling barrel (default TRUE) in the OC |
-cp |
|
$JARS_PATH$ |
|
nl.wldelft.fews.gui.explorer.Application | |
$USER_ |
HOME$\Application Data\FEWS\Anglian_SA | Folder name of configuration, of which a working copy will be copied and used in the defined directory. The base directory should always be at the same level a JRE and BIN |
Notice that JAVA system properties should be defined after the -D keyword.
...