Installation

Since 2.0, CASSIS uses SQLite, everything is installed by the installer

1. Environnement compatibility

The installation of the current version has been successfully checked on at least the following OS:

  • Unix (Sun)
  • Linux (Ubuntu, Suse and Redhat)
  • Mac OSX 10.7 (Lion), 10.8 (Mountain Lion), 10.9 (Maverick), 10.10 (Yosemite) : Intel mac
  • Windows: (2000, XP, Vista, Seven), not lot of experience, please use the Bugs Report link in case of problem

CASSIS 6.3 require Java 1.8 or greater.

You can check your java version with the command java -version.
If you do not have java installed, you can download it here.

Note to MAC OSX users: Installing a JRE from Oracle will not update java -version symlinks or add java to your path. To be able to do this, you need to install the JDK. You can download it here.

!!! If you do not have Java 1.8 installed on your computer, please install it before installing CASSIS !!!

2. Online version

CASSIS is available as a full desktop application or an online version. The online version can be found here:

The online version of CASSIS is usable via Web Start technology Java version. This version starts with a mini SQLITE database (see here for details). You can also configure another database (such as VAMDC) in the "Database > Settings" menu. Note that the only template available by default with the online version is "COs" (main and minor isotopologues of carbon monoxide).

3. Installation

  • To download and install the CASSIS 6.3 application and database on your computer, just click the link below and follow the instructions of the installer:

  • If the installer does not start (can happen on some platforms/configurations), save the file installCassis.jnlp on your computer and execute it with the following command from a terminal window (not working on Mac OS 10.7 and 10.8) :

    javaws installCassis.jnlp

    where javaws is the javawebstart application you can find in your java directory (to determine where this directory is, in a terminal type: whereis java)

  • You can also download directly and untar the different cassis package :

  • If you plan to use RADEX within CASSIS, you have first to download, install and check RADEX:

    • Download RADEX from the official RADEX website
    • Install and check RADEX as stated on the RADEX website
    • When your RADEX install is working, copy the whole RADEX directory into your current CASSIS directory. This is mandatory because CASSIS will change some files of RADEX, making it unusable outside CASSIS. Do not run RADEX standalone from the RADEX directory in CASSIS, run it from your original install directory. Note that the collisional files in the RADEX/Data directory are not used, as used with RADEX standalone. CASSIS will use the collisional files in its database/lamda directory.

  • If you are using Java with a version greater than 1.8, you may need to download and replace the cassis.run file in the CASSIS folder to be able to launch it. You can download the file here: cassis.run.

4. Run Cassis

From an x-term go to the cassis directory and type:
./cassis.run xxxx
where xxxx is the size in mega bytes of the memory you want to allocate to CASSIS (just typing ./cassis.run, CASSIS will use by default 1 Gb of memory).

If you do not use x-term, you can launch CASSIS by double-clicking on the file cassis.bat. By default, CASSIS will use 1 Gb of memory. If you need more memory, edit this file cassis.bat and change the memory allocation in the 3rd line:
set /a DEFAULTMEM="xxxx"
where xxxx is the size in mega bytes of the memory you want to allocate to CASSIS.

5. Automatic Update

By default, CASSIS will check at everyday launch (CASSIS standalone and CASSIS plugged-in HIPE) if a new version is available on the CASSIS web site (these days, we are improving CASSIS on a day to day basis to add functionalities to analyze Herschel data). If you accept to install the new version, please note you'll have to exit CASSIS (and HIPE if using CASSIS plugged-in HIPE) to have the new version operational.

You can choose anytime to check if a new version is available in the pull down CASSIS help menu.

6. Old version

An old version of CASSIS, 5.1.1 is still available to download.

WARNING: do not use this database for the latest version 6 of CASSIS. If you do so, the methanol and 13-methanol transitions will not be computed correctly.
To use this database,
  • Decompress the file
  • Link it in CASSIS using the Database->Database Settings Tab,
  • Select Database Type : SQLITE,
  • Click on the "Select file" button for the database path.