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

    Linux command to open the installer GUI with root permissions
    /tmp/jade_client.x.x.x/setup.sh
    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.

      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.

    Parameter file to start the installer without GUI
    <?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

    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

    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

    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 JADE API