Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

BXMSDOC-3331 added ddl script steps #196

Merged
merged 4 commits into from
Aug 16, 2019
Merged

BXMSDOC-3331 added ddl script steps #196

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
f0dd217
BXMSDOC-3331 added ddl script steps
emmurphy1 Aug 15, 2019
75437b5
BXMSDOC-3331 added x to file versions
emmurphy1 Aug 16, 2019
ba4cc6b
BXMSDOC-3331 corrected migration file name
emmurphy1 Aug 16, 2019
d972473
BXMSDOC-3331 updated with peer review comments
emmurphy1 Aug 16, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
4 changes: 2 additions & 2 deletions doc-content/enterprise-only/admin-and-config/maven-settings-configuration-ref.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,9 @@ For information about the Maven `settings.xml` file, see the Apache Maven Projec
ifeval::["{context}" == "install-on-jws"]
On {JWS}, for {KIE_SERVER} add `-Dkie.maven.settings.custom=<SETTINGS_FILE_PATH>` to the `CATALINA_OPTS` section of the `setenv.sh` (Linux) or `setenv.bat` (Windows) file. For standalone {CENTRAL}, enter the following command:
+
[source]
[source,subs="attributes+"]
----
java -jar rhpam-7.4.0-business-central-standalone.jar -s application-config.yaml -Dkie.maven.settings.custom=<SETTINGS_FILE_PATH>
java -jar rhpam-{PRODUCT_VERSION_LONG}-business-central-standalone.jar -s application-config.yaml -Dkie.maven.settings.custom=<SETTINGS_FILE_PATH>
----
endif::[]
ifeval::["{context}" == "install-on-tomcat"]
Expand Down
10 changes: 5 additions & 5 deletions doc-content/enterprise-only/installation/eap-data-source-add-proc.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,11 +13,11 @@ For production environments, specify an actual data source. Do not use the examp
* The {PRODUCT} {PRODUCT_VERSION_LONG} Add Ons ({PRODUCT_FILE}-add-ons.zip) file is downloaded from the https://access.redhat.com/jbossnetwork/restricted/listSoftware.html[Software Downloads] page in the Red Hat Customer Portal.

.Procedure
. Prepare your database:
.. Unzip `{PRODUCT_INIT}-{PRODUCT_VERSION}-add-ons.zip` in a temporary directory, for example `TEMP_DIR`.
.. Unzip `TEMP_DIR/{PRODUCT_INIT}-{PRODUCT_VERSION}-migration-tool.zip`.
.. Change directory to the `TEMP_DIR/{PRODUCT_INIT}-{PRODUCT_VERSION}-migration-tool/ddl-scripts` directory. This directory contains DDL scripts for several database types.
.. Import the DDL script for your database into the database that you want to use, for example:
. Complete the following steps to prepare your database:
.. Extract `{PRODUCT_INIT}-{PRODUCT_VERSION}-add-ons.zip` in a temporary directory, for example `TEMP_DIR`.
.. Extract `TEMP_DIR/{PRODUCT_INIT}-{PRODUCT_VERSION}-migration-tool.zip`.
.. Change your current directory to the `TEMP_DIR/{PRODUCT_INIT}-{PRODUCT_VERSION}-migration-tool/ddl-scripts` directory. This directory contains DDL scripts for several database types.
.. Import the DDL script for your database type into the database that you want to use, for example:
+
[source,shell]
----
Expand Down
17 changes: 14 additions & 3 deletions doc-content/enterprise-only/installation/jws-jdbc-config_proc.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ endif::[]
ifeval::["{context}" == "install-on-tomcat"]
* {PRODUCT} is installed on {TOMCAT}.
endif::[]
* The Red Hat Process Automation Manager 7.4.0 Maven Repository (`rhpam-7.4.0-maven-repository.zip`) file has been downloaded, as described in <<install-download-proc_{context}>>.
* The {PRODUCT} {PRODUCT_VERSION}.x Maven Repository (`{PRODUCT_INIT}-{PRODUCT_VERSION}.x-maven-repository.zip`) and the {PRODUCT} {PRODUCT_VERSION}.x Add-Ons (`{PRODUCT_INIT}-{PRODUCT_VERSION}.x-add-ons.zip`) files have been downloaded, as described in <<install-download-proc_{context}>>. In these files, `x` is the latest patch release.
* You want to configure one of the following supported databases and Hibernate dialects:
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Configure One of the following...

instead of "you want to..."

Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This a prereq so we don't use the imperative.

+
** DB2: `org.hibernate.dialect.DB2Dialect`
Expand All @@ -22,8 +22,19 @@ endif::[]
** Sybase: `org.hibernate.dialect.SybaseASE157Dialect`

.Procedure
. Unzip the `rhpam-7.4.0-maven-repository.zip` offline Maven repository file.
. Copy the following libraries from the unzipped offline Maven repository to the
. Complete the following steps to prepare your database:
.. Extract `{PRODUCT_INIT}-{PRODUCT_VERSION}.x-add-ons.zip` in a temporary directory, for example `TEMP_DIR`.
.. Extract `TEMP_DIR/{PRODUCT_INIT}-{PRODUCT_VERSION}-migration-tool.zip`.
.. Change your current directory to the `TEMP_DIR/{PRODUCT_INIT}-{PRODUCT_VERSION}-migration-tool/ddl-scripts` directory. This directory contains DDL scripts for several database types.
.. Import the DDL script for your database type into the database that you want to use, for example:
+
[source,shell]
----
psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql
----

. Extract the `{PRODUCT_INIT}-{PRODUCT_VERSION}-maven-repository.zip` offline Maven repository file.
. Copy the following libraries from the extracted offline Maven repository to the
ifeval::["{context}" == "install-on-jws"]
`JWS_HOME/tomcat/lib`
endif::[]
Expand Down
15 changes: 15 additions & 0 deletions doc-content/enterprise-only/weblogic/wls-data-source-create-proc.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,21 @@ A data source is an object that enables a Java Database Connectivity (JDBC) clie
* The JDBC drivers that you want to use to create database connections are installed on all servers on which you want to deploy the data source. Some JDBC drivers are installed with {WEBLOGIC}, such as WebLogic-branded Data Direct JDBC drivers for DB2, Informix, MS SQL Server, and Sybase. For more information about JDBC drivers, see https://docs.oracle.com/middleware/12213/wls/JDBCA/third_party_drivers.htm#JDBCA231[Using JDBC Drivers with WebLogic Server] in the Oracle Help Center.

.Procedure
. Navigate to the https://access.redhat.com/jbossnetwork/restricted/listSoftware.html[Software Downloads] page in the Red Hat Customer Portal (login required), and select the product and version from the drop-down options:
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Go to the page. See pg 347 in the style guide.

Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point, but this is the format that we use throughout our docs when referring to the CP. I'll take it up with Stetson (his formulation :-))

* *Product:* {PRODUCT_SHORT}
* *Version:* {PRODUCT_VERSION}
. Download *{PRODUCT} {PRODUCT_VERSION}.x Add-Ons*, where *x* is the current patch version.
. Complete the following steps to prepare your database:
.. Extract `{PRODUCT_INIT}-{PRODUCT_VERSION}.x-add-ons.zip` in a temporary directory, for example `TEMP_DIR`.
.. Extract `TEMP_DIR/{PRODUCT_INIT}-{PRODUCT_VERSION}-migration-tool.zip`.
.. Change your current directory to the `TEMP_DIR/{PRODUCT_INIT}-{PRODUCT_VERSION}-migration-tool/ddl-scripts` directory. This directory contains DDL scripts for several database types.
.. Import the DDL script for your database type into the database that you want to use, for example:
+
[source,shell]
----
psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql
----

. In the WebLogic Administration Console, navigate to *Change Center* -> *Lock & Edit*.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why are we using "navigate" so much?

  1. It is an awkward word. You are not asking them to muddle through rush hour.
  2. The style guide clearly states that use a more direct verb unless you are providing specific directions to a location.

Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll talk to Stetson. We use it consistently.

. Under *Domain Structure*, click *Services* -> *Data Sources*.
. On the *Summary of Data Sources* page, click *New* -> *Generic Data Source*.
Expand Down
15 changes: 15 additions & 0 deletions doc-content/enterprise-only/websphere/was-data-source-create-proc.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,21 @@ A data source is an object that enables a Java Database Connectivity (JDBC) clie
* The JDBC providers that you want to use to create database connections are configured on all servers on which you want to deploy the data source. For more information about JDBC providers, see https://www.ibm.com/support/knowledgecenter/en/SSEQTP_9.0.0/com.ibm.websphere.base.doc/ae/tdat_ccrtprov.html[Configuring a JDBC provider] in the IBM Knowledge Center.

.Procedure
. Navigate to the https://access.redhat.com/jbossnetwork/restricted/listSoftware.html[Software Downloads] page in the Red Hat Customer Portal (login required), and select the product and version from the drop-down options:
* *Product:* {PRODUCT_SHORT}
* *Version:* {PRODUCT_VERSION}
. Download *{PRODUCT} {PRODUCT_VERSION}.x Add-Ons*, where *x* is the current patch version.
. Complete the following steps to prepare your database:
.. Extract `{PRODUCT_INIT}-{PRODUCT_VERSION}.x-add-ons.zip` in a temporary directory, for example `TEMP_DIR`.
.. Extract `TEMP_DIR/{PRODUCT_INIT}-{PRODUCT_VERSION}-migration-tool.zip`.
.. Change your current directory to the `TEMP_DIR/{PRODUCT_INIT}-{PRODUCT_VERSION}-migration-tool/ddl-scripts` directory. This directory contains DDL scripts for several database types.
.. Import the DDL script for your database type into the database that you want to use, for example:
+
[source,shell]
----
psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql
----

. In the WebSphere Integrated Solutions Console, navigate to *Resources* -> *JDBC* -> *Data sources*.
. Select the scope at which applications can use the data source. You can choose a cell, node, cluster, or server.
. Click *New* to open the *Create a data source* wizard.
Expand Down