Before You Begin

  • Environments that do not meet the system requirements are not covered by support services.
  • Commands prefixed with “#” should be executed as the root user, while those prefixed with “$” should be executed as a general user.
section divider

Download and Install Java Environment

First, download and install a Java version that meets the system requirements. You can also configure a separate Java runtime environment for Astah. → [See how to configure]

Download

Run the following command to check your Linux architecture (32-bit or 64-bit), then download Java from the official Java download page according to your environment:

$ file /sbin/init

Find System Requirements for your Astah:

If configuring a separate Java runtime for Astah, proceed [here].

section divider

Installation

1. Extract the downloaded file in any directory (replace the file name with the actual downloaded file name).

    $ tar -xvf jdk-8u121-linux-i586.tar.gz (32bit)
$ tar -xvf jdk-8u121-linux-x64.tar.gz (64bit)

    2. A new directory (./jdk1.8.0_121) will be created.

    3. Move the JDK directory to /usr/lib/.

    $ sudo mv ./jdk1.8.0_121 /usr/lib/jvm/jdk1.8.0

    4. Run the following commands to configure the Java environment:

    $ sudo update-alternatives --install "/usr/bin/java" "java"
"/usr/lib/jvm/jdk1.8.0/bin/java" 1
$ sudo update-alternatives --install "/usr/bin/javac" "javac"
"/usr/lib/jvm/jdk1.8.0/bin/javac" 1
$ sudo update-alternatives --install "/usr/bin/javaws" "javaws"
"/usr/lib/jvm/jdk1.8.0/bin/javaws" 1

    5. Run the following command.

    $ sudo update-alternatives --config java

    6. Run the following commands to configure the Java environment: (If you are choosing JDK 8, specify 4 in this sample code below.)

    $ sudo update-alternatives --config java
 There are 3 choices for the alternative java (providing /usr/bin/java).

 Selection Path Priority Status
 ————————————————————
* 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode
1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode
2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode
3 /usr/lib/jvm/jdk1.7.0/bin/java 1 manual mode
4 /usr/lib/jvm/jdk1.8.0/bin/java 1 manual mode

 Press enter to keep the current choice[*], or type selection number: 4
 update-alternatives: using /usr/lib/jvm/jdk1.8.0/bin/java to provide
/usr/bin/java (java) in manual mode.

    7. Verify the installed JDK version:

    $ java -version
java version "1.8.0_121"

    8. Re-run the following commands:

    sudo update-alternatives --config javac
sudo update-alternatives --config javaws
    section divider

    RedHat-based Systems

    CentOS, Fedora, RedHat

    1. Download the RPM package and save it to a directory (e.g., /tmp).
    2. Navigate to the directory and check the file size using the stat command.
    3. Install as the root user (Example: Astah Professional 10.0):
    #rpm -ivh --nosignature astah-professional-10.0.0.a1b9b1-0.noarch.rpm

    Note: If a dependency error occurs despite having Java installed, add the --nodeps option to the command.

    4. Start Astah with the command below. On GNOME Desktop, you can launch Astah from Applications > Accessories.

    $ astah-pro
    section divider

    Debian-based Systems

    Ubuntu, Debian GNU/Linux

    1. Download the DEB package and save it to a directory (e.g., /tmp).
    2. Navigate to the directory and check the file size using the stat command.
    3. Install as the root user (Example: Astah Professional 10.0):
    #dpkg -i astah-professional_10.0.0.a1b9b1_all.deb

    4. Start Astah with the command below. On GNOME Desktop, you can launch Astah from Applications > Accessories.

    $ astah-pro
    section divider

    Installing Astah Using ZIP Format

    1. Open the ChangeVision Members download page.
    2. Click on the product and select the target version.
    3. Click the [Download] button for “Archive without JRE and installer” and save it to a directory (e.g., /tmp).
    4. Navigate to the directory and check the file size using the stat command.
    5. Extract the ZIP file using the unzip command.
    6. Modify the Astah shell script to match your environment, then grant execution permission:
    #chmod 755 ./astah

    7. Execute the shell script:

    ./astah
    section divider

        Configuring a Separate Java Runtime for Astah

        You can specify a custom Java runtime for Astah by modifying the execution file.

        Steps to Modify Execution File

        1. Open the execution file (E.g: Astah Professional)

        /usr/lib/astah_professional/astah-pro

        2. Add the following code:

        PATH=/usr/lib/jvm/Desired-JDK-version/bin:${PATH}

        Example:

        #!/bin/sh
# JAVA_OPTS="$JAVA_OPTS -DrootLevel=DEBUG"
PATH=/usr/lib/jvm/jdk-21.0.4/bin:${PATH}  # Add this line