Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 34 additions & 6 deletions migration-tools/tts-backup-python/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,8 +57,10 @@ Open tts-backup-env.txt file downloaded to the project directory and provide the

***PROJECT_NAME*** : (REQUIRED INPUT) Name for transport tablespace project. \
***DATABASE_NAME*** : (REQUIRED INPUT) Database Name containing the tablespaces. \
***TABLESPACES*** : (OPTIONAL INPUT) List of comma separated tablespaces to be transported. Leave empty to transport all user tablespaces. \
***SCHEMAS*** : (OPTIONAL INPUT) List of comma separated schemas to be exported. Leave empty to export all non-common schemas.
***TABLESPACES*** : (OPTIONAL INPUT) List of comma separated tablespaces to be transported. Leave empty to transport all user tablespaces. Cannot be used with EXCLUDE_TABLESPACES. \
***EXCLUDE_TABLESPACES*** : (OPTIONAL INPUT) List of comma separated tablespaces to exclude when TABLESPACES is not provided. Cannot be used with TABLESPACES. \
***SCHEMAS*** : (OPTIONAL INPUT) Comma-separated list of schemas to export. Leave empty to export the discovered local schemas. Cannot be used with EXCLUDE_SCHEMAS. Use plain schema names for normal schema export, and use source:target entries to remap supported common-user objects into a local target schema. Example: USER1,USER2,C##APP:APP_LOCAL \
***EXCLUDE_SCHEMAS*** : (OPTIONAL INPUT) List of comma separated schemas to exclude when SCHEMAS is not provided. Cannot be used with SCHEMAS.

##### Database connection inputs

Expand Down Expand Up @@ -112,7 +114,13 @@ Leave these a blank unless really needed.

***DVREALM_USER*** - (OPTIONAL INPUT) Required only if Database Vault is enabled and configured in the source database. Specify a Database Vault realm owner or authorized user required to access objects protected by Database Vault during the backup process. If not provided and Database Vault is enabled, backup will fail with an error.

***DVREALM_PASSWORD*** - (RUNTIME INPUT) Required only if Database Vault is enabled and configured in the source. Password for the specified DVREALM_USER. If not provided and Database Vault is enabled, backup will fail with an error. Provide as CLI runtime input when prompted. This prompt appears only if DVREALM_USER is provided.
***DVREALM_PASSWORD*** - (RUNTIME INPUT) Required only if Database Vault is enabled and configured in the source. Password for the specified DVREALM_USER. If not provided and Database Vault is enabled, backup will fail with an error. Provide as CLI runtime input when prompted. This prompt appears only if DVREALM_USER is provided

##### Optional tool behavior inputs

***IGNORE_NON_FATAL_ERRORS*** : (OPTIONAL INPUT) Accepted values TRUE/true or FALSE/false. When set to TRUE, logical object validation findings that identify objects not transported are reported but do not stop the backup. If not provided, value defaults to FALSE.

***JDK8_PATH*** : (OPTIONAL INPUT) Path to a JDK 8 installation. Configure this only when the OCI installer fails with the default ORACLE_HOME JDK and the tool needs to retry using JDK 8. Leave empty unless needed.

**Backup Utility Sample Inputs**
```
Expand Down Expand Up @@ -174,6 +182,12 @@ Leave these a blank unless really needed.
TRANSPORT_TABLES_PROTECTED_BY_OLS_POLICIES=FALSE
TRANSPORT_DB_PROTECTED_BY_DATABASE_VAULT=FALSE
DVREALM_USER=

################################################################################
### Optional tool behavior inputs ###
################################################################################
IGNORE_NON_FATAL_ERRORS=FALSE
JDK8_PATH=
```

Run the TTS Backup Tool from the project directory as below. User will be prompted for database password and optional TDE wallet store password.
Expand Down Expand Up @@ -273,8 +287,10 @@ Open tts-backup-env.txt file downloaded to the project directory and provide the

***PROJECT_NAME*** : (REQUIRED INPUT) Name for transport tablespace project. \
***DATABASE_NAME*** : (REQUIRED INPUT) Database Name containing the tablespaces. \
***TABLESPACES*** : (OPTIONAL INPUT) List of comma separated tablespaces to be transported. Leave empty to transport all user tablespaces. \
***SCHEMAS*** : (OPTIONAL INPUT) List of comma separated schemas to be exported. Leave empty to export all non-common schemas.
***TABLESPACES*** : (OPTIONAL INPUT) List of comma separated tablespaces to be transported. Leave empty to transport all user tablespaces. Cannot be used with EXCLUDE_TABLESPACES. \
***EXCLUDE_TABLESPACES*** : (OPTIONAL INPUT) List of comma separated tablespaces to exclude when TABLESPACES is not provided. Cannot be used with TABLESPACES. \
***SCHEMAS*** : (OPTIONAL INPUT) Comma-separated list of schemas to export. Leave empty to export the discovered local schemas. Cannot be used with EXCLUDE_SCHEMAS. Use plain schema names for normal schema export, and use source:target entries to remap supported common-user objects into a local target schema. Example: USER1,USER2,C##APP:APP_LOCAL \
***EXCLUDE_SCHEMAS*** : (OPTIONAL INPUT) List of comma separated schemas to exclude when SCHEMAS is not provided. Cannot be used with SCHEMAS.

##### Database connection inputs

Expand Down Expand Up @@ -320,7 +336,13 @@ Open tts-backup-env.txt file downloaded to the project directory and provide the

***DVREALM_USER*** - (OPTIONAL INPUT) Required only if Database Vault is enabled and configured in the source database. Specify a Database Vault realm owner or authorized user required to access objects protected by Database Vault during the backup process. If not provided and Database Vault is enabled, backup will fail with an error.

***DVREALM_PASSWORD*** - (RUNTIME INPUT) Required only if Database Vault is enabled and configured in the source. Password for the specified DVREALM_USER. If not provided and Database Vault is enabled, backup will fail with an error. Provide as CLI runtime input when prompted. This prompt appears only if DVREALM_USER is provided.
***DVREALM_PASSWORD*** - (RUNTIME INPUT) Required only if Database Vault is enabled and configured in the source. Password for the specified DVREALM_USER. If not provided and Database Vault is enabled, backup will fail with an error. Provide as CLI runtime input when prompted. This prompt appears only if DVREALM_USER is provided

##### Optional tool behavior inputs

***IGNORE_NON_FATAL_ERRORS*** : (OPTIONAL INPUT) Accepted values TRUE/true or FALSE/false. When set to TRUE, logical object validation findings that identify objects not transported are reported but do not stop the backup. If not provided, value defaults to FALSE.

***JDK8_PATH*** : (OPTIONAL INPUT) Path to a JDK 8 installation. Configure this only when the OCI installer fails with the default ORACLE_HOME JDK and the tool needs to retry using JDK 8. Leave empty unless needed.

**Backup Utility Sample Inputs**
```
Expand Down Expand Up @@ -377,6 +399,12 @@ Open tts-backup-env.txt file downloaded to the project directory and provide the
TRANSPORT_TABLES_PROTECTED_BY_OLS_POLICIES=FALSE
TRANSPORT_DB_PROTECTED_BY_DATABASE_VAULT=FALSE
DVREALM_USER=

################################################################################
### Optional tool behavior inputs ###
################################################################################
IGNORE_NON_FATAL_ERRORS=FALSE
JDK8_PATH=
```

Run the TTS Backup Tool from the project directory as below. User will be prompted for database password and optional TDE wallet store password.
Expand Down
10 changes: 8 additions & 2 deletions migration-tools/tts-backup-python/tts-backup-env-sample.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,9 @@
PROJECT_NAME=tts_project
DATABASE_NAME=orclpdb1
TABLESPACES=emptbs,salestbs
SCHEMAS=user1,user2,user3
EXCLUDE_TABLESPACES=
SCHEMAS=user1,user2,user3,c##user1:user4
EXCLUDE_SCHEMAS=


#### Database connection inputs
Expand Down Expand Up @@ -45,4 +47,8 @@ EXCLUDE_STATISTICS=TRUE/FALSE
TRANSPORT_TABLES_PROTECTED_BY_REDACTION_POLICIES=FALSE
TRANSPORT_TABLES_PROTECTED_BY_OLS_POLICIES=FALSE
TRANSPORT_DB_PROTECTED_BY_DATABASE_VAULT=FALSE
DVREALM_USER=
DVREALM_USER=

### Optional tool behavior inputs
IGNORE_NON_FATAL_ERRORS=FALSE
JDK8_PATH=
7 changes: 7 additions & 0 deletions migration-tools/tts-backup-python/tts-backup-env.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,9 @@
PROJECT_NAME=
DATABASE_NAME=
TABLESPACES=
EXCLUDE_TABLESPACES=
SCHEMAS=
EXCLUDE_SCHEMAS=


#### Database connection inputs
Expand Down Expand Up @@ -49,3 +51,8 @@ TRANSPORT_TABLES_PROTECTED_BY_REDACTION_POLICIES=
TRANSPORT_TABLES_PROTECTED_BY_OLS_POLICIES=
TRANSPORT_DB_PROTECTED_BY_DATABASE_VAULT=
DVREALM_USER=


### Optional tool behavior inputs
IGNORE_NON_FATAL_ERRORS=FALSE
JDK8_PATH=
Loading