OracleConfigurator Operator

This page introduces the OracleConfigurator operator, a workflow operator that allows configuring the optimized parameters of an Oracle instance.

Prerequisites

This section provides the minimum requirements that you should meet in order to use the OracleConfigurator operator.

Supported versions

  • Oracle 12c or later

Network requirements

  • The Oracle operator must be able to connect to the Oracle URL or IP address and port (default port: 1521).

Permissions

  • The user used to log into the database must have ALTER SYSTEM privileges.

Supported component types

In order to configure the tuned parameters the Oracle Configurator operator requires to be bound to a component with one of the following types:

  • Oracle Database 12c

  • Oracle Database 18c

  • Oracle Database 19c

Databases hosted on Amazon RDS are not supported.

Configuration options

When you define an OracleExecutor task in the workflow you should specify some configuration information to allow the operator to connect to the Oracle instance.

You can specify configuration information within the config part of the YAML of the instance definition. The operator can also inherit some specific arguments from the properties of a bound component when not specified in the task.

Operator arguments

The following table describes all the properties for the definition of a task using the OracleConfigurator operator.

Field
Type
Description
Default Value
Restrictions
Required
Source

connection.dsn

String

DSN or EasyConnect string

Is possible to define only one of the following sets of configurations:

  • dsn

  • host, service and optionally port

  • host, sid and optionally port

task, component

connection.host

String

Address of the database instance

task, component

connection.port

Integer

listening port of the database instance

1521

task, component

connection.service

String

Database service name

task, component

connection.sid

String

Database SID

task, component

connection.user

String

User name

Yes

task, component

connection.password

String

User password

Yes

task, component

connection.mode

String

Connection mode

sysdba, sysoper

task, component

component

String

Name of the component to fetch properties and parameters from

Yes

task

Examples

Update database entries

In the following example, the workflow leverages the OracleConfigurator operator to update the database parameters before triggering the execution of the load test for a component oracledb:

name: oracledb
componentType: Oracle Database 18c
properties:
  connection:
    user: application
    password: password
    host: oradb.dev.akamas.io
    service: XE
tasks:
- name: update parameters
  operator: OracleConfigurator
  arguments:
    component: oracledb

- name: run load test
  operator: Executor
  arguments:
    command: sh run_test.sh
    component: generator

Last updated