Import and export data integration properties

Import data integration properties

Security best practices
You must never upload untrusted files to your installation. Make sure to have every file scanned by an anti-malware software before it can be used in the product.

You import properties to update the values assigned to them in a deployment. On a primary/replica cluster, you import the properties to the primary node.

You can import data integration properties from the user interface or via a Java Management Extensions (JMX) client.

Ensure your properties are already defined in Axway Decision Insight (DI). Importing data integration properties from a file can only update existing properties, not create new ones.

If the file you are importing contains data integration properties that do not exist or that you are not allowed to edit, they will be ignored by the import process.

Import data integration properties from the user interface

This procedure assumes that you already have an available properties file for import, that is that you or someone in your organization already exported one. For information about how to export a properties file, see Export data integration properties.

Step Action
1

On the main menu, click the Configuration   icon. On the left menu, click Application in the Administration section. 
2

Click the Import button.  
3

Click the Select link under Properties file.
4

Browse for where your properties file is located.

The properties file name must end with .properties.xml
5

If the file you selected contains password properties, you must enter the passphrase used when the file was exported. Otherwise, skip this step.
6

Click the Import button.

Import data integration properties via JMX

To import data integration properties via JMX, follow these steps.

Step Action
1

Use a JMX client such as jconsole and connect to DI.
2

In the MBeans tree, open the node com.systar.aluminium.editor.impl.property.ImportExportPropertiesCommandsMXBean.
3

You can then invoke the importProperties operation. The operation is self-documented in JMX.

Importing properties from the Linux shell

The JMX REST Jolokia Connector accessed from the curl command line tool offer a simple way to trigger the import of a property file from a Linux console. For example: 

curl -u "admin:[admin_password]" -H "Content-Type: application/json" http://[node_url]/rest/jmx/ -X POST -d '{
"type":"exec",
"mbean":"com.systar:type=com.systar.aluminium.editor.impl.property.ImportExportPropertiesCommandsMXBean,name=aluminium.importExportProperties",
"operation":"importProperties(java.lang.String,java.lang.String)",
"arguments":["[property_file_path]","[password (optional)]"]
}'

Export data integration properties

You export data integration properties to import them to another deployment.

You can export data integration properties from the user interface or via a Java Management Extensions (JMX) client.

The properties must be exported in a file with a .properties.xml suffix.

Export an application from the user interface

To export an application from the user interface, follow these steps.

Step Action
1

On the main menu, click the Configuration    icon. On the left menu, click  Application in the Administration section. 
2

Click the Export button.  
3

Select the spaces you want to export properties from.

and click the Export button.
4

If you select any space containing password properties under Space from which to export properties, you must provide a Passphrase to be used for encrypting said space. Enter the same value in the Confirmation text box.
5

Click the Export button.

Export an application via JMX

To export an application with data integration properties via JMX, follow these steps.

Step Action
1

Use a JMX client such as jconsole and connect to DI.
2

In the MBeans tree, open the node com.systar.aluminium.editor.impl.property.ImportExportPropertiesCommandsMXBean
3

You can then invoke the operation exportApplicationProperties.

The operation is self-documented in JMX.

To get the correct values for spacesNames, you can use the application JMX export operations documented under Import and export an application

Related Links