Install/Uninstall Astah Share
Before you install Astah Share
Before you start installing Astah Share, please make sure that your machine meets all the system requirements.
TCP Port
Astah Share requires following TCP Ports.
Apache Tomcat
Browser - Port 7080 is required for HTTP connection between Tomcat
H2 Database Engine
Port 8082 is required to manage Web Interface
Port 9092 is required for JDBC connection
How to install Astah Share
Please read this through with Install Astah Share in the Tutorial .
The license file would not be set yet after you deployed the Archive Installer, so Astah Share will be launched as Free Edition.
If you already have a license file, set it up by following
How to set up license file.
Administrator's email address and password are
jsadmin@example.com and
jsadmin by default. We strongly advise you to change this information from
User Management after the install is successfully completed.
How to install Astah Share on Windows
- Download an archive file(.zip) of Astah Share for Windows from Astah Website.
- Extract the archive file(.zip)
- Double-click "startup.bat" file to launch Astah Share
Since there is a limit on the folder path length on Windows, please make sure you extract Astah Share in the file that is
appropriate path length. (i.e. C:\astah-share-2_6)
In this example, Astah Share install folder is "C:\astah-share-2_6", please put your install folder name when you do this.
How to register to Windows service
Open a Command prompt and execute the command as follows.
Specify JAVA_HOME and CATALINA_HOME first and then register the service name, "astahshare".
You can name the service name as you like, but it should not have any spaces or symbols.
C:\> set JAVA_HOME=C:\astah-share-2_6\server\jre
C:\> set CATALINA_HOME=C:\astah-share-2_6\server
C:\> C:\astah-share-2_6\server\bin\service.bat install astahshare
Service name [astahshare] and its display name [Apache Tomcat astahshare] have been registered.
How to customize registered Windows Service
To change its display name, the JavaVM, Initial memory pool or Maximum memory pool, execute the following command and open the configuration screen.
C:\> C:\astah-share-2_6\server\bin\tomcat6w //ES//astahshare
We use "/opt/astah-share/2_6" as Astah Share's installation directory in the steps instructed below.
Download and Install Java Runtime Environment
JDK by Oracle is required to run Astah Share.(OpenJDK is NOT supported.)
- Install Oracle JDK to Linux( Help / Requirements )
- If you have already OpenJDK installed, please switch to use Oracle SDK by alternatives command by super user(root).
Install and configure Astah Share on Linux
- Download an archive file(.tar.gz) of Astah Share from Astah Website.
- Extracte the archive file(.tar.gz).
- Run startup.sh in the extracted directory, the tomcat including Astah Share should start shortly.
If you prefer not changing the JRE on your system default, you can change the JRE in the tomcat's configuration that Astah Share includes.
To do so, create the file below to "/opt/astah-share-2_6/server/bin/setenv.sh".
JAVA_HOME=/usr/java/jdk1.6.0_37
Register the script to SysVInit to run automatically.
- To let Astah Share start by SysVinit, use su command to be a super user.
- Create the configuration file at "/etc/sysconfig/astah-share".
#cp /opt/astah-share-2_6/astah-share.conf-example /etc/sysconfig/astah-share
Below are the configurable values in this file.
JAVA_HOME | Specify the JRE install directory. |
CATALINA_OPTS | The option of the Tomcat at launching. |
SHARE_USER | The OS user who executes Astah Share (default:root). |
SHUTDOWN_WAIT | Time to wait before force shutdown (default:30 sec) |
When you modify SHARE_USER, make sure to give the user a write permission to the install directory.
- Install the launching script to the system.
#ln -s /opt/astah-share-2_6/astah-share.redhat /etc/init.d/astah-share
#chkconfig --add astah-share
#chkconfig astah-share on
- If you'd like to launch immediately, run the command below.
#service astah-share start
Download and Install Java Runtime Environment
- Install Oracle JDK to Linux( Help / Requirements )
- If you already have OpenJDK OpenJDK installed , please switch to use Oracle SDK by update-alternatives command by super user(root).
JDK by Oracle is required to run Astah Share.(OpenJDK is NOT supported.)
Install and configure Astah Share on Linux
- Download an archive file(.tar.gz) of Astah Share from Astah Website.
- Extracte the archive file(.tar.gz).
- Run startup.sh in the extracted directory, the tomcat including Astah Share should start shortly.
If you prefer not changing the JRE on your system default, you can change the JRE in the tomcat's configuration that Astah Share includes.
To do so, create the file below to "/opt/astah-share-2_6/server/bin/setenv.sh".
JAVA_HOME=/usr/lib/jvm
Register the script to SysVInit to run automatically.
- To let Astah Share start by SysVinit, use su or sudo command to be a super user.
- Create the configuration file at "/etc/sysconfig/astah-share".
#cp /opt/astah-share-2_6/astah-share.conf-example /etc/default/astah-share
In the configuration file, configurable values are below.
JAVA_HOME | Specify the JRE install directory. |
CATALINA_OPTS | The option of the Tomcat at launching. |
SHARE_USER | The OS user of execute Astah Share (default:root). |
SHUTDOWN_WAIT | Time to wait before force shutdown (default:30 sec) |
When you modify SHARE_USER, make sure to give the user a write permission to the install directory.
- Install the launching script to the system.
#ln -s /opt/astah-share-2_6/astah-share.debian /etc/init.d/astah-share
#update-rc.d astah-share defaults
- If you'd like to launch immediately, run the command below.
#service astah-share start
If your system doesn't have service command, please run the script(/etc/init.d/astah-share start) directly.
Configuring environment variables - startup.sh, shutdown.sh
i.e. JAVA_HOME, PATH variables
Specify Java runtime environment to run Astah Share on. Please see the System Requirements for supported Java information.
JAVA_HOME=/usr/lib/jvm/jre1.6.0_26
export JAVA_HOME
PATH=$JAVA_HOME/bin:$PATH
export PATH
How to uninstall Astah Share
- Stop Astah Share
- Delete all the folders of Astah Share from the computer
Deleting all the Astah Share install folders will delete all astah files, diagrams and comments that were registered with Astah Share.
We strongly advise you to backup them before you uninstall in case you want to keep them. For how to backup, please refer to
Backup
How to update Astah Share to version 2.6
Follow the step below to update Astah Share to version 2.6
because updating to version 2.6 by installing it doesn't let you to use old data you used in version 2.5 or earlier automatically.
- Stop Astah Share 2.5
- Install Astah Share 2.6 into a separate folder than Astah Share 2.5 is installed (Do not run Astah Share 2.6 yet)
- Delete %Astah Share 2.6 Install folder%\data
- Copy %Astah Share 2.5 Install folder%\data to %Astah Share 2.6 Install folder%\data
- Open %Astah Share 2.6 Install folder%\dbmigrate.bat with text editor and set a path Astah Share 2.6 Install folder for "set ASTAH_SHARE="
- Run %Astah Share 2.6 Install folder%\dbmigrate.bat
- Run Astah Share 2.6
If you are using Linux, use dbmigrate.sh instead of dbmigrate.bat at step5.