SharePlex for Oracle 8.5

Transcription

1 SharePlex for Oracle 8.5 Architecture, installation, usage, troubleshooting Dina Kleiman Sr. Technical Support Engineer

2 Slide Index Learning Objectives- Slide 3 SharePlex for Oracle 8.5 Architecture Slide 4-13 Installation and configuration Slide Diagnose and Troubleshoot Slide Documentation-Slides 37 Common Error Messages- Slide 38 2

3 Learning Objectives Upon completion of this presentation, the student should be able to: Understand SharePlex architecture Demonstrate How to install and start SharePlex Know how to determine which SharePlex module is experiencing the issue Where to locate error messages Where to gather information to resolve the issue How to collect appropriate logs 3

4 Part 1 - Architecture Upon completion of this lesson, the student should be able to: Describe SharePlex architecture Describe each process and queue in detail Click on below link to watch a video that describes SharePlex architecture, its processes and queues. w.aspx?id=sol92662&st=published 4

5 SharePlex for Oracle Architecture Source System Target System Oracle Log Files SQL Capture Process Read Process Post Process Quest Transport Layer Capture Q Export Q Post Q Network Export Process Import Process 5

6 Capture process Reads redo/archive logs on source Looks for changes to objects listed Writes to the capture queue One capture per source database <proddir>/bin/sp_ocap Capture Process 6

7 Capture queue Resides on the source system Reads data from the Oracle logs Holds the data outside the Oracle Source instance is identified by datasource, for example o.oraa. One capture queue per datasource (SID) Capture Q 7

8 Read process Reads data from the capture queue Adds routing information to the data Builds the where clause when necessary Sends data to the export queue One read per source database <proddir>/bin/sp_ordr Read Process 8

9 Export queue Resides on the source system Holds data processed by Capture and Read Data is ready for transport to the target system One or many export queues (named queues) Export Q 9

10 Export process Runs on source Reads data from the export queue Sends it across the network to the target system s import process One process per target Part of Export/Import transport pair <proddir>/bin/sp_xport Export Process 10

11 Import process Second half of the Export/Import transport pair Runs on target Receives data from export Writes to post queue One import for each export queue One of many post queues <proddir>/bin/sp_mport Import Process 11

12 Post Queue Resides on target system Holds data that is ready for writing to the target database One or more post queues per source SourceA and SourceB -> TargetC (2 post queues on TargetC) Default name: SourceHostname (o.sourcesid-o.targetsid) Named post queues can be created Post Q 12

13 Post process Runs on target system Read the post queue Constructs SQL statements to Oracle database Applies SQL to target objects One post process per each post queue <proddir>/bin/sp_opst_mt Post Process 13

14 Part 2 - Installation Upon completion of this lesson, the student should be able to: Download the SharePlex binary Install SharePlex Start SharePlex Set up replication Run basic commands Synchronize data with repair and copy 14

15 Part 2 - Installation Binary is located on supportlink Select binary for your OS and Oracle versions! Place binary on the server Extract using the tar xvf command tar xvf SharePlex b40-oracle100-sun-10-x86-m64.tar 15

16 Running the install: Part 1 Go over Pre-Installation checklist in the Install Guide Obtain the license key Execute the.tpm file and follow the prompts./shareplex b40-oracle100-sun-10-x86-m64.tar This will create proddir, vardir and install binaries and libraries Default port is

17 Running the install: Part 2 Make sure database is installed and open Make sure the following are set: ORACLE_HOME ORACLE_SID SP_SYS_VARDIR Run ora_setup and follow the prompts./ora_setup Ora_setup: creates database objects populates paramdb file with the encrypted passwed 17

18 Adding a new key Option 1 At time of install, when prompted Option 2 Using utility <proddir>/install/splex_add_key 18

19 Start SharePlex Go to the binary directory Make sure the following are set: ORACLE_HOME ORACLE_SID SP_SYS_VARDIR Locate sp_cop binary Execute it./sp_cop u<port> & 19

20 Set up replication Log into sp_ctrl./sp_ctrl Create the config file sp_ctrl> create config demo.cfg Specify datasource source SID Specify name of source and target tables Specify target server name and SID Either specify one table per line or use wild cards to replicate an entire schema Use default queues or set up named queues 20

21 Set up replication config file examples: Specify one table per entry datasource:o.orcl1 splex.demo_src splex.demo_dest Replicate an entire schema datasource:o.orcl1 splex.% splex.% Setup a named post queue 21 datasource:o.orcl1 splex.demo_src splex.demo_dest targetserver:[email protected] NOTE: For more information about named queues, see SharePlex for Oracle Administrator s Guide chapters Configuration for isolating data using named export queues and Configuration for faster posting using named post queues.

22 Start replication Activate config sp_ctrl> activate config demo.cfg To see a list of all config files sp_ctrl> list config Active state means a config file was successfully activated 22

23 Common sp_ctrl commands To see queues sp_ctrl> qstatus To see processes sp_ctrl> show To see parameters set for each process sp_ctrl> list param all <process name> To see modified parameters sp_ctrl> list param modified 23

24 Common sp_ctrl commands cont: To see details about capture sp_ctrl> show capture detail To see details about read sp_ctrl> show read internal To see details about export sp_ctrl> show export To see details about import sp_ctrl> show import To see details about post sp_ctrl> show post detail 24

25 Controlling DDL replication Set parameter SP_OCT_REPLICATE_DDL sp_ctrl> set param SP_OCT_REPLICATE_DDL (disable replication of both ALTER and TRUNCATE) 1 (enable ALTER replication only) 2 (enable TRUNCATE replication only) 3 (enable replication of DDL NOTE: For more information about this parameter and other SharePlex user configurable parameters, see SharePlex for Oracle Reference Guide. 25

26 Controlling posting on target Disable posting to one object 1. SOURCE: sqplus> select object_id from dba_objects where object_name='<source TABLE NAME> 2. TARGET: sp_ctrl> set param SP_OPO_DISABLE_OBJECT_NUM <SOURCE OBJID from step 1> NOTE: click on the below link to watch a video about setting SP_OPO_DISABLE_OBJECT_NUM Ignore DDL errors on target TARGET: sp_ctrl> SP_OPO_STOP_ON_DDL_ERR Reset any parameter to its default value (turn it off) sp_ctrl> reset param <parameter name> 26

27 Synchronize tables Using repair command Log into source sp_ctrl> repair splex.demo_src sp_ctrl> repair status Using copy command TARGET: sp_ctrl> start launcher SOURCE: sp_ctrl> copy splex.demo_src SOURCE: sp_ctrl> copy status NOTE: For more information about copy, repair, and other SharePlex utilities, commands and parameters, see SharePlex for Oracle Administrator s Guide and Reference Guide. 27

28 Part 3: How to diagnose & troubleshoot Upon completion of this lesson, the student should be able to: Determine the SharePlex module that is experiencing the issue Locate the error message Search SupportLink and SharePlex documentation for this error message Either resolve the issue or collect appropriate information to further troubleshot through collaboration. Be the customer advocate until the issue is fully resolved Assumption: Participant had thoroughly read and implemented what s written in the SharePlex for Oracle Installation Guide. SharePlex Installation Guide is available for download via our website. This guide includes SharePlex product architecture, installation, configuration, and feature demonstration. Participant should have some prior experience with Oracle database and Unix/Linux/Windows OS. 28

29 Business Scenario A SharePlex customer says that SharePlex is experiencing an issue What should the 1 st Level of SharePlex Support do? 29

30 Initial Steps Determine what was happening prior to or at the time of the issue What changed? New code release? Batch job? Upgrade? Etc. Determine which module is down sp_ctrl> show sp_ctrl> qstatus Determine the SharePlex version sp_ctrl> version full Locate the error message in $SP_SYS_VARDIR/log/event_log Search the KnowledgeBase, Release Notes, Administrator s Guide, Reference Guide, Installation Guide, and Known Issues List for this error message (the links are provided in the later slides) Determine whether the issue is with the SharePlex product or with the 3 rd party software (Oracle, Unix, Linux, Windows) or hardware Resolve the issue using the information gathered in the previous steps or ask the customer to contact the 3 rd party vendor if necessary 30

31 If the issue cannot be resolved Collect appropriate SharePlex files: logs from $SP_SYS_VARDIR/log $SP_SYS_VARDIR/data/paramdb Collect SharePlex, Oracle and OS version information sp_ctrl> version full (for SharePlex version info) Collect the output of sp_ctrl> show sp_ctrl> qstatus For core dump issues collect $SP_SYS_VARDIR/dump/core.out file Document work performed so far customer replication setup events on the server(s) that led to the error Contact SharePlex Support through 31

32 After Contacting SharePlex Support Be the customer advocate throughout the process Be an active participant until the issue is fully resolved Make sure SharePlex Support receives the requested logs in a timely manner Make sure the customer understands the issue and the resolution once it is provided Keep the customer regularly updated with current status If the issue requires a long time to resolve make sure the customer understands why Facilitate communication between the customer and 2 nd Level Support translate communications if necessary 32

33 Collecting logs Core.out and core files are in $SP_SYS_VARDIR/dump Paramdb is in $SP_SYS_VARDIR/data All logs are in $SP_SYS_VARDIR/log Main log: event_log look here first Capture: <SID>_ocap*.log or ocap.log or capture log Read: <SID>_ord*.log or ordr.log or reader log Post: <SID>_ <queue>_opo*.log or opo.log or poster log 33

34 Collecting logs (continued) All logs are in $SP_SYS_VARDIR/log Copy: sync_svr*<sid>_ <src_server>_p<pid>.log (source) or sync svr.log sync_clt*<sid>_<src_server>_p<pid>.log (target) or sync clt.log Compare: <SID>_desvr-<PID>*.log or desvr.log (source) <SID>_ declt-<owner>-<table_name>-<pid>*.log or declt.log (target) <TABLE_NAME>.sql (target) Activation: <SID>_oconf*.log or oconf.log or activation log (source) Export/Import: without debug all messages go into the event_log debug is logged into trace_log or trace log, this file may or may not be present 34

35 Review Questions Match up a process and its logs capture read post compare copy activation desvr.log, declt.log sync_svr.log, sync_clt.log ocap.log ord.log opo.log oconf.log 35

36 Review Question Answers Match up process and its logs capture read post compare copy activation desvr.log and declt.log sync_svr.log, sync_clt.log ocap.log ordr.log opo.log oconf.log 36

37 Links to SharePlex Documentation KnowledgeBase Documentation (Administrators, Reference, Install Guides) Product Life Cycle Supported Platforms Release Notes Product Download QuestBook 37

38 Common issues and solutions Click on each link and read the articles for more information. Post stopped due to error: "Poster: Cannot open object cache Basic trouble shooing in SharePlex Post stopped with error: ORA Capture core dumps with error: "A portion of the redo log could not be parsed' Compare fails with: "Warning 79 calling connect(de_sock_connecttoserver) (IP:, Port: ) failed". Sp_cop exits with error: sp_cop Address already in use udp server bind - exiting 38

39 Prerequisites for Contacting Support 39

40 When opening a support case submit the following: Problem Description Diagnostic logs, screenshots, etc. Environmental details (system versions, physical/virtual hardware, federation, High Availability, architecture, etc.) Issue severity and customer business impact, timeframes, etc. If a performance issue, provide specific details as specified in the Notes section of this slide. 40

41 Feedback on the Documentation We are interested in receiving feedback from you about our Support Technical Training. When submitting feedback please include: Product / Version Indicate if you are providing Feedback on: Support Training Documentation Support Training Exam Practical Exam Comments All comments are welcome. Please submit your feedback to the following address: [email protected] Please do not submit Technical Support requests to this address. 41

42 DELL CONFIDENTIAL AND PROPRIETARY This document SharePlex for Oracle 8.5 Support Training contains confidential information of Dell and embodies trade secret and proprietary intellectual property of Dell. It is legally protected and shall not be copied, modified, reverse engineered, published, disclosed, disseminated outside of Dell or otherwise used, in whole or in part, without Dell s written consent, provided, however, that you have the right to use the Document solely for your internal use and solely as necessary for you to enjoy the benefit of Services under the applicable SOW (or other agreement) you have entered into with Dell. Copyright 2012 by Dell Inc. The copyright notice does not imply publication of this document or its contents. DELL, the E (Stylized in a sphere) logo, Dell Compellent, OpenManage, EqualLogic, PowerEdge, PowerVault and other Dell trademarks are the trademarks or registered trademarks of Dell Inc. in the U.S. and certain other countries. 42