Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note

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.

 

1. Connect to the source (dbv01) server as oracle.

No Format
su - oracle

 

2. In the home directory of oracle start Dbvisit Replicate.

No Format
[oracle@source ~]$ dbvrep
Initializing......done
Dbvisit Replicate version 2.67.0002.37354333
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.

No Format
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.

...

No Format
Accept end-user license agreement? (view/yes/no) [view] yes	

...

3. Follow the steps and give the name of the replication. Name it dbvrep_orcl.

No Format
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_orcl 	

...

4. For the next questions, leave the defaults as they are.

No Format
(LICENSE_KEY) - Please enter your license key: [(trial)]

...

No Format
(SETUP_SCRIPT_PATH) - Please enter a directory for location of configuration scripts on this machine: [/homeu01/oracle/dbvrep_orcl]                                          

Network configuration files were detected on this system in these locations:
/home/oracleu01/app/oracle/product/1112.21.0/dbhome_2/network/admin
/home/oracle/app/oracle/product/11.2.0/dbhome_2/1/network/admin
No Format
(TNS_ADMIN) - Please enter TNS configuration directory for this machine: [/home/oracleu01/app/oracle/product/1112.21.0/dbhome_21/network/admin]

...

5. Describe the first database. This will be the source database and will be Oracle. 

...

No Format
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 is TTORCL_SRC

No Format
Please enter database TNS alias: [] ttorcl_src                                                                                                                            
No Format
Please enter SYSDBA user name: [SYS]                                                                                                                                  
No Format
Please enter SYSDBA user name: [SYS]

SYS password is oracle:

No Format
Please enter password for this user: [change_on_install] ******

...

No Format
Please enter password for this user: [manager] ******

 

7. Specify the defaults to create the Dbvisit Replicate schema in the source database. Choose the USERS tablespace as the default tablespace.

No Format
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]                                                                    

...

No Format
Please enter default temporary tablespace for this user: [TEMP]                                                                                                           
Following databases are now configured:
1: Oracle ttorcl_src, SYS/***, SYSTEM/***, dbvrep/***, USERS/TEMP, dbvrep/, ASM:NO, TZ: +00:00

...

8. The first database is now configured. Add the next database. This will be the target database. It is also an Oracle database.

No Format
Enter the number of the database to modify it, or "add", or "done": [add]                                                                                      
No Format
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.

No Format
Please enter database TNS alias: [] ttorcl_trg                                                                                                          

...

No Format
Please enter password for this user: [manager] ******

...

10. Specify the defaults to create the Dbvisit Replicate schema in the source database. Choose the USERS tablespace as the default tablespace tablespace.

No Format
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]                                             

...

No Format
Please enter default temporary tablespace for this user: [TEMP]

...

11. Both source and target database have now been defined.

No Format
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] 

...

12. Set source and targets for each replication pair.

No Format
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]                                                                                                                                               
No Format
Select target database: [2]

...

13. Specify defaults for the replication pair.

No Format
Will be DDL replication enabled? [yes]                                                                        

...

No Format
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.

No Format
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).

No Format
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.

No Format
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] 

...

17 Add the schemas or tables to be replicated.

No Format
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. Add the OE schema to be replicated.

No Format
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: [] oe                                                                                                                                       
Selected schemas: OE
No Format
Add more tables or schemas? (YES/NO) [NO] 

...

19. We are not replicating PL/SQL. Please press enter / return to skip this option.

No Format
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.

No Format
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. The tables are now defined for the replication.

No Format
Following tables are defined for replication pairs:
1: ttorcl_src (Oracle) ==> ttorcl_trg (Oracle), DDL: yes, suffix: (no suffix), prepare: single-scn
  OE(tables)
Enter number of replication pair to modify it, or "done": [done]                                                                                                          

 

22. Specify information about the processes and where they are going to run.

No Format
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]  

 

23. Add information where the MINE process is going to run. Accept all the defaults.

No Format
Enter number of process to modify it, or "done": [1]                                                                                                                    

...

No Format
Do you want change any of the settings? [no]

...

24. Add information where the APPLY process is going to run. Accept all the defaults.

No Format
Following processes are defined:
1: MINE on ttorcl_src
  Host: source, SMTP: no, SNMP: no
2: APPLY on ttorcl_trg
  Not configured.
Enter number of process to modify it, or "done": [2]                                                                                                                      

...

No Format
Do you want change any of the settings? [no]

 

25. The processes are now defined.

No Format
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]

...

26. Dbvisit Replicate wizard has completed and all the scripts have been created. No database changes have been made yet.

No Format
Created file /homeu01/oracle/dbvrep_orcl/dbvrep_orcl-APPLY.ddc.
Created file /homeu01/oracle/dbvrep_orcl/dbvrep_orcl-MINE.ddc.
Created file /homeu01/oracle/dbvrep_orcl/config/dbvrep_orcl-setup.dbvrep.
Created file /homeu01/oracle/dbvrep_orcl/config/dbvrep_orcl-dbsetup_ttorcl_src.sql.
Created file /homeu01/oracle/dbvrep_orcl/config/dbvrep_orcl-dbsetup_ttorcl_trg.sql.
Created file /homeu01/oracle/dbvrep_orcl/config/dbvrep_orcl-grants_ttorcl_src.sql.
Created file /homeu01/oracle/dbvrep_orcl/config/dbvrep_orcl-grants_ttorcl_trg.sql.
Created file /homeu01/oracle/dbvrep_orcl/config/dbvrep_orcl-onetime.ddc.
Created file /homeu01/oracle/dbvrep_orcl/start-console.sh.
Created file /homeu01/oracle/dbvrep_orcl/dbvrep_orcl-run-source.sh.
Created file /homeu01/oracle/dbvrep_orcl/dbvrep_orcl-run-target.sh.
Created file /homeu01/oracle/dbvrep_orcl/Nextsteps.txt.
Created file /homeu01/oracle/dbvrep_orcl/dbvrep_orcl-all.sh.
========================================================================================================================================================================
Dbvisit Replicate wizard completed
Script /homeu01/oracle/dbvrep_orcl/dbvrep_orcl-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.
========================================================================================================================================================================
Optionally, the script can be invoked now by this wizard.
Run this script now? (yes/no) [NO]

...

27. Do not run the script, but exit out of the wizard.

No Format
Run this script now? (yes/no) [NO]                                                                                                                                        

...