Requirements

• Starting from Release 1.6.4043 an Oracle Java or OpenJDK Runtime Environment 1.7 or later is required.
• Starting from Release 1.9 an Oracle Java or OpenJDK Runtime Environment 1.8 or later is required.

Installation

• Extract the downloaded archive jade_client_linux.x.x.x.tar.gz respective jade_client_windows.x.x.x.zip  to an arbitrary directory, e.g. /tmp/ or C:\Temp\ and run the installer dialog for YADE Client using

  Code Block
  language bash title Linux command to open the installer GUI with root permissions
  /tmp/jade_client.x.x.x/setup.sh

  Code Block
  language bash title Windows command to open the installer GUI with root permissions
  C:\Temp\jade_client.x.x.x\setup.cmd

• On Linux ...
  
  • The setup.sh calls sudo  to get root permissions. It is strongly recommended that you not logged in as root.
  • root permissions are not mandatory.

  • If you want to start the installer without root permissions then you can call it with the -u option.

    Code Block
    language bash title Linux command to open the installer GUI without root permissions
    /tmp/jade_client.x.x.x/setup.sh -u

• On Windows the option -u fro an unprivileged installation is not available. The installer asks always for elevated administrator permissions.
• Now the installer opens a GUI to enter the installation path.

...

• You can start the installer without GUI, e.g. if no X-Server is installed on Linux.

• In this case you have to edit the file jade_client_install.xml to configure the installation path in Line 22.

  Code Block
  language xml title Parameter file to start the installer without GUI linenumbers true collapse true
  <?xml version="1.0" encoding="UTF-8" standalone="no"?> <!-- XML configuration file for JADE Client setup If you call the setup with this XML file then you accept at the same time the terms of the GNU GPL 2.0 License agreement (see licence.gpl or http://www.gnu.org/licenses/gpl-2.0.html) --> <AutomatedInstallation langpack="eng"> <com.izforge.izpack.panels.UserInputPanel id="home"> <userInput/> </com.izforge.izpack.panels.UserInputPanel> <com.izforge.izpack.panels.HTMLLicencePanel id="licence"/> <com.izforge.izpack.panels.TargetPanel id="target"> <!-- SELECT THE INSTALLATION PATH The path must be absolute! Default paths are /opt/sos-berlin.com/jade/client for Unix C:\Program Files\sos-berlin.com\jade\client for Windows --> <installpath>[:select absolute installation path of the YADE Client:]</installpath> </com.izforge.izpack.panels.TargetPanel> <com.izforge.izpack.panels.InstallPanel id="install"/> <com.izforge.izpack.panels.ProcessPanel id="process"/> <com.izforge.izpack.panels.FinishPanel id="finish"/> </AutomatedInstallation>

• After you have configured the jade_client_install.xml  then you call

  Code Block
  language bash title Linux command to start the installer with root permissions
  /tmp/jade_client.x.x.x/setup.sh /tmp/jade_client.x.x.x/jade_client_install.xml

  or

  Code Block
  language bash title Linux command to start the installer without root permissions
  /tmp/jade_client.x.x.x/setup.sh -u /tmp/jade_client.x.x.x/jade_client_install.xml

  or

  Code Block
  language bash title Windows command to start the installer with root permissions
  C:\TEMP\jade_client.x.x.x\setup.cmd C:\TEMP\jade_client.x.x.x\jade_client_install.xml

Use with the YADE API

The YADE Command Line Client comes with all the files necessary to allow use via the API.

Follow the link for more information about the use of the YADE JADE API