This page guides you how to set up the plug-in development environment for Astah SysML.

Set up the development environment

  1. Make sure that your environment meets the System Requirements.

2. Download the Astah Plug-in SDK. (The SDK is based on Maven3).

3. Extract the Astah Plug-in SDK to a folder then set the following environment variables.

  • Add [ASDK_HOME] and specify the folder where you deployed the Astah Plug-in SDK:
e.g.) set ASDK_HOME=C:\dev\astah-plugin-SDK-1.5
  • Specify “%ASDK_HOME%\bin” (“$ ASDK_HOME /bin” if you are using Linux or Mac) folder to [PATH], where the executable files of Astah Plug-in SDK’s exist:
e.g.) set PATH=%ASDK_HOME%\bin;%PATH%
  • If the environment variable [JAVA_HOME] is not specified, install Java that meets the System Requirement (Most of Astah installers are including Java, so you may not need to install.). Then add [JAVA_HOME] and specify the folder.
e.g.) set JAVA_HOME=C:\Program Files (x86)\Java\jdk1.7.0_65

4. Run the command below.

> asdk

5. If the below appears, that means an installation of Astah Plug-in SDK is completed.

> astah* Plug-in SDK version: 1.5

6. Open %ASDK_HOME%¥conf¥settings.xml with a text editor.
In this .xml file, there are several pre-set profiles for Astah’s each edition and OS.
By default, this is set for Astah Professional on Windows. So you need to change this to Astah SysML and the OS you are using.

Setting XMI in Astah SysML


So please make sure to choose the profile for Astah SysML and your OS and make others commented out.
Also, after you choose the profile, please double-check that the file path to Astah app and edition are correct in the following three properties:

  • <file> – <exists>
  • <properties> – <astahPath>
  • <properties> – <astahEdition>
Setting XMI in Astah SysML

Now, run the command below to make sure Astah launches on the SDK.:

> astah-launch
section divider

If the error happens…

If you get one of the following errors, please try the workaround noted here.

Return code is: 501, ReasonPhrase:HTTPS Required
or
Could not transfer artifact xxx from/to central