Unify and manage your data

Installing the Reltio Workflow Adapter

Learn how to install and start the Reltio Workflow Adapter locally so that you can test workflows in a self contained environment.

  1. Use the following links from Reltio Maven repository, download Workflow JAR file by Workflow JAR File.
    where {{version}} is the release version.
    Note: Use the latest available version as mentioned in the about dialog box in Hub.

    For example: web-2024.2.7.0.jar

    Use these credentials to download the file:
    
    username = read.only.workflow
    password = pbBmG3jbdYUazoj7
    

  2. Copy it to C:/Reltio/workflow directory.
  3. Open a Command Prompt window
  4. Run the command as follows:
    %JAVA_HOME%\bin\java” 
             -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005
            -Dfile.encoding=UTF-8
            -Dspring.config.additional-location=classpath:/application.properties 
            -DFS_DIR=C:/Reltio/workflow/ -DWORKFLOW_CONFIG_NAME=app.properties -jar 
             C:/Reltio/workflow/web-2021.2.0.0.jar
            

    where:

    1. Configuration file:

      app.properties

    2. Location of app.properties file:

      C:/Reltio/workflow

    3. Downloaded JAR file:

      C:/Reltio/workflow/web-2021.2.0.0.jar

  5. In the browser, verify the status of the Workflow Adapter: Workflow Adapter Status.
    {"memory":{"JVM_heap_size":1663041536,"Memory_used":740966144,"Max_memory":4735369216},"status":"OK"}
    Important: The POST /_generateFromQuery API is NOT supported in local deployments of the Workflow Adapter. For more information, see Start Processes From a Search Query.

The app.properties file is displayed as follows:


##Reltio configs
reltio.auth.server.url=https://auth.reltio.com
reltio.auth.client.id={{reltio auth client id}}
reltio.auth.client.secret={{reltio auth client secret}}

#URL to the Reltio notification service to send emails for task creation, reassignment, or similar workflow events
reltio.notification.url=https://notification.reltio.com

#DB configs
db.driverClassName=com.mysql.jdbc.Driver
db.url=jdbc:mysql://localhost:3306/custom_workflow
db.username=custom_workflow
db.password=custom_workflow

#GBQ configs
gbq.on=false

#Jars
custom.jar.location=C:/Reltio/jars

# Other
stacktrace.enabled=true

##Logging
SYSOUT_LOG_TARGET=sysout
DISTRIBUTED_LOG_LEVEL=DEBUG
DISTRIBUTED_LOG_SERVICE=workflow-adapter
DISTRIBUTED_LOG_DISABLE_LOCAL_LOGGING=false