Skip to content

Latest commit

 

History

History

sag-db-oracle

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
README.md
README.md
 
 
docker-compose.yml
docker-compose.yml
 
 
template.yaml
template.yaml
 
 
test.sh
test.sh
 
 

README.md

Creating webMethods database on Oracle

With this template you can create user, database, and webMethods database schemas on Oracle. By default, the template installs the Database Component Configurator and the database scripts for all products, and it creates database schemas for all database components.

If you do not require to install database schemas for all products, remove the database scripts and the respective database components for the unrequired products. The following table maps the products to their database scripts, database component lists, and database actions for creating schemas:

Product Database Script Database Component List Database Action for Creating Schemas
webMethods Optimize OBEcdc db.OBE.components schemas.OBE
webMethods Business Rules WOKcdc db.WOK.components schemas.WOK
webMethods Trading Networks TNScdc db.TNS.components schemas.TNS
My webMethods Server MWScdc db.MWS.components schemas.MWS
webMethods B2B Cloud B2BcloudCdc db.B2Bcloud.components schemas.B2Bcloud
webMethods Active Transfer MATcdc db.MAT.components schemas.MAT
webMethods OneData ODEcdc db.ODE.components schemas.ODE
webMethods Integration Server and webMethods Microservices Runtime PIEcdc db.PIE.components schemas.PIE
Integration Server PIEEmbeddedCdc Not available (N/A) N/A
Integration Server and Mobile Support PIEMobileCdc db.PIEMobile.components schemas.PIEMobile
webMethods Monitor WMNcdc db.WMN.components schemas.WMN
webMethods Process Engine WPEcdc db.WPE.components schemas.WPE
webMethods CloudStreams Server WSTcdc db.WST.components schemas.WST
webMethods API Gateway YAIcdc db.YAI.components schemas.YAI

For example, to remove the database scripts and database components for webMethods Optimize:

  1. Replace the database component list for Optimize with an empty list by replacing the following lines from the template:
 db.OBE.components: 
      - Analysis
      - ProcessTracker
      - DataPurge
      - DatabaseManagement
      - OperationManagement
      - ProcessAudit

With:

db.OBE.components: []

NOTE: The database action for creating schemas for Optimizie will not be executed when the database component list is empty.

  1. Remove the database script for Optimize by removing OBEcdc under db.product.scripts:

Requirements

None.

Supported Software AG releases

  • Command Central 10.5 and higher
  • Database Component Configurator 10.5 and higher
  • webMethods database schemas for products version 10.5 and higher

Supported platforms

  • All supported Windows and UNIX platforms
  • All supported versions of Oracle database
  • Docker Engine 17.09 and higher

Running as a standalone Composite Template

To install Database Component Configurator 10.5 on the Command Central node with alias local, create a database named webm and a database user named webm with password webm, and create all database components schemas with with user system and password oracle:

sagcc exec templates composite apply sag-db-oracle \
  db.version=10.5 repo.product=products-10.5 repo.fix=fixes-10.5 nodes=local \
  db.host=oracle db.admin.username=system db.admin.password=oracle \
  db.name=webm db.username=webm db.password=webm \
  --sync-job --wait 360

To install Database Component Configurator 10.5 on the Command Central node with alias local, create a database named webm and a database user named webm with password webm, and create all database components schemas without API Gateway with user system and password oracle:

sagcc exec templates composite apply sag-db-oracle \
  db.version=latest repo.product=products-10.5 repo.fix=fixes-10.5 nodes=local \
  db.host=mysql  db.admin.username=system db.admin.password=oracle \
  db.name=webm db.username=webm db.password=webm \
  db.YAI.components=[] \
  db.product.scripts=[DatabaseComponentConfigurator,OBEcdc,WOKcdc,TNScdc,MWScdc,B2BCloudCdc,MATcdc,ODEcdc,PIEcdc, \             
  PIEEmbeddedCdc,PIEMobileCdc,WMNcdc,WPEcdc,WSTcdc] \
  --sync-job --wait 360

Using for local development and testing on Docker platforms

  1. Launch the Command Central container from the root folder of the following project:
docker-compose up -d cc
  1. Launch the Oracle Database Express Edition 11g Release 2 container:
docker-compose -f templates/sag-db-oracle/docker-compose.yml up -d oracle
  1. Provision sag-db-oracle template to create a user, storage, and database components:
CC_ENV=oracle ./provisionw sag-db-oracle

If the test is successful, the test output contains TEST SUCCESSFUL.

You can now use this database for creating instances of webMethods products (for example, Integration Server and My webMethods Server) with the following database connection properties:

db.url=jdbc:wm:oracle://oracle:1521;SID=XE
db.username=webm
db.password=webm
db.type=oracle

The properties are pre-set in environments/oracle/env.properties file and you can use them by pointing to the environment name, for example:

CC_ENV=oracle ./provisionw sag-optimize-analysis