{"type":"doc","content":[{"type":"paragraph","content":[{"text":"For testing we use a sample topology that comprising the following components:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"WebLogic AdminServer, running camunda, the taskana parse listener, taskListener and outbox rest API, using an Oracle Database","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Wildfly 12.0 server, running Taskana, the Taskana REST Api and workplace (module taskana-rest-spring-example-wildfly) plus the adapter (module taskana-adapter-camunda-wildfly-example)","type":"text"}]}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"drawio","parameters":{"macroParams":{"contentId":{"value":"1005191383"},"simple":{"value":"0"},"zoom":{"value":"1"},"inComment":{"value":"0"},"pageId":{"value":"1005191218"},"diagramDisplayName":{"value":"AdapterSampleTopology.drawio"},"lbox":{"value":"1"},"contentVer":{"value":"2"},"revision":{"value":"2"},"baseUrl":{"value":"https://taskana.atlassian.net/wiki"},"diagramName":{"value":"Untitled Diagram.drawio"},"width":{"value":"751"},"links":{"value":""},"tbstyle":{"value":""},"height":{"value":"404"}},"macroMetadata":{"macroId":{"value":"0bf4dfae-fdc6-4fe6-808f-d77c6ab17d15"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"https://ac.draw.io/connectImage?contentId=1005191383&simple=0&zoom=1&inComment=0&pageId=1005191218&diagramDisplayName=AdapterSampleTopology.drawio&lbox=1&contentVer=2&revision=2&baseUrl=https%3A%2F%2Ftaskana.atlassian.net%2Fwiki&diagramName=Untitled+Diagram.drawio&width=751&links=&tbstyle=&height=404"}}],"title":"draw.io Diagram"}}}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Preparation of WebLogic and the Oracle Database. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Please read the description completely before beginning with configuration / installation","type":"text"}]},{"type":"paragraph","content":[{"text":"Oracle is set up in such a way that Camunda and TaskanaTaskListener / Taskana Outbox Rest use the same database but a different schema. Camunda uses schema ‘camunda’ while the Taskana components use schema taskana_tables. In our tests, we configured taskana TaskListener and Outbox Rest Api to use the camunda datasource for access to the database. For the Outbox Rest Api you might want to use a different datasource. You can do this, but this step is not described here.","type":"text"}]},{"type":"paragraph","content":[{"text":"Set up comprises the following tasks.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install WebLogic and configure a WebLogic domain with an AdminServer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Prepare oracle database and deploy camunda to the WebLogic AdminServer as described in ","type":"text"},{"text":"https://docs.camunda.org/manual/7.7/installation/full/wls/manual/","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.camunda.org/manual/7.7/installation/full/wls/manual/"}}]},{"text":" . This involves creation of schema camunda and the camunda tables as well as the dataSource for camunda.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a new schema for the outbox tables:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log into SQL Plus (sys as sysdba) and create user TASKANA_TABLES for the outbox schema","type":"text"}]},{"type":"codeBlock","content":[{"text":"> ALTER SESSION SET \"_ORACLE_SCRIPT\"= TRUE;\n> Create USER TASKANA_TABLES identified by ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log into SQLPlus as user taskana_tables","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create schema taskana_tables via taskana-outbox-schema-oracle.sql script from the sql directory of taskana-adapter-camunda-listener-.jar. Before running the script, change ","type":"text"},{"type":"hardBreak"},{"text":"%schemaName% --> TASKANA_TABLES","type":"text"},{"type":"hardBreak"},{"text":"%camundaSchemaName% --> CAMUNDA","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"grant rights to camunda","type":"text"}]},{"type":"codeBlock","content":[{"text":" GRANT INSERT,UPDATE,SELECT,DELETE ON TASKANA_TABLES.OUTBOX_SCHEMA_VERSION to camunda;\n GRANT INSERT,UPDATE,SELECT,DELETE ON TASKANA_TABLES.EVENT_STORE to camunda;\n GRANT CONNECT, RESOURCE TO camunda","type":"text"}]}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable Taskana ParseListener and TaskListener:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"copy taskana-adapter-camunda-listener-.jar to /lib","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"copy slf4j-api-1.7.30.jar and slf4j-simple-1.7.30.jar to /lib to enable log entries from the taskana components.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"find camunda-oracle-weblogic-service.jar in the subtree below . We found it at \\servers\\AdminServer\\tmp_WL_user\\camunda-bpm-platform\\o3p2c6.","type":"text"},{"type":"hardBreak"},{"text":"Edit this jar file, navigate to META-INF and modify META-INF/bpm-platform.xml","type":"text"},{"type":"hardBreak"},{"text":"Add the taskana engine plugin:","type":"text"},{"type":"hardBreak"},{"text":"","type":"text"},{"type":"hardBreak"},{"text":"pro.taskana.adapter.camunda.parselistener.TaskanaParseListenerProcessEnginePlugin","type":"text"},{"type":"hardBreak"},{"text":"","type":"text"},{"type":"hardBreak"},{"text":"in the plugins section.","type":"text"},{"type":"hardBreak"},{"text":"You might prefer to modify bpm-platform.xml in the downloaded Camunda distribution for WebLogic. In this distribution, you find bpm-platform.xml in the \"modules\\camunda-oracle-weblogic-ear-$VERSION.ear\\camunda-oracle-weblogic-service.jar\\META-INF\" folder. If you modify bpm-platform.xml in this location, you must do it before you install camunda to WebLogic.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Supply an external common property file for the ParseListener, TaskListener and the outbox REST api:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create 'properties - directory', e.g. /taskanaconfig","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"modify /bin/setDomainEnv.cmd. 'Un-comment' the line that sets the PATCH_CLASSPATH and edit it so that it points to the fully qualified pathname of the 'properties - direcotory'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Place taskana-outbox.properties into the 'properties - directory'. This property file must contain the properties","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"taskana.adapter.outbox.schema","type":"text","marks":[{"type":"strong"}]},{"text":" (taskana-tables, the schema name of the outbox tables),","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"taskana.adapter.outbox.datasource.jndi","type":"text","marks":[{"type":"strong"}]},{"text":" (the jndi name of the datasource that can be used to access the outbox tables. You can use camunda's datasource or define an own one).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"and it should contain the property","type":"text"},{"text":" taskana.adapter.create_outbox_schema=false","type":"text","marks":[{"type":"strong"}]},{"text":", since this schema was created manually","type":"text"}]}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start WebLogic and install taskana-adapter-camunda-outbox-rest-.war via the WebLogic admin console","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"hardBreak"},{"text":"Preparation of JBoss / Wildfly for taskana / taskana-adapter with postgres database","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"configure postgres database and datasource as described in ","type":"text"},{"text":"https://taskana.atlassian.net/wiki/spaces/TAS/pages/887226440/Preliminary+Use+PostgreSQL+as+a+Datasource+for+Camunda+BPM","type":"text","marks":[{"type":"link","attrs":{"href":"https://taskana.atlassian.net/wiki/spaces/TAS/pages/887226440/Preliminary+Use+PostgreSQL+as+a+Datasource+for+Camunda+BPM"}}]},{"type":"hardBreak"},{"text":"For the configuration of the datasource, you can also use the /bin/jboss-cli shell script. To do this, you start the wildfly / JBoss server and then invoke jboss-cli in the /bin directory.","type":"text"},{"type":"hardBreak"},{"text":"Use the following commands with the JBoss-cli command prompt (before doing this, you have to place postgresql-42.2.5.jar into the /Driver/ directory):","type":"text"}]},{"type":"codeBlock","content":[{"text":"]connect\n]module add --name=org.postgres --resources=/Driver/postgresql-42.2.5.jar --dependencies=javax.api,javax.transaction.api\n]/subsystem=datasources/jdbc-driver=postgres:add(driver-name=\"postgres\",driver-module-name=\"org.postgres\",driver-class-name=org.postgresql.Driver)\n]/subsystem=datasources/data-source=TaskanaDS/:add(connection-url=jdbc:postgresql://localhost:5432/postgres,driver-name=postgres,jndi-name=java:/TaskanaDS, initial-pool-size=4,max-pool-size=64,min-pool-size=4,password=postgres,user-name=postgres)]exit","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"enable elytron security","type":"text"}]},{"type":"codeBlock","content":[{"text":"/jboss-cli.sh --file=/docs/examples/enable-elytron.cli","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create user admin via /bin/add-user shell script","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"provide a TaskRoutingProvider as described in ","type":"text"},{"text":"https://taskana.atlassian.net/wiki/spaces/TAS/pages/995524621/TaskRouting+Service+Provider+Interface","type":"text","marks":[{"type":"link","attrs":{"href":"https://taskana.atlassian.net/wiki/spaces/TAS/pages/995524621/TaskRouting+Service+Provider+Interface"}}]},{"type":"hardBreak"},{"text":"Place this TaskRoutingProvider into the taskana-rest-spring-example-wildfly-.war file below directory WEB-INF/classes.","type":"text"},{"type":"hardBreak"},{"text":"In addition, a pro.taskana.spi.routing.api.TaskRoutingProvider control file that lives in a subdirectory META-INF/services of the classpath is required in order to register the SPI implementation.","type":"text"},{"type":"hardBreak"},{"text":"Place this file into the WEB-INF/classes/META-INF/services directory.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create an application.properties file in /bin/config directory. Specify the following properties:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"taskana-system-connector-camundaSystemURLs= | ","type":"text"},{"type":"hardBreak"},{"text":"In the reference setup, this is:","type":"text"},{"type":"hardBreak"},{"text":"taskana-system-connector-camundaSystemURLs=","type":"text"},{"text":"http://localhost:7001/engine-rest","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:7001/engine-rest"}}]},{"text":" | ","type":"text"},{"text":"http://localhost:7001","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:7001"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"taskana.schemaName=TASKANA","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"taskana.datasource.jndi-name=java:/TaskanaDS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"spring.main.allow-bean-definition-overriding=true (this property is required)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In addition, all properties of the application.properties files of the taskana-rest-spring-example-wildfly as well as the taskana-adapter-camunda-wildfly-example projects can be specified.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Deploy taskana-rest-spring-example-wildfly-.war (copy to deploy directory)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Deploy taskana-adapter-camunda-wildfly-example-0.9.2-SNAPSHOT.war (copy to deploy directory)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start JBoss / wildfly","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Have fun. You can now direct your browser to camunda via http://localhost:7001/camunda or to the taskana workplace via http://localhost:8080/taskana.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"}]}]},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

Browser not supported