Versions Compared

Key

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

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. 

...

Note

Please ensure the following prePre-requisites checks have been tested. Otherwise the replication will not function.

...

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. Connect to On the source server server, as oracle.

No Format
su - oracle

2. In the home directory of oracle , in the $HOME directory, execute the dbvrep executable to start Dbvisit Replicate.

No Format
dbvrep

The output will be.:

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

...

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.


Run the wizard now? [yes] yes

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

...

Enter the location of the directory where the Setup Wizard will place the configuration files. Accept the default value.

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

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

...

Describe the first database. This will be the source database and will be the Oracle database on the machine called source.

Note

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.

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

...

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 sourcefor the source database is ttorcl_src

No Format
Please enter database TNS alias: [] sourcettorcl_src

Enter the username and password of a user with SYSDBA. Accept the default of SYS and change_on_install.

...

7. Specify the defaults to create the Dbvisit Replicate schema Schema in the source database. Accept the default username of dbvrep and the default password of dbvpasswd.

No Format
Connecting to database sourcettorcl_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.

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

No Format
Temporary tablespaces detected on the database: TEMP.
Please enter default temporary tablespace for this user: [TEMP]

...

No Format
Following databases are now configured:
1: Oracle sourcettorcl_src, SYS/***, SYSTEM/***, dbvrep/***, USERS/TEMP, dbvrep/, ASM:NO, TZ: +00:00

...

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 target ttorcl_trg.

No Format
Please enter database TNS alias: [] targetttorcl_trg                                                                                                          

Enter the username and password of a user with SYSDBA. Accept the default of SYS and change_on_install.

...

 Specify the defaults to create the Dbvisit Replicate schema Schema in the target database. Accept the default username of dbvrep and the default password of dbvpasswd.

No Format
Connecting to database targetttorcl_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.

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

No Format
Temporary tablespaces detected on the database: TEMP.
 
Please enter default temporary tablespace for this user: [TEMP]

...

No Format
Following databases are now configured:
1: Oracle sourcettorcl_src, SYS/***, SYSTEM/***, dbvrep/***, USERS/TEMP, dbvrep/, ASM:NO, TZ: +00:00
2: Oracle targetttorcl_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] 

...

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: sourcettorcl_src (Oracle)  
2: targetttorcl_trg (Oracle)  
Select source database: [1]
 
Select target database: [2]                                                                                                                                               

...

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: sourcettorcl_src (Oracle) ==> targetttorcl_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 Specify the REPOE schema is 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: [] repoe                                                                                                                                       
Selected schemas: REPOE

...

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

...

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 sourcettorcl_src
  Not configured.
2: APPLY on targetttorcl_trg
  Not configured.
Enter number of process to modify it, or "done": [1]  

...

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

...

No Format
Following processes are defined:
1: MINE on sourcettorcl_src
  Host: source, SMTP: no, SNMP: no
2: APPLY on targetttorcl_trg
  Host: target, SMTP: no, SNMP: no
Enter number of process to modify it, or "done": [done]

...

No Format
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_sourcettorcl_src.sql.
Created file /u01/app/oracle/dbvrep_XE/config/dbvrep_XE-dbsetup_targetttorcl_trg.sql.
Created file /u01/app/oracle/dbvrep_XE/config/dbvrep_XE-grants_ttorcl_sourcesrc.sql.
Created file /u01/app/oracle/dbvrep_XE/config/dbvrep_XE-grants_ttorcl_targettrg.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.

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