General

At this section we want to answer some of the mostly asked questions about general jBEAM usage.

1 What are the jBEAM system requirements?
2 jBEAM does not start after updating Java version.
- 2.1 Solution for start_jBEAM.bat
- 2.2 Solution for jnlp file
3 Where do I find a complete overview about the start parameters of jBEAM?
4 How to integrate external libraries into jBEAM start?
5 Which types of files can be imported into jBEAM?

What are the jBEAM system requirements?

CPU: Any modern CPU, the faster the better.

RAM: 1GB minimum, at least 8GB recommended.

Hard Disk: 1GB minimum for program files, at least 4G recommended for temporary files and more.

Supported Operating Systems

Windows, Windows 10 recommended
Linux
Mac OS-X
64bit, even 32bit possible

Java Runtime Environment: jBEAM is Java based and comes with a bundled OpenJDK.

jBEAM does not start after updating Java version.

This case only affects customers who do not use our bundled Java, but use their own installation to start jBEAM.

Symptom: Depending on how jBEAM is started, the following error messages appear:

Error: An unexpected error occurred while trying to open file jBEAM.jar
-- or --
Error: Could not find or load main class com.AMS.jBEAM_Extern.jBMain

Reason: Starting with version Java SE 8u381 b32 Oracle introduced a new system property, jdk.jar.maxSignatureFileSize, for setting a maximum size of signature files. And the default setting (8MB) is too small for jBEAM. This change affects equally, the other Java versions, such as Java 11 and so on.

See Oracle: New System Property to Control the Maximum Size of Signature Files (JDK-8300596 (not public))

Because there are varous ways to start jBEAM, we will only describe the two most common ones here. If your way of starting jBEAM is not listed here, contact our jBEAM service desk.

In Java 8u401, this value was increased again to a sufficient value (16MB). So that the start of jBEAM is possible again without this parameter. (for more information and versions for Java 11 and higher, see link). https://bugs.openjdk.org/browse/JDK-8313215

Solution for start_jBEAM.bat

We need to insert this new parameter into your existing start_jBEAM.bat file:

Find your jBEAM installation folder (i.e. C:\Program Files\jBEAM-Lab)
Open the start_jBEAM.bat file with a text editor
Find this characteristic if-else-block:
IF %redirectConsole%==yes ( "%javaExeResolved%" -Ddebug=false -Xmx%maxMemory% -XX:+UseG1GC -XX:+UseStringDeduplication "-XX:ErrorFile=%userprofile%\jbCrash_%%p.log" com.AMS.jBEAM_Extern.jBMain -cp "%CLASSPATH%" %importFileParam% SingleInstance=%singleInstance% %startParameters% 1>"%timeStamp%_system.out.txt" 2>"%timeStamp%_system.err.txt" ) ELSE ( "%javaExeResolved%" -Ddebug=false -Xmx%maxMemory% -XX:+UseG1GC -XX:+UseStringDeduplication "-XX:ErrorFile=%userprofile%\jbCrash_%%p.log" com.AMS.jBEAM_Extern.jBMain -cp "%CLASSPATH%" %importFileParam% SingleInstance=%singleInstance% %startParameters% )
Depending on your jBEAM version and individual configurations, the names may be slightly different, but please stay with yours and only add the new parameter as described in (4).
Add this -Djdk.jar.maxSignatureFileSize=32000000 part as first parameter in both lines, i.e.:
IF %redirectConsole%==yes ( "%javaExeResolved%" -Djdk.jar.maxSignatureFileSize=32000000 -Ddebug=false -Xmx%maxMemory% ... ) ELSE ( "%javaExeResolved%" -Djdk.jar.maxSignatureFileSize=32000000 -Ddebug=false -Xmx%maxMemory% ... )

Solution for jnlp file

If you start jBEAM via Java WebStart technology (jnlp file), proceed as follows:

Find and open your jnlp file with a text editor
In this jnlp file, find this characteristic Quickstart run file block:
Next, find and open this run file with a text editor (the name and location of the quickstart.run may vary)
In this run file, find lines starting with vmarg=… and add this new one:

After saving your changes jBEAM should start as before.

In case of problems, contact our jBEAM service desk.

Where do I find a complete overview about the start parameters of jBEAM?

If you wish to get a complete and up-to-date overview about all possible start parameters of jBEAM including some explanation simple start jBEAM using the ”-help” parameter like:

This will print all available parameters to the console including some advice on how to use them.

Parameter	Description

Parameter	Description
-AutoCreateComponent	Automatically creates the given component at jBEAM start. Please use AutoCreateComponent=com.test.component.MyClass!
	Example: -AutoCreateComponent=<TEXT>
-AutomaticStart	start jBEAM application immediate when the applet is started. Default: true
	Example: -AutomaticStart=[true/false]
-BatchUrl	path to jBEAM batch file to be opened when jBEAM starts
	Example: -BatchUrl=<http://www.test.com/example.txt
-ConnectTo	connect to a data service. Syntax: 3 parameters separated by colon: service name (String), server IP address, server port
	Example: -ConnectTo=<TEXT>
-PreferredDataArraySize	DEPRECATED! Use "DataDepth" instead. Defines the arraysize all numerical arrays are initialized. Default: 1000
	Example: -PreferredDataArraySize=100
-DataDepth	the arraysize all numerical arrays are initialized. Default: 1000
	Example: -DataDepth=100
-Fullscreen	If true jBEAM will start in fullscreen mode, otherwise it will be started with normal window size. Default: false
	Example: -Fullscreen=[true/false]
-Help	Prints this help message and terminates the application
-ImportData	Definition of a data import to be performed by jBEAM automatically. The parameter format is XML as described by the following example:<import name="Sample Importer" type="com.AMS.jBEAM.FileImport_Diadem" src="http://localhost:8080/Foo/bar?file=path/to/file"
	Example: -ImportData=<TEXT>
-Language	Language of applet and jBEAM instance. Default: the system language if supported or english otherwise
	Example: -Language=<TEXT>
-LayoutUrl	Defines a path or URL to a jBEAM layout file which will be loaded on startup
	Example: -LayoutUrl=<http://www.test.com/example.txt
-LayoutFileUrl	DEPRECATED! Use "LayoutUrl" instead. Defines a path or URL to a jBEAM layout file which will be loaded on startup
	Example: -LayoutFileUrl=<http://www.test.com/example.txt
-LogFile	Defines the path to the log file. If the file does not exist it will be created
	Example: -LogFile=C:\example.txt
-Logger	DEPRECATED! Use "LogLevel" instead. Defines the default log level
	Example: -Logger=[Disabled/Error/Warning/Info/Config/Fine/Finer/Finest]
-LoggerStartCondition	DEPRECATED! Use "LogLevel" instead. Defines the default log level
	Example: -LoggerStartCondition=[Disabled/Error/Warning/Info/Config/Fine/Finer/Finest]
-LogLevel	Defines the default log level
	Example: -LogLevel=[Disabled/Error/Warning/Info/Config/Fine/Finer/Finest]
-LogLimit	defines how much chars will be logged for each log entry. A log limit below 0 indicates to log all chars
	Example: -LogLimit=100
-LogFileSize	defines the maximum size of the log file in megabytes. A value below or equal 0 indicates an unlimited file size
	Example: -LogFileSize=0.0
-Mode	jBEAM visualization mode: Desktop=Normal mode, Presentation=Unmodifiable mode, Service=Headless mode, ScriptServer=Script server mode, ScriptClient=Script client mode
	Example: -Mode=[Desktop/Viewer/Service/ScriptServer/ScriptClient]
-Undecorated	If true the main frame is displayed undecorated and maximized. Default: false
	Example: -Undecorated=[true/false]
-Menubar	jBEAM window with or without menu bar. Menu bar is only available in desktop mode, i.e. if parameter "Mode" is set to "Desktop". Default: true
	Example: -Menubar=[true/false]
-NewWindow	Start jBEAM in an own window. If false, jBEAM is started in the applet container. Default: true
	Example: -NewWindow=[true/false]
-Open	path to a custom file to open/import with jBEAM
	Example: -Open=<TEXT>
-OpenBeamMgc	path to BEAM project file (only read if openbin is not set)
	Example: -OpenBeamMgc=C:\example.txt
-Openbin	path to binary project file
	Example: -Openbin=<TEXT>
-OpenbinMode	Defines the mode for loading the binary project file (requires parameter OPENBIN)
	Example: -OpenbinMode=[Clear/KeepExisting/ReplaceExisting/KeepOldAndCreateNew]
-ImporterBufferSize	Changes the default size (in bytes) of internal data buffers used by selected importers which support this parameter.
	Example: -ImporterBufferSize=100
-PreferencesFile	defines the file, which should be used to load and store jBEAM preferences. In headless mode jBEAM reads preferences only if this parameter is set.
	Example: -PreferencesFile=C:\example.txt
-GlobalPreferencesFile	defines the file, which should be used to load and store global jBEAM preferences. In headless mode jBEAM reads global preferences only if this parameter is set or a global file is existing in local preferences file and local preferences file should be explicitly loaded.
	Example: -GlobalPreferencesFile=C:\example.txt
-Print	path to a custom file to open/import and print with jBEAM
	Example: -Print=<TEXT>
-Printbin	if true print jBEAM project file and exit immediately (requires parameter OPENBIN or OPEN_BEAM_MGC)
	Example: -Printbin=[true/false]
-ProjectfileUrl	path to jBEAM project file
	Example: -ProjectfileUrl=<http://www.test.com/example.txt
-Proxies	defines the proxies to try to connect to automatically. Please use Proxies=HOSTNAME:PORT,HOSTNAME:PORT,... !
	Example: -Proxies=<TEXT>
-ProxyPort	defines the port where the proxy should be created automatically. Please use ProxyPort=<PORT>!
	Example: -ProxyPort=100
-Servers	defines the servers to try to connect to automatically. Please use Servers=HOSTNAME:PORT,HOSTNAME:PORT,... !
	Example: -Servers=<TEXT>
-ServerPort	defines the port where the server should be created automatically. Please use ServerPort=<PORT>!
	Example: -ServerPort=100
-ServerPoolSize	defines maximum number of jBEAM instances in the jBEAM instance pool of the server
	Example: -ServerPoolSize=100
-ScriptUrl	Path or URL to a script file which is executed on jBEAM startup
	Example: -ScriptUrl=<http://www.test.com/example.txt
-Script	Path or URL to a script file which is executed on jBEAM startup
	Example: -Script=<TEXT>
-ScriptLanguage	defines the script language for executing the given ScriptURL parameter
	Example: -ScriptLanguage=[BeanShell/Groovy/Python/Jython]
-ServerDataImport	connect to server and start serverside import. Syntax: 3 parameters separated by colon: name of the importer class (String):name of the producer (String):import source (URL)
	Example: -ServerDataImport=<TEXT>
-Service	Service to be started with jBEAM. Provided services: "EnterpriseDataService"
	Example: -Service=<TEXT>
-Shell	indicates that jBEAM is started by shell
-ShowErrorMessageDialog	defines whether a user-dialogue is shown, if an expected or unexpected error occurs. Usage: ShowErrorMessageDialog=Yes/No/Ask. A dialogue is shown only, if jBEAM is started with GUI. The start parameter value overrides the value defined in the preferences file. However, the value in the preferences file is not modified, if the start parameter is defined.
	Example: -ShowErrorMessageDialog=[YES/NO/PENDING]
-ShowStartButton	Display a button for starting jBEAM. This parameter is only evaluated if AutomaticStart is set to false. Default: true
	Example: -ShowStartButton=[true/false]
-SyncMode	defines the default sync mode for items at server. Use "MIRROR" for automatically sync all items between server and client, use "MANUAL" to display a dialog for item selection or use "NONE" to sync no items between server and client.
	Example: -SyncMode=[MIRROR/MANUAL/NONE]
-Watch	if this option is used, a watcher is created which observes the BEAM project file for changes. (only relevant if a BEAM project file is imported)
	Example: -Watch=[true/false]
-WindowHeight	height of the initial jBEAM window (e.g. 768, 768px, 10cm, 8in, 50%)
	Example: -WindowHeight=0.0
-WindowWidth	width of the initial jBEAM window (e.g. 1024, 1024px, 15cm, 12in, 50%)
	Example: -WindowWidth=0.0
-WindowLeftPosition	horizontal position of upper left corner of the initial jBEAM window (e.g. 50, 50px, 2cm, 1in, 5%)
	Example: -WindowLeftPosition=0.0
-WindowTopPosition	vertical position of upper left corner of the initial jBEAM window (e.g. 50, 50px, 2cm, 1in, 5%)
	Example: -WindowTopPosition=0.0
-WindowTitle	Title of the application window
	Example: -WindowTitle=<TEXT>
-WindowScrollable	Determines the panel is scrollable (only in presentation mode, default: true)
	Example: -WindowScrollable=[true/false]
-WindowIcon	Path to customized icon file.
	Example: -WindowIcon=C:\example.txt
-Check	Checks the java environment for jBEAM and saves the result to check-result.txt.
	Example: -Check=[true/false]
-TempDir	Sets the default directory for temporary files of jBEAM.
	Example: -TempDir=C:\example.txt
-UseEncryption	Defines whether the complete EnCom traffic should be encrypted or not.
	Example: -UseEncryption=[true/false]
-EnComKeyStoreFile	Defines the file path to the key store for starting a SSL/TLS encrypted EnCom server. The key store usually contains the public and private key for the SSL socket. Defining a key store is mandatory for an encrypted EnCom connection.
	Example: -EnComKeyStoreFile=C:\example.txt
-EnComKeyStorePassword	Defines the password of the key store for starting a SSL/TLS encrypted EnCom server.
-EnComTrustStoreFile	Defines the file path to the trust store a SSL/TLS encrypted EnCom connection. The trust store usually contains public key of the EnCom server as trusted identity.
	Example: -EnComTrustStoreFile=C:\example.txt
-EnComTrustStorePassword	Defines the password of the trust store for a SSL/TLS encrypted EnCom connection.
-SingleInstance	Start jBEAM as singleton. Is only supported in combination with java webstart
	Example: -SingleInstance=[true/false]
-RemoteControlServer	Connect to a Remote-Control-Server (RCS) after start to enable remote controlling of the current jBEAM instance. Use RemoteControlServer="<IDENTIFIER>@<SERVER_NAME_OR_IP>:<SERVER_PORT>"!
	Example: -RemoteControlServer=<TEXT>
-SkipLibraries	If set jBEAM will not load libraries from lib folder on startup. Use this to manually edit classpath
	Example: -SkipLibraries=[true/false]
-LibrariesFolder	Defines the local folder were all jBEAM libraries are stored. This folder will be loaded on every jBEAM startup to load all libraries. The default is "%APPDATA%/jBEAM/lib" on Windows and "%USER_HOME%/jBEAM/lib" for all other Operating Systems.
	Example: -LibrariesFolder=C:\example.txt
-AutoLoadLibraries	If this option is set jBEAM will automatically load missing libraries from the webserver and install them to your local library folder.
	Example: -AutoLoadLibraries=[true/false]
-LibrariesSource	Defines the source URL for loading missing and updated libraries. The default is "<http://download.jbeam.com/libraries"
	Example: -LibrariesSource=<http://www.test.com/example.txt
-ChannelMappingFile	Defines a channel mapping file for mapping channel names and units.
	Example: -ChannelMappingFile=C:\example.txt
-ImportFile	Defines the path to a measurement data file (e.g. header file), project file, layout file or multimedia file, which should be loaded on jBEAM startup
	Example: -ImportFile=C:\example.txt
-ImportFiles	Defines comma-separated paths to measurement data files (e.g. header file), project files, layout files or multimedia files, which should be loaded on jBEAM startup in the given order
	Example: -ImportFiles=<TEXT>
-UseCustomProxy	Defines a proxy for URL connections (http, https, ftp) which is used for most connections made in jBEAM. Use UseCustomProxy=<USERNAME>:<PASSWORD>@<PROXYHOST>:<PROXYPORT> (username and password are optional).
	Example: -UseCustomProxy=<TEXT>
-UseSystemProxy	If this parameter is set to true jBEAM will use the system default proxy settings for all types of connections (e.g. to http servers).
	Example: -UseSystemProxy=[true/false]
-StartMeasure	DEPRECATED! Use MeasurementStatus instead. If this parameter is set to true jBEAM will start the measurement automatically.
	Example: -StartMeasure=[true/false]
-MeasurementStatus	This parameter configures the initial measurement status of jBEAM.
	Example: -MeasurementStatus=[STOPPED/STARTED/PAUSED]
-LicenseServer	Defines a connection to a license-server. On startup jBEAM will try to license against this server. Use <SERVER_NAME_OR_IP>
	Example: -LicenseServer=<TEXT>
-LicenseClaimMode	Defines the mode, a license is claimed (one license per machine or one license per jBEAM instance).
	Example: -LicenseClaimMode=[ONE_PER_MACHINE/ONE_PER_INSTANCE]
-CeaComponentsFolder	Defines the local folder were additional CEA components are stored. This folder will be loaded on every jBEAM startup to load CEA components.
	Example: -CeaComponentsFolder=C:\example.txt
-LookAndFeelClassName	Defines the swing look and feel. If not defined, the system-dependent look and feel is used.

How to integrate external libraries into jBEAM start?

Please look here.

Which types of files can be imported into jBEAM?

At the moment, the following file importers are available:

Importer	File Extensions	Filewatcher Support	Channel Mapping Support	Comment

Importer	File Extensions	Filewatcher Support	Channel Mapping Support	Comment
ASAM-MDF	mdf, mf3, mf4, dat	x	x
ASCII	txt, asc, csv, ...	x	x
ASCII-Matrix	matrix
ATF (ASAM-ODS)	atf, atfx, xml	x	x
Basytec				ParadoxJDBC library needed
BEAM	bsn, bsd, bsm, bvm, bxm, bsr, bvr, bxr, bsu	x	x
CAN-files	asc, blf, dbc
Dasylab	ddf
dBase v3-v5	dbf
DCM	dcm
Dewesoft	d7d, d7x, dxd	x	x
Diadem	dat, tdm, tdms	x	x
EDAS	edt
FAI-IGC	igc
Famos	fam, dat, raw	x
Gantner Universal-Bin-File	dat	x
Garmin	crs, hst, tcx
Gidas	asc, _asc, dat, tb	x	x
Google-KML	knl
GPS-Exchange-Format	gpx
HBM Catman	bin
HBM MGCplus-Harddisk-Files	mea
HBM Perception	pnrf
Hioki HiCORDER	mem
iFILE (AVL)	AVL iFile-files
ISO 13499 (MME)	mme			MME<=1.6
Labview	lvm
LMS	tdf
LS-Dyna	dat
Madymo	frc, lac, lvl, rds, rlg
Matlab	mat
Microsoft Excel	xlx, xlsx, xlsm	x	x
NetCDF	cdf, nc, he5, nc2		x
Nicolet	wft
PAtools	erg, org, atf_fu, mva	x	x
Porsche PD5		x
PTV (Partical Trace Velocity)	ptv
Q-DAS	dfq, dfd	x
Racelogic Vbox	vbo
Somat	sie, sit
RPCIII (MTS)	rpc, drv
Teac GX-1	hdr
Tecplot	dat, plt
Uniplot	nc2
Universal FileFormat	uff58, unv
Yokogawa	hdr, wdf			WDF with additional Yokogawa license
Zebris FDM
Zwick	erg