01 - Dbvisit Replicate Setup Wizard
Logical replication using Dbvisit Replicate is configured using a setup wizard. The setup wizard does not make any database changes, instead it creates a set of configuration scripts that can be inspected before executing to give full visibility of database changes.
If any mistakes are made, then the wizard can be cancelled by typing ctrl-c, and then restarted. The setup wizard will remember previous information entered.
This configuration will take about 15 minutes.
Please ensure the following Pre-requisites checks have been tested. Otherwise the replication will not function.
Starting the dbvrep setup wizard
The following is a step-by-step guide of configuring a replication using the setup wizard. To accept the default answer for a question, just press the Return key.
1. On the source server, as oracle, in the $HOME directory, execute the dbvrep executable to start Dbvisit Replicate.
dbvrep
The output will be:
Initializing......done Dbvisit Replicate version 2.7 Copyright (C) Dbvisit Software Limited. All rights reserved. No DDC file loaded. Run "setup wizard" to start the configuration wizard or try "help" to see all commands available. dbvrep>
3. Start the setup wizard and accept the end-user license agreement.
dbvrep> setup wizard This wizard configures Dbvisit Replicate. The setup wizard creates configuration scripts, which need to be run after the wizard ends. No changes to the databases are made before that. The progress is saved every time a list of databases, replications, etc. is shown. It will be re-read if wizard is restarted and the same DDC name and script path is selected. Run the wizard now? [yes] yes Accept end-user license agreement? (view/yes/no) [view] yes
3. Follow the steps and give the name of the replication. Name it dbvrep_XE.
Before starting the actual configuration, some basic information is needed. The DDC name and script path determines where all files created by the wizard go (and where to reread them if wizard is rerun) and the license key determines which options are available for this configuration. (DDC_NAME) - Please enter a name for this replication (suggestion: use the name of the source database): [] dbvrep_XE
4. Use the trial license key included with Dbvisit Replicate and select the MAX edition of the product.
(LICENSE_KEY) - Please enter your license key: [(trial)] Which Replicate edition do you want to trial (LTD/XTD/MAX): [MAX]
Enter the location of the directory where the Setup Wizard will place the configuration files. Accept the default value.
(SETUP_SCRIPT_PATH) - Please enter a directory for location of configuration scripts on this machine: [/u01/app/oracle/dbvrep_XE]
Enter the location where Dbvisit Replicate will find the Oracle network configuration files. Accept the default value.
Network configuration files were detected on this system in these locations: [/u01/app/oracle/product/11.2.0/xe/network/admin] (TNS_ADMIN) - Please enter TNS configuration directory for this machine: [/u01/app/oracle/product/11.2.0/xe/network/admin]
Step 1 - Describe databases
Describe the first database. This will be the source database and will be the Oracle database on the machine called source.
The SYSDBA and DBA passwords (normally SYS and SYSTEM) are only used during the configuration and are not used or stored as part of a running replication.
Step 1 - Describe databases ======================================== The first step is to describe databases used in the replication. There are usually two of them (source and target). Store SYSDBA and DBA passwords? Passwords only required during setup and initialization? (yes/no) [yes]
Specify the default database which is Oracle.
Let's configure the database, describing it's type, connectivity, user names etc. What type of database is this? (Oracle/MySQL/SQL Server/Oracle AWS RDS/CSV/Hadoop): [Oracle]
6. The TNS alias for the source database is ttorcl_src
Please enter database TNS alias: [] ttorcl_src
Enter the username and password of a user with SYSDBA. Accept the default of SYS and change_on_install.
Please enter SYSDBA user name: [SYS] Please enter password for this user: [change_on_install]
Enter the username and password of a user with the DBA role. Accept the default of SYSTEM and manager.
Please enter user with DBA role: [SYSTEM] Please enter password for this user: [manager]
7. Specify the defaults to create the Dbvisit Replicate Schema in the source database. Accept the default username of dbvrep and the default password of dbvpasswd.
Connecting to database ttorcl_src as SYSTEM to query list of tablespaces and to detect ASM (by looking whether any redo logs or archived logs are stored in ASM). Enter the Dbvisit Replicate owner (this user will be created by this script): [dbvrep] Please enter password for this user: [dbvpasswd]
Specify the USERS tablespace as the default tablespace for the Dbvisit Replicate Schema (dbvrep) user.
Permanent tablespaces detected on the database: REPOE_DATA, USERS. Please enter default permanent tablespace for this user: [REPOE_DATA] USERS
Specify the TEMP tablespace as the temporary tablespace for the Dbvisit Replicate Schema (dbvrep) user.
Temporary tablespaces detected on the database: TEMP. Please enter default temporary tablespace for this user: [TEMP]
The first database is now configured. Add the next database. This will be the target database and will be the Oracle database on the machine called target.
Following databases are now configured: 1: Oracle ttorcl_src, SYS/***, SYSTEM/***, dbvrep/***, USERS/TEMP, dbvrep/, ASM:NO, TZ: +00:00
8. Add the next database. This will be the target database. It is also an Oracle database.
Enter the number of the database to modify it, or "add", or "done": [add]
Specify the default database which is Oracle.
Let's configure the database, describing it's type, connectivity, user names etc. What type of database is this? (Oracle/MySQL/SQL Server/Oracle AWS RDS/CSV/Hadoop): [Oracle]
9. The TNS alias is ttorcl_trg.
Please enter database TNS alias: [] ttorcl_trg
Enter the username and password of a user with SYSDBA. Accept the default of SYS and change_on_install.
Please enter SYSDBA user name: [SYS] Please enter password for this user: [change_on_install]
Enter the username and password of a user with the DBA role. Accept the default of SYSTEM and manager.
Please enter user with DBA role: [SYSTEM] Please enter password for this user: [manager]
Specify the defaults to create the Dbvisit Replicate Schema in the target database. Accept the default username of dbvrep and the default password of dbvpasswd.
Connecting to database ttorcl_trg as SYSTEM to query list of tablespaces and to detect ASM (by looking whether any redo logs or archived logs are stored in ASM). Enter the Dbvisit Replicate owner (this user will be created by this script): [dbvrep] Please enter password for this user: [dbvpasswd]
Specify the USERS tablespace as the default tablespace for the Dbvisit Replicate Schema (dbvrep) user.
Permanent tablespaces detected on the database: REPOE_DATA, USERS. Please enter default permanent tablespace for this user: [REPOE_DATA] USERS
Specify the TEMP tablespace as the temporary tablespace for the Dbvisit Replicate Schema (dbvrep) user.
Temporary tablespaces detected on the database: TEMP. Please enter default temporary tablespace for this user: [TEMP]
11. Both source and target database have now been defined.
Following databases are now configured: 1: Oracle ttorcl_src, SYS/***, SYSTEM/***, dbvrep/***, USERS/TEMP, dbvrep/, ASM:NO, TZ: +00:00 2: Oracle ttorcl_trg, SYS/***, SYSTEM/***, dbvrep/***, USERS/TEMP, dbvrep/, ASM:NO, TZ: +00:00 Enter the number of the database to modify it, or "add", or "done": [done]
Step 2 - Replication Pairs
12. Set source and targets for each replication pair. Select 1 as the source database (default) and 2 as the target database.
Step 2 - Replication pairs ======================================== The second step is to set source and targets for each replication pair. Let's configure the replication pair, selecting source and target. Following databases are described: 1: ttorcl_src (Oracle) 2: ttorcl_trg (Oracle) Select source database: [1] Select target database: [2]
13. Select the default values for the following configuration entries.
Will be DDL replication enabled? [yes] Use fetcher to offload the mining to a different server? (yes/no) [no] Would you like to encrypt the data across the network (yes or no) [no] Would you like to compress the data across the network (yes or no) [no] How long do you want to set the network timeouts. Recommended range between 60-300 seconds [60]
14. Define the method to use to lock and copy the data initially to ensure the data is in sync before the replication starts. Use the single-scn method (default).
Lock and copy the data initially one-by-one or at a single SCN? one-by-one : Lock tables one by one and capture SCN single-scn : One SCN for all tables ddl-only : Only DDL script for target objects resetlogs : Use SCN from last resetlogs operation (standby activation, rman incomplete recovery) (one-by-one/single-scn/ddl-only/resetlogs) [single-scn]
15. Define what data instantiation script to create? This method copies the initial data set to ensure the data is in sync before the replication starts. Use dp_networklink which is the DataPump method over a database network link (DB_LINK) (default).
What data instantiation script to create? dp_networklink : Data Pump with network link. No export datafile is created (APPLY.sh) dp_exp : Data Pump with export datafile. Creates an export datafile (APPLY.sh) exp : Pre-datapump exp/imp with export datafile (APPLY.sh) ddl_file : DDL file created (APPLY.sql) ddl_run : DDL is automatically executed on target load : All replicated data is created and loaded automatically none (dp_networklink/dp_exp/exp/ddl_file/ddl_run/load/none) [dp_networklink]
16. The replication pair is now configured.
Following replication pairs are now configured: 1: ttorcl_src (Oracle) ==> ttorcl_trg (Oracle), DDL: yes, fetcher: no, process suffix: (no suffix), compression: no, encryption: no, network timeout: 60, prepare type: single-scn, data load: dp_networklink Enter number of replication pair to modify it, or "add", or "done": [done]
Step 3 - Replicated Tables
17 Add the schemas or tables to be replicated.
Step 3 - Replicated tables ======================================== The third step is to choose the schemas and tables to be replicated. If the databases are reachable, the tables are checked for existence, datatype support, etc., schemas are queried for tables. Note that all messages are merely hints/warnings and may be ignored if issues are rectified before the scripts are actually executed. Following tables are defined for replication pairs: 1: ttorcl_src (Oracle) ==> ttorcl_trg (Oracle), DDL: yes, suffix: (no suffix), prepare: single-scn No tables defined. Enter number of replication pair to modify it, or "done": [1]
18. Specify the REPOE schema is to be replicated.
Please enter list of all individual tables to be replicated. Enter schema name(s) only to replicate all tables in that schema. Use comma or space to delimit the entries. Enter the tables and schemas: [] repoe Selected schemas: REPOE
We do not need to add more tables, so select NO (default).
Add more tables or schemas? (YES/NO) [NO]
19. We are not replicating PL/SQL. Press Return to skip this option.
To replicate changes of PL/SQL objects in schema(s), please enter the schemas to be replicated. Note that specifying any entry will cause additional privileges to be granted to dbvrep. Enter through a comma or space-delimited list. Enter the list of schemas (PL/SQL): []
20. We are not going to use any advanced options, so specify no (default).
You can also specify some advanced options: 1. Rename schemas or tables. 2. Specify filtering conditions. 3. (Tables only) Configure Change Data Capture; this does not maintain a copy of the source table, but logs all operations as separate entries. This is useful for ETL or as an audit trail. This usually requires adding of new columns (timestamps, old/new values etc.) to the target table. Specify rename name or filter condition for any of the specified schemas (YES/NO): [no]
21. There are no tables to exclude from the schema. Press enter.
(PREPARE_SCHEMA_EXCEPTIONS) - Specify tables to exclude from PREPARE SCHEMA, if any: []
22. The tables are now defined for the replication. Press Return.
Following tables are defined for replication pairs: 1: ttorcl_src (Oracle) ==> ttorcl_trg (Oracle), DDL: yes, suffix: (no suffix), prepare: single-scn REPOE(tables) Enter number of replication pair to modify it, or "done": [done]
Step 4 - Process Configuration
23. Specify information about the processes and where they are going to run. Press Return to accept the default values.
Step 4 - Process configuration ======================================== The fourth step is to configure the replication processes for each replication. Following processes are defined: 1: MINE on ttorcl_src Not configured. 2: APPLY on ttorcl_trg Not configured. Enter number of process to modify it, or "done": [1]
24. Add information where the MINE process is going to run. Accept all the defaults.
Enter number of process to modify it, or "done": [1] Fully qualified name of the server for the process (usually co-located with the database, unless mine is offloaded using fetcher): [source] Server type (Windows/Linux/Unix): [Linux] Enable email notifications about problems (yes/no)? [no] Enable SNMP traps/notifications about problems (yes/no)? [no] Directory with DDC file and default where to create log files etc. (recommended: same as global setting, if possible)? [/u01/app/oracle/dbvrep_XE]
All the settings will be displayed. Press Return to accept the default values.
Following settings were pre-filled with defaults or your reloaded settings: ---------------------------------------- [MINE_REMOTE_INTERFACE]: Network remote interface: source:7901 [MINE_DATABASE]: Database TNS: source [TNS_ADMIN]: tnsnames.ora path: /u01/app/oracle/product/11.2.0/xe/network/admin [MINE_PLOG]: Filemask for generated plogs: /u01/app/oracle/dbvrep_XE/mine/%S.%E (%S is sequence, %T thread, %F original filename (stripped extension), %P process type, %N process name, %E default extension) [LOG_FILE]: General log file: /u01/app/oracle/dbvrep_XE/log/dbvrep_%N_%D.%E [LOG_FILE_TRACE]: Error traces: /u01/app/oracle/dbvrep_XE/log/trace/dbvrep_%N_%D_%I_%U.%E Checking that these settings are valid... Do you want change any of the settings? [no]
25. Add information where the APPLY process is going to run. Accept all the defaults.
Following processes are defined: 1: MINE on ttorlc_src Host: source, SMTP: no, SNMP: no 2: APPLY on ttorcl_trg Not configured. Enter number of process to modify it, or "done": [2]
Add information where the APPLY process is going to run. Accept all the defaults.
Enter number of process to modify it, or "done": [1] Fully qualified name of the server for the process (usually co-located with the database, unless mine is offloaded using fetcher): [target] Server type (Windows/Linux/Unix): [Linux] Enable email notifications about problems (yes/no)? [no] Enable SNMP traps/notifications about problems (yes/no)? [no] Directory with DDC file and default where to create log files etc. (recommended: same as global setting, if possible)? [/u01/app/oracle/dbvrep_XE]
All the settings will be displayed. Press return.
Following settings were pre-filled with defaults or your reloaded settings: ---------------------------------------- [APPLY_REMOTE_INTERFACE]: Network remote interface: target:7902 [APPLY_DATABASE]: Database TNS: target [TNS_ADMIN]: tnsnames.ora path: /u01/app/oracle/product/11.2.0/xe/network/admin [APPLY_STAGING_DIR]: Directory for received plogs: /u01/app/oracle/dbvrep_XE/apply [LOG_FILE]: General log file: /u01/app/oracle/dbvrep_XE/log/dbvrep_%N_%D.%E [LOG_FILE_TRACE]: Error traces: /u01/app/oracle/dbvrep_XE/log/trace/dbvrep_%N_%D_%I_%U.%E Checking that these settings are valid... Do you want change any of the settings? [no]
26. The processes are now defined.
Following processes are defined: 1: MINE on ttorcl_src Host: source, SMTP: no, SNMP: no 2: APPLY on ttorcl_trg Host: target, SMTP: no, SNMP: no Enter number of process to modify it, or "done": [done]
27. Dbvisit Replicate wizard has completed and all the scripts have been created. No database changes have been made yet.
Created file /u01/app/oracle/dbvrep_XE/dbvrep_XE-APPLY.ddc. Created file /u01/app/oracle/dbvrep_XE/dbvrep_XE-MINE.ddc. Created file /u01/app/oracle/dbvrep_XE/config/dbvrep_XE-setup.dbvrep. Created file /u01/app/oracle/dbvrep_XE/config/dbvrep_XE-dbsetup_ttorcl_src.sql. Created file /u01/app/oracle/dbvrep_XE/config/dbvrep_XE-dbsetup_ttorcl_trg.sql. Created file /u01/app/oracle/dbvrep_XE/config/dbvrep_XE-grants_ttorcl_src.sql. Created file /u01/app/oracle/dbvrep_XE/config/dbvrep_XE-grants_ttorcl_trg.sql. Created file /u01/app/oracle/dbvrep_XE/config/dbvrep_XE-onetime.ddc. Created file /u01/app/oracle/dbvrep_XE/start-console.sh. Created file /u01/app/oracle/dbvrep_XE/dbvrep_XE-run-source.sh. Created file /u01/app/oracle/dbvrep_XE/dbvrep_XE-run-target.sh. Created file /u01/app/oracle/dbvrep_XE/Nextsteps.txt. Created file /u01/app/oracle/dbvrep_XE/dbvrep_XE-all.sh. ================================================================================================================================== Dbvisit Replicate wizard completed Script /u01/app/oracle/dbvrep_XE/dbvrep_XE-all.sh created. This runs all the above created scripts. Please exit out of dbvrep, review and run script as current user to setup and start Dbvisit Replicate. ==================================================================================================================================
28. Do not run the script, but exit out of the wizard.
Run this script now? (yes/no) [NO] dbvrep> exit
You have now completed the Setup Wizard to configure a simple one-way replication. The Wizard has created the configuration files above but has not changed anything in the source or target databases.
The next step will be to execute the scripts created by the Setup Wizard to initialize the replication.