navigator: home > tutorials > run PEAR

home download manual tutorials analyzed protocols related papers links

There are two ways to run PEAR: using the WebStart mode (troubleshooting) or running it by the provided scripts. Notice that the WebStart mode does not allow you to extend PEAR's functionalities through plugins, so if you wish to run PEAR in standard mode you have to:

1. download PEAR
2. unzip the downloaded archive
3. change to the directory $PEAR_HOME/release/bin
4. launch run.bat if you are using a Windows operative system, otherwise use the script run.sh to launch PEAR under UNIX/Linux

Through both the scripts you can specify the name of the source containing the definition of the default validation rule system:

• the tool tries to find a file with name and path matching the ones given through the defaultRulesSource system property (see below);
• if no source can be found, it looks for a resource matching the given name and path in the classpath and in the plug-in modules loaded at start;
• if also this method fails, the default rule system is loaded (you can find it in the core.jar module).

To change the logger verbosity you have to set the appropriate values for the following system properties:

• logLevel handles the default verbosity level of the tool; it may have an integer value between -1 e 4;
• enableWarnings activates or deactivates the warnings; it may have value true or false;
• timeHeader tells the logger (not) to print a timestamp in the log header at each log operation; it may have value true or false;
• classHeader tells the logger (not) to print the name of the class that created the logger instance at each output operation; it may have value true or false;

If you wish to modify the values of the above system properties, you may edit the script's sources:

1. you might want to make a backup copy of the script
2. open the script you wish to modify with a common text editor
3. locate the environment variable JVM_OPT
4. locate the system property whose value is to be modified: a system property's name is prefixed by the option -D
5. change its value
6. save the modified source

Example:

JVM_OPT="-DdefaultRulesSource=synt-analysis.vr -DlogLevel=1
         -DenableWarnings=true -DtimeHeader=true -DclassHeader=false"

Troubleshooting

• I cannot web-start PEAR
  Probably the application/x-java-jnlp-file mime-type is associated with the wrong application: it should be associated with $JRE_HOME/javaws/javaws.

• I cannot find $JRE_HOME/javaws/javaws application
  Probably you need to install the Java Runtime Environment: try here.

Note: $JRE_HOME stands for the directory where the Java Runtime Environment is installed.

^top

PEAR Homepage - PEAR developed by Francesco Placella - Homepage designed by Francesco Pesenti and Francesco Placella