Configure the Designer
Overview
Semarchy xDI Designer does not need additional configuration in most situations. However, you can change its startup settings to meet your needs.
The startup settings are in an INI file:
-
On macOS, the INI file is named
semarchy-xdi-designer.ini
, and is in the/Contents/Eclipse
subdirectory of the application package. -
For Windows, the INI file is named
semarchy-xdi-designer-windows.ini
, and is in the main installation folder. -
For Linux, the INI file is named
semarchy-xdi-designer-linux.ini
, and is in the main installation folder.
The Designer startup INI file is based on the Eclipse IDE startup file
. When making edits, you should follow these best practices:
-
You should experiment with Designer launch parameters from your Command Prompt or Terminal before changing the INI file itself.
-
If a parameter would typically have a space between it and its argument, the argument must be on its own line.
-
Keep a backup of the original file in case of problems.
Memory settings
By default, Designer allows the Java Virtual Machine to manage memory automatically. This is ideal in most cases.
You can use the -Xms
and -Xmx
Java parameters to configure the minimum and maximum amount of memory Designer uses.
# Minimum Heap size
-Xms512m
# Maximum Heap size.
-Xmx2048m
Built-in Runtime location
The Designer built-in Runtime is deployed by default in the Designer installation folder, in a subfolder named runtime
.
To change this location, edit the following property:
# Runtime location
-Dxdi.designer.runtime.home=runtime
Module generation
Module generation is configured with the following properties:
# Generated modules location
# This path is relative to the runtime location. Absolute paths are also supported.
-Dxdi.designer.module.path.v1=runtime/modules
# Automatic modules creation
-Dxdi.designer.module.automaticCreation=true
If you change the module location for Designer, only the built-in Designer runtime is aware of this new location. A standalone xDI Runtime installation needs to be configured to use the same modules directory. Refer to the Runtime installation and configuration guide to learn how to add the relevant options for that software.
License configuration
You can preconfigure license management for a xDI Designer instance by setting the following environement variables prior to starting the Designer.
-
XDI_DESIGNER_LICENSE_KEY
: Set this variable to define your License Key string. When this variable is set, the Online mode is used by default. The Local Server mode is used instead ifXDI_DESIGNER_LICENSE_SERVER_URL
is set. -
XDI_DESIGNER_LICENSE_SERVER_URL
: Set this variable to define your local license server URL, and use the Local Server mode. -
XDI_DESIGNER_LICENSE_KEY_FILE
: Set this variable to define your License Key File location and use the Offline mode. This variable is taken into account only ifXDI_DESIGNER_LICENSE_KEY
is unset.
License Server certificates
Semarchy xDI Designer validates its license from a license server. This may be either the main Semarchy license server, or a local license server you install yourself. In both cases, xDI Designer communicates with the license server over an HTTP connection secured with SSL/TLS.
If you have a local license server, you need to configure it to use SSL/TLS, and specify a certificate.
If you use a certificate issued by a trusted certificate authority, Designer should connect without needing to make other changes.
Self-signed certificates
Using self-signed certificates requires you to disable a Java security setting. When possible, you should use a certificate issued by a trusted authority instead. |
With a self-signed certificate, you must configure xDI Designer to recognize this certificate. Otherwise, Designer refuses the connection.
First, add the self-signed certificate to xDI Designer. You can do this in one of two ways:
-
Give Designer access to a custom keystore that holds your certificate.
Add your certificate to a Java Keystore, then add parameters to the Designer startup settings file to define the keystore information:
-Dxdi.designer.license.server.keystore.path=<Path to keystore file location> -Dxdi.designer.license.server.keystore.type=<keystore type> -Dxdi.designer.license.server.keystore.password=<security password> -Dxdi.designer.license.server.keystore.key.alias=<keystore alias>
-
Add the certificate to the Java Virtual Machine (JVM) truststore directly, which allows any application using the JVM to access to the certificate.
If the JVM truststore is in a custom location, add the certificate to this location, then add parameters to the Designer startup settings file to define the certificate information:
-Djavax.net.ssl.trustStore=<Path to truststore location> -Djavax.net.ssl.trustStoreType=<truststore type> -Djavax.net.ssl.trustStoreProvider=<provider> -Djavax.net.ssl.trustStorePassword=<truststore password>
Second, configure Designer to disable strict hostname verification in Java:
-
Navigate to the
configuration
subdirectory of the application package or installation directory. -
Open the
config.ini
file in a text editor. -
Find the line containing
xdi.designer.license.server.certificate.hostname.verification=true
. -
Change
true
tofalse
. -
Save the file.
Your self-signed certificate should be recognized by Designer.