Start and Stop Astah Share

How to start Astah Share on Linux

  1. Execute "startup.sh". This startup.sh file would be stored in the "/usr/local/astah-share-2_5/" if you extract the archive files in "/usr/local/"
NOTE:X Window System(X Server) is required to use Astah Share since Astah Share uses Java's AWT(AbstractWindowToolkit) to generate image information from astah files. Please download X Server or virtual X Server such as Xvfb in order to use Astah Share.

If you execute Xvfb like this,

 $ /usr/bin/Xvfb :1 -screen 0 1024x768x24  &

You need to change the DISPLAY parameter in the startup.sh as shown below.

#! /bin/sh

# set your environment variable 'DISPLAY' correctly.
DISPLAY=":1.0"
export DISPLAY

How to stop Astah Share on Linux

Execute the "shutdown.sh"

Tomcat port numbers

Astah Share uses Tomcat's Port number 7080 by default. In case 7080 is occupied, you need to specify another port number. If the 7080 is used by other software, an error like below appears in Tomcat window.

SEVERE: Error initializing endpoint
		
java.net.BindException: Address already in use: JVM_Bind:7080

You can check what is currently connected to your computer by typing "netstat -an" in command prompt.

C:\>netstat -an 
		
Active Connections
Proto Local Address; Foreign Address State
TCP 0.0.0.0:7080 0.0.0.0:0 LISTENING

If status of Port 7080 is LISTENING, that means Port 7080 is occupied. If 7080 is used by another service, open "server\conf\server.xml" with text editor such as Note Pad and specify an available port number at about line 67 from the top.

(i.e.) Change the port to 9080 from 7080

[Before]

Connector port="7080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="7443"/>

[After]

Connector port="9080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="7443"/>

Tomcat SSL setting

SSL is not configured yet when you first start Astah Share. To enable SSL, you need to take out the comment in the serrver.xml file as example shown below. (Port 7443 is used to enable SSL connection in the example) Though if the Port is occupied, you need to configure another port number and restart Astah Share after you configure. Please refer to ApacheTomcat7.0 - SSL Configuration HOW-TO for details about configuration of Tomcat SSL.

[Before]

<!--
<Connector port="7443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS" />
-->

[After]

<Connector port="7443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS" />