Professional Documents
Culture Documents
Remote Data Replicator (RDR) : User Manual
Remote Data Replicator (RDR) : User Manual
Remote Data Replicator (RDR) : User Manual
User Manual
V 3.5
417006-2705-0H3-A00
Remote Data Replicator (RDR) User Manual
V 3.5
Catalog No: X34217
July 2005
st
1 Edition
Contents
About this Manual......................................................................... vii
Overview ............................................................................................................ vii
Intended Audience ............................................................................................. vii
Document Organization..................................................................................... viii
Document Conventions ....................................................................................... ix
Related Documentation........................................................................................x
Obtaining Technical Documentation ....................................................................x
Technical Assistance............................................................................................x
Your Opinion Is Very Important To Us ................................................................ xi
1 Introduction.............................................................................. 1-1
Overview .......................................................................................................... 1-1
What is RDR?................................................................................................... 1-2
Functional Description...................................................................................... 1-2
Typical RDR Configurations ............................................................................. 1-7
Activation Overview........................................................................................ 1-12
Table of Figures
Figure 1-1: Sequence of LightSoft instance backups over time ................................... 1-6
Figure 1-2: Simple configuration example – 1:1 ........................................................... 1-9
Figure 1-3: Simple configuration example – 2:2 ......................................................... 1-10
Figure 1-4: RDR complex configuration – N:2 with independent backup server ........ 1-11
Figure 1-5: General replication scheme...................................................................... 1-13
In this Section
Overview .........................................................................................................vii
Intended Audience...........................................................................................vii
Document Organization................................................................................. viii
Document Conventions ....................................................................................ix
Related Documentation .....................................................................................x
Obtaining Technical Documentation.................................................................x
Technical Assistance .........................................................................................x
Overview
The Remote Data Replicator (RDR) application provides redundancy features
for the network management applications of ECI Telecom's Optical Network
Division – EMS-XDM®, EMS-SYNCOM, and LightSoft®.
This manual describes the requirements for successful RDR installation, and
detailed procedures for configuration and activation.
This manual is intended for use with RDR V 3.5, but most procedures are also
compatible with previous versions. Differences in use between RDR versions
are noted where applicable.
Intended Audience
This manual is intended for telecommunications network personnel backing up
management system databases, and implementing effective recovery from
those backups as required.
Document Organization
The manual includes the following chapters:
Chapter 1, Introduction, provides a general and functional description of
RDR, its topological elements, features, and typical configurations.
Chapter 2, Preliminary Requirements, describes the preconditions for
successful installation.
Chapter 3, RDR Menus, describes some principal menus in configuration
and activation procedures.
Chapter 4, Configuring Primary Components, provides an overview of
the component configuration workflow, and how to configure primary
components to use RDR for replicating and creating optional display
messages.
Chapter 5, Configuring Backup Components, describes how to
configure backup components as repositories for RDR replicas.
Chapter 6, Configuring Mirror Components, describes how to configure
mirror components of the system to enable recovery from a selected replica
in the event of a primary failure.
Chapter 7, Creating and Scheduling Backups of Primary Component
Instances, describes how to create regular backups or static archives,
schedule automatic backups, and view the schedule (crontab) entries
generated by the Unix cron scheduling mechanism.
Chapter 8, Recovering to a Mirror Component, describes how to start a
mirror station from any backed up replica in the event of a primary station
failure.
Chapter 9, Restarting the Primary Instance After Recovery (Reverse
Update), describes how to return the primary component to normal
operation.
Appendix A, Suspending or Resuming RDR Primary Component
Operation, describes how to suspend and resume RDR primary component
activities, for example in the case of maintenance operations or software
upgrade.
Appendix B, RDR Commands, describes the Unix scripts for specialized
RDR operations. For expert reference use only.
Appendix C, Glossary.
Document Conventions
The following conventions are used in this manual:
Table 1: Document conventions
Related Documentation
The following documents may be of assistance in RDR installation,
configuration, and activation processes:
EMS-XDM User Manual
EMS-SYNCOM User Manual
eNM LightSoft and LightSoft User Manuals
Technical Assistance
The configuration and operation of RDR are highly specialized processes. If
you have questions or concerns about your network design or operation, the
services of ECI Telecom’s design engineers and highly trained field service
personnel are available to you at any time.
If you are interested in obtaining design assistance or a network installation
plan from ECI Telecom Customer Support team, contact your ECI Telecom
sales representative. With any support related issues, technical or logistic,
please contact the ECI Telecom Customer Support center at your location. If
you are not familiar with that location, you can contact our central customer
support center action line at:
Telephone + 972-3-9266000
Telefax + 972-3-9266370
Email on.support@ecitele.com
If you found errors or have any other suggestions for improving this document, please indicate the
topic, section, and page number below:
Please check the ways you feel we could improve this document:
Document organization Make it shorter
Table of contents Add more detail
Index Make it less/more technical
Include more figures Add more/better reference aids
Clearer procedures/instructions Other (please indicate):
Please add any other detail you would like to mention for improvement:
Overview
This chapter provides a general description of RDR and functional descriptions
of its topological elements. Also included are typical configurations and an
overview of the current version's new features.
NOTE:
RDR supports the eNM LightSoft application as well as its later
version, LightSoft. In this manual, LightSoft may be used to denote
either of these applications.
LightSoft denotes the application running on LightSoft server
hosts, which maintain databases. This should not be confused with
the corresponding RDR instance (nms) – see Instances, page 1-4,
for information about RDR instances.
ems, enm, and nms are used to identify RDR instances, while
EMS-XDM, EMS-SYNCOM, and LightSoft are used to identify
the corresponding applications.
A configuration of an instance on a specific component is referred
to as a component instance. (In the RDR interface, “client” may be
used to denote a component instance.)
What is RDR?
RDR is a tool that provides redundancy features for ECI Telecom's Optical
Networks Division’s management applications, including EMS-SYNCOM,
EMS-XDM, and LightSoft server station databases, on the same or different
stations.
RDR is flexible and can be configured in a wide variety of topologies. It
provides optimal protection consistent with geographic infrastructure
distribution, security needs, and available budget for standby mirror hardware.
RDR can be used as a site protection solution (primary and backup sites
connected via a long distance link), as well as a server (station) protection
solution (primary and mirror sites connected via LAN).
Functional Description
RDR performs remote data backup (replication) between primary stations
(stations currently managing the network) and the backup server (the station
storing backup data). The backup data can subsequently be restored
(synchronized) on a mirror station (remote redundant stations replacing failed
or deactivated primary components).
Components
RDR components provide the infrastructure for RDR backup and
synchronization functionality on servers. There are three types of component:
Primary: Administers RDR operations on the stations that normally
manage the network
Backup: Administers the storage of backups (replicas) on backup stations
Mirror: Restores application databases from the backup station to a mirror
station, enabling the network to be managed from the mirror station in the
event of a primary station failure
RDR components are referred to as belonging to sites – primary components to
a primary site, mirror components to a mirror site, and the backup component
(when not sharing a mirror component's station) to a backup site.
Primary components
The primary site can contain a number of primary components, each residing
on a station, and each maintaining any combination of instances (see Instances,
page 1-4).
Backup components
A backup component is used to store replicas. It may either reside on a
dedicated station, or share a station with one of the mirror components.
RDR also supports multiple backup components, each instance on the primary
component configured to use a different RDR backup server.
Each configured instance in the primary host performs file transfers to replicas
on the backup server. Each regular backup session is performed to a sequential
replica (cyclic – incremental). The backup server therefore normally stores a
set number of last successful replicas.
The number of stored replicas per instance is configurable (see Replicas, page
1-5), and only limited by available disk capacity (see Minimum Backup Server
Disk Capacity, page 2-2).
Mirror components
Mirror components are sets of redundant hosts used to restore and run instances
in the event of primary component failure. Mirror components are generally
assigned their own servers. (Depending on user requirements, the backup
component may share a server with a mirror component.)
Mirror components are normally in standby mode, meaning instances installed
on the component are not active, but ready for a command to launch the
recovery process. The operator can start a mirror station from any backed up
replica.
The system topology may include one or several mirror components, according
to the required redundancy. When primary stations are geographically
separated, with negligible chance of simultaneous failure, multiple primary
components may be safely and economically serviced by a single mirror
component (“N:1” configuration). In more sensitive environments, multiple
mirror components can provide additional assurance. For example, each
primary server can be paired with its own mirror component (“1:1”
configuration). For more information, see Primary and Mirror Configurations,
page 1-8.
Instances
RDR instances are sets of RDR-supported application data (specific application
settings) that each primary and mirror component is configured to maintain –
one per supported management application (EMS-SYNCOM, EMS-XDM,
and/or LightSoft, in any combination).
The application instances are identified by the following names (instance tags)
in RDR menus and scripts:
ems – EMS-XDM
enm – EMS-SYNCOM
nms – LightSoft
RDR instances are related to but conceptually distinct from the corresponding
applications running on a server.
The RDR modular structure provides separate backup/recovery mechanisms for
each supported instance. Each instance on each component can be configured
according to user requirements, for example, to have different backup
schedules or a different number of backups per cycle.
Replicas
RDR replicas are backup data sets of primary component instances (databases).
The replicas are stored in a special folder on the backup server for each primary
component instance, in a user-configurable path.
From 2 to 5 full regular replicas can be configured for each primary component
instance (ems, enm, or nms), with the newest backup overwriting the currently
oldest backup on a cyclical basis.
An archive replica, which is not automatically overwritten, can also be created
for each primary component instance. An archive replica is a static backup
from a specific time, used to freeze the system state on the backup server.
Recovery can be performed based on either any cyclical replica or the archive
replica.
The number of replicas that can be stored is only limited by the available disk
capacity (see Minimum Backup Server Disk Capacity, page 2-2).
For each primary component instance, backups can be scheduled to be
performed automatically at constant intervals (set time span between backups)
or nonconstant intervals (specific time on selected days of the week).
Replicas at constant intervals can be set to occur at very short intervals – as
frequently as every 5 minutes, according to user requirements. (Naturally, the
selected interval cannot be shorter than the time it takes to create a backup. In
this respect, nms instance backups provide great flexibility – see LightSoft
Instance Backup Levels, page 1-5.)
To simplify recovery, it is recommended to schedule all primary component
instances with the same backup intervals. Offsets can be used to stagger
individual starting times (setting them a number of minutes apart), to balance
the load and avoid network congestion.
L0 1 L0 11
L1 2 L1 5 L1 8
L2 3 L2 4 L2 6 L2 7 L2 9 L2 10
(Levels configuration for this example is set to L1=2 and L2=2. The subscripts
beside the entries denote a backup's point in time. For example, the top leftmost
L0 backup was performed at Time1. The backups are spaced according to
user-specified intervals.)
At Time1 a full backup is created (L01).
Reconstituting the database between Time1 and Time2 requires restoring
from the full backup L01.
At Time2 an intermediate backup of differences between Time1 and Time2
is created (L12).
Reconstituting the database between Time2 and Time3 requires restoring
the L01 full backup, supplemented by the L12 difference.
At Time3, an intermediate backup of differences between Time2 and
Time3 is created (L23).
Reconstituting the database between Time3 and Time4 requires restoring
the L01 full backup, supplemented by both the L12 difference plus the L23
difference.
NOTE:
Backup Deployment
Any number of backup components may be deployed, either on their own
dedicated servers or sharing servers with mirror components.
The backup component can be installed in the following ways:
On the same server station as a mirror component. The shared station is
installed with the operating system and infrastructure of a regular network
management station, as well as the RDR application.
OR
1:1 configuration
The following shows a 1:1 configuration with a dedicated mirror host for each
primary host.
In this example, the backup and mirror components share a common host.
2:2 configuration
The following shows a 2:2 configuration where two primary components are
serviced by two mirror components. For example, primary host 1 may run
LightSoft while primary host 2 may run EMS-XDM as a slave manager.
In this example, the backup component and one mirror component share a
common host, while the second mirror component resides on its own host.
N:2 configuration
The following figure shows an N:2 configuration where N primary components
are serviced by two mirror components, saving on mirror hardware.
The mirror site can provide redundancy for any number or combination of
primary components. An individual mirror component can restore multiple
primary component instances, only limited by its power, memory, and disk
capacity.
Figure 1-4: RDR complex configuration – N:2 with independent backup server
For larger networks, where the LightSoft server is distributed amongst several
workstations, the following two schemes are supported:
1:N at the workstation level – a single additional workstation may be
deployed to act as backup for any server station. This approach is hardware
efficient but cannot support full site redundancy.
1:1 at the LightSoft server level – full hardware duplication is required. For
example, for four server machines, four additional machines are required.
Some networks may have several LightSoft installations. In that case, a 1:N
LightSoft backup scheme may be suitable. The backup site should include as
many workstations (LightSoft server + EMSs) as the largest LightSoft site
being backed up.
LightSoft client users may switch from one LightSoft server site to another,
enabling seamless network management.
Activation Overview
Backup Session
The RDR implementation is based on replication of a supported application’s
database from a primary component to the backup component.
The primary station can be set to automatically invoke backup sessions at
prescheduled times. These regular replicas are stored cyclically on the backup
component. Archive backups, that are not overwritten, can also be configured
for each instance.
The backup scheme utilizes a local cache to eliminate communications link
bottlenecks. Synchronization is performed in two stages:
From the application store to the local cache
From the local cache to the backup server
The local cache location on the primary host is configurable for each
application, enabling RDR to use available disk space on the host in the most
efficient way.
Overview
This chapter describes the preconditions for successful installation. It also
provides an overview of the workflow for component configuration detailed in
subsequent chapters.
The RDR package is installed on your system components by ECI personnel.
RDR must be installed on every station of the system – primary, backup, and
mirror. When backup and mirror components are combined on one station, a
single RDR installation is required for that station.
Application Requirements
The following products, versions, and configurations are supported:
EMS-SYNCOM v.1 and later – standalone and integrated
EMS-XDM v.3 and later – standalone and integrated
eNM LightSoft/LightSoft server
NOTE: RDR can also be used in networks that include other EMS
types such as BroadGate™ and µLAN. In these cases, the EMSs
are not backed up by RDR but rather deployed in parallel in both
the primary and backup sites.
Overview
This chapter describes some principal menus used by the configuration and
activation procedures in this manual.
1 Configuration Menu
2 RDR Utilities/Actions Menu
3 Show RDR Components Status
4 About RDR
2. Select the required option - generally an instance (ems, enm, or nms). Only
the instances that have been configured for the component are shown.
(The common option is relevant only for special purpose procedures that
are described in context, as required.)
The corresponding Actions menu appears.
Overview
This chapter provides an overview of the workflow for component
configuration detailed in this and subsequent chapters.
It then describes how to configure the primary components of the system to
enable replication of instances (ems, enm, and/or nms) with RDR. You can also
optionally configure messages to appear on specified displays of the system
infrastructure.
The configuration procedure assumes that the system has already been prepared
and installed in the relevant stations, as described in Chapter 2, Preliminary
Requirements.
The examples provided relate primarily to ems screens and scripts. The enm or
nms screens and scripts are very similar. Any significant differences are noted.
Configuration Workflow
After installing RDR on all relevant hosts, each RDR component – primary,
backup and mirror – must be configured as described in Chapters 4, 5, and 6.
It is recommended that you test the backup configuration directly after
configuring the primary and backup components. You do this by performing an
initial manual backup and scheduling automatic backup sessions at set intervals
(see Chapter 7, Creating and Scheduling Backups of Primary Component
Instances).
The mirror component configuration may be postponed until mirror
functionality is required.
The following is an overview of the steps leading to activation of the primary,
backup, and mirror components:
1. Ensure that the preliminary requirements for installation described in this
chapter are fulfilled. RDR is installed on all relevant stations by ECI
Telecom’s support staff.
2. Configure the primary components – see Chapter 4, Configuring Primary
Components.
3. Configure the backup servers – see Chapter 5, Configuring Backup
Components.
4. Perform backups to test the replication process (recommended) – see
Chapter 7, Creating and Scheduling Backups of Primary Component
Instances:
a. Use the Full Synchronization function (see page 3-5) to fill all the full
regular replicas configured for each primary component EMS instance
(see Replicas, page 1-5), or the first L0 replica of a LightSoft instance
(see LightSoft Instance Backup Levels, page 1-5).
b. Schedule automatic backup sessions (set interval).
5. Configure a mirror component – see Chapter 6, Configuring Mirror
Components.
6. Configure a shadow backup component if required – see Chapter 5,
Configuring Backup Components.
NOTES:
Not all commands may be supported by previous RDR versions.
Messages displayed on screens may differ slightly from those
illustrated in this manual.
3. Select a required instance – ems, enm or nms. (The screen examples are
specific to ems. The screens that you will encounter for enm or nms are
essentially the same; any major differences are described in the text.)
4. A prompt for Cache Folder path appears. Press Enter to accept the default.
Configure instance "ems" on MainComp:
6. A prompt for the backup directory path appears. Press Enter to accept the
default.
ems -> Enter backup dir path on StandbyComp [
default=/sdh_home/Replica ]
[?] [Enter]
Enter the name of the primary component. If the primary component has
several network adapters, choose the name of the network interface
connected to the backup server.
Choose the number of replicas according to the desired reliability level and
existing disk capacity. For more details, see Replicas, page 1-5.
9. (nms only)
Prompts for the number of backups during the database backup cycle at
level 1 and level 2 appear. Press Enter to accept the defaults.
nms -> Number of level 1 backups during DB backup cycle [
default=2 ] [1-3,?] [Enter]
10. The parameters that you entered appear. Enter y to apply the parameters.
--- Configuration parameters ---
At the end of the process, the Configure RDR Primary Component menu
reappears.
*****************************************************************
*
* Primary RDR component on "MainComp" configured.
*
* Next steps:
*
* 1. Configure backup server on "StandbyComp"
* 2. Perform Test Synchronization "MainComp"
* 3. Run /opt/RDR/bin/SetCronRDR to schedule automatic
replications
*
* Prompt: Use <RDR> to launch RDR Command Center.
*
*****************************************************************
13. On the RDR Main menu, select Show RDR Components Status.
RDR host "MainComp" Main Menu
___________________________
1 Configuration Menu
2 RDR Utilities/Actions Menu
3 Show RDR Components Status
4 About RDR
The following information window shows the configuration settings for the
primary components.
1 Configuration Menu
2 RDR Utilities/Actions Menu
3 Configure Alarms Notification
4 Show RDR Components Status
5 About RDR
14. Press Enter or enter q at successive prompts to redisplay the main menu.
RDR host "MainComp" Main Menu
15. Use the Full Synchronization function (see page 3-5) to fill all the full
regular replicas configured for each primary component EMS instance (see
Replicas, page 1-5), or the first L0 replica of a LightSoft instance (see
LightSoft Instance Backup Levels, page 1-5).
1 Enable "All-Displays"
2 Enable "All-Xterminal-Displays"
3 Enable "All-GO-Global-Displays"
4 Enable specific display ( of Xterminal )
4. Enter the required options, one after the other (any combination is valid).
The menu reappears after each selection.
The following interdependencies apply:
All-Displays
Condition Action Result
When All-Displays is selected N/A All-Xterm
and All GO-Global are
automatically enabled
Specific Display
Condition Action Result*
And you then
If Specific was used to enable a enable All-Xterm The specific display
specific display And you then remains enabled
disable All-Xterm
And you then
If Specific was used to disable enable All-Xterm The specific display
a specific display And you then becomes enabled
disable All-Xterm
* The display does not need to have an open session with the primary component. It is
sufficient that it runs X-server.
NOTES:
A station that is not a remote display of the primary RDR
component (for example, a dedicated Sun station installed with
LightSoft client), requires a specific display setup.
X-Terminals should be defined in the /etc/hosts file.
5. When no more Enable actions are required, enter q to redisplay the RDR
Alarm Display Editor menu.
1 Disable "All-Displays"
2 Disable "All-Xterminal-Displays"
3 Disable "All-GO-Global-Displays"
4 Disable specific display ( of Xterminal )
5 Remove all Rules ( only console enabled )
Overview
This chapter describes how to configure backup components to act as
repositories for RDR replicas. You can also view the status of all primary
component instances (configured or pending), and details of replicas that were
created for various configured instances on the backup server.
The configuration procedure assumes that the system has already been prepared
and installed in the relevant stations, as described in Chapter 2, Preliminary
Requirements.
The examples provided relate primarily to ems screens and scripts. The enm or
nms screens and scripts are very similar. Any significant differences are noted.
Directly after configuring the primary and backup components, it is
recommended to test the backup configuration by performing an initial manual
backup and by scheduling automatic backup sessions at set intervals (see
Chapter 7, Creating and Scheduling Backups of Primary Component
Instances).
The mirror component configuration may be postponed until mirror
functionality is required.
8. Repeat steps 6 and 7 until all the required instances have been selected.
Then enter q.
NOTE: If the backup server and mirror component share the same
host, you can configure the mirror component immediately after the
backup component is configured (see Chapter 6, Configuring Mirror
Components).
2. A prompt follows enabling viewing details of replicas (if any) created from
instances configured on the backup server. Enter y to view replica status.
Do you want to see Replica status? y
If no replicas are found (for example, when the backup server has just been
configured and not yet activated), the following appears:
NOTES:
Configure the shadow backup server only after performing an
initial manual backup of each instance to test the replication
process (see Chapter 7, Creating and Scheduling Backups of
Primary Component Instances). This provides the backup data
necessary to form a shadow replica.
It is recommended to postpone shadow backup configuration
until all basic components (including mirror components) have
been configured.
SyncShadow is not available in previous RDR versions.
The SyncShadow utility has the following usage parameters and options:
Usage: SyncShadow [-s|-shadow shadow_server] [-c|-config] [-u|-unconfig]
[-dd debug_level] [-help]
Options:
-s | -shadow Synchronize the specified shadow component
-c | -configure Configure this host as a shadow component
-u | -unconfigure Remove the shadow component configuration from this host
-dd level Specify debug level (for troubleshooting only)
-h | -help Display the Usage and Options details shown here
NOTE: Do not forget to remove the crontab entry from the backup
server (see Action List menu in To define a backup schedule, page
7-4).
Overview
This chapter describes how to configure the mirror components of the system
to recover from a selected backup host in the event of a primary failure. (The
specific instance and replica on that host is selected when the mirror is
activated – see Chapter 8, Recovering to a Mirror Component.)
The configuration procedure assumes that the system has already been prepared
and installed in the relevant stations, as described in Chapter 2, Preliminary
Requirements.
The examples provided relate primarily to ems screens and scripts. The enm or
nms screens and scripts are very similar. Any significant differences are noted.
Overview
This chapter describes how to create or schedule regular backups or static
archives, and view crontab entries.
The examples provided relate primarily to ems screens and scripts. The enm or
nms screens and scripts are very similar. Any significant differences are noted.
The backup server configuration must be completed (see Chapter 5,
Configuring Backup Components) before activating a primary component.
NOTE: Archive replicas occupy valuable disk space. Use them only
when necessary.
Tue Aug 6 16:49:02 IST 2013 Start instance "enm" cache backup
Exit Code: 0
Tue Aug 6 16:49:03 IST 2013 End of instance "enm" cache backup.
Tue Aug 6 16:49:07 IST 2013 MainComp -> StandbyComp enm (replica
- 1) ... OK
Press Return to continue...
nms
0% 50% 100%
| | | | |
........................................
b. If you enter h for Hours, the script provides prompts for both hour and
minute selections. If a 2-hour and 30-minute interval is specified,
backups are automatically triggered at 2:30, 5:00, 7:30, … of each day.
A prompt for an offset value appears, enabling you to distribute the
backup loads for different components/instances.
Enter time offset (min) [default=0] [0-59,?] 0
5. If you select Schedule action at specific time from the RDR Scheduler
menu, the following appears.
Enter a time of day ( HH:MM ) [?] 12:34
Enter the time when the backup should start in the specified format (for
example, for 24 hour clock 1pm is entered as 13:00).
*****************************************
* REMINDER: Numbering of week days: *
* *
* Sun - 0 , Mon - 1 *
* Tue - 2 , Wed - 3 *
* Thu - 4 , Fri - 5 *
* Sat - 6 *
* *
*****************************************
"Wed" is chosen
"Sat" is chosen
4. Select the option Show existing cron tab …. The crontab entries appear.
Crontab content on MainComp:
10 3 * * 0,4 /etc/cron.d/logchecker
10 3 * * 0 /usr/lib/newsyslog
15 3 * * 0 /usr/lib/fs/nfs/nfsfind
1 2 * * * [ -x /usr/sbin/rtc ] && /usr/sbin/rtc -c > /dev/null
2>&1
30 3 * * * [ -x /usr/lib/gss/gsscred_clean ] &&
/usr/lib/gss/gsscred_clean
0,20,40 * * * * /opt/RDR/bin/SyncMaster -t enm >>
/var/tmp/RDR.log.enm
0,20,40 * * * * /opt/RDR/bin/SyncMaster -t ems >>
/var/tmp/RDR.log.ems
0,20,40 * * * * /opt/RDR/bin/SyncMaster -t nms -np -- -a >>
/var/tmp/RDR.log.nms
5. After viewing the entries, enter q and then press Enter. The Actions menu
reappears.
NMS Actions Menu
Overview
This chapter describes how to start a mirror station from any backed up replica
in the event of a primary station failure.
Mirror components are normally in standby mode, meaning the instance on the
mirror component is installed but not running and ready for a command to
launch the recovery process. When a primary component fails, the operator can
start a mirror station from any backed up replica. The mirror site is instructed
from which database replica to recover. After database synchronization is
completed, work can carry on as usual.
When the primary component is ready to be returned to operation, the reverse
update procedure is used to load the primary component with changes that
occurred to the system when the mirror component was active. See Chapter 9,
Restarting the Primary Instance After Recovery (Reverse Update).
The examples provided relate primarily to ems screens and scripts. The enm or
nms screens and scripts are very similar. Any significant differences are noted.
The procedure is in two main parts:
1. Restoring to the mirror component, as described on page 8-2.
2. Setting the mirror component with required parameters from the primary
component. For details, see Setting the Mirror Component, page 8-7.
On a system with LightSoft and EMS(s), first start the LightSoft server and
then the EMS(s), so that each EMS is registered at the LightSoft server.
Upon successful completion of the recovery session, start the application in the
regular way.
(This special purpose Actions menu differs from the generic version
presented on page 3-4.)
****************************************************
(The backup component may have replicas from more than one primary
component. If so, an option is presented for each primary component and
instance combination.)
****************************************************************
* A T T E N T I O N !!! *
* *
* 1. All local databases current data will be lost !! *
* *
* 2. Be sure that routing and network interfaces are *
* set properly for application being restored. *
* *
* 3. Be sure that you have valid licenses to run *
* applications on Mirror Component. *
* *
* *
* Network Management Dept *
* Optical Networks Division *
* ECI Telecom Ltd. *
* *
****************************************************************
-----------------------------------------------
| |
| Recovery session ended successfully. |
| |
-----------------------------------------------
9. nms only
The following script appears, in continuous display - no user responses are
required.
0% 50% 100%
| | | | |
........................................
device = `/tmp/versant/db/backup//level0/nms_db'
position = `0'
capacity = `dynamic'
blocking = `10 Kilobytes'
device = `/tmp/versant/db/backup//level2/nms_db'
position = `0'
capacity = `dynamic'
blocking = `10 Kilobytes'
0% 50% 100%
| | | | |
........................................
device = `/tmp/versant/db/backup//level1/nms_db'
position = `0'
capacity = `dynamic'
blocking = `10 Kilobytes'
device = `/tmp/versant/db/backup//level2/nms_db'
position = `0'
capacity = `dynamic'
blocking = `10 Kilobytes'
0% 50% 100%
| | | | |
........................................
-----------------------------------------------
| |
| Recovery session ended successfully. |
| |
-----------------------------------------------
End of script
11. Repeat steps 3 to 10 to restore the next backup set, else enter q or press
Enter at successive prompts to return to the RDR Main menu.
AND/OR
AND/OR
In the Mirror site, activate the required LightSoft clients on the mirror
component, as follows:
If only a LightSoft client is to be activated on the mirror (the LightSoft
server remains active on the primary site), enter
/opt/NMS/client/sh/ConfigureNMS.sh
OR
If the LightSoft server is distributed amongst multiple servers, select
Configure NMS cluster (valid for LightSoft V 2)
OR
If both the LightSoft server and a LightSoft client are to be activated on
the same mirror, enter /opt/NMS/server/sh/ConfigureNMS.sh
No actions are required on either LightSoft clients or EMSs on the primary site.
In the Mirror site, activate the required EMSs on the mirror component as
follows:
1. Update ems.conf or enm.conf by modifying the expression
R &env_mtnm_ems_no EMS_INSTANCE_NUMBER ### 1 999
substituting ### with the EMS ID of the Primary EMS
Overview
This chapter describes how to perform a Reverse Update session to return the
primary component to normal operation. The process involves loading the
primary component with changes that occurred in the system since the mirror
component was activated.
Reverse Update is performed as a cold backup session and must be
implemented only when instance applications on mirror and primary
components are down.
The procedure includes two main steps:
1. Performing Reverse Update to the primary component (see Performing
Reverse Update, page 9-2).
2. Setting the other components to recognize that the primary component has
been returned to duty in place of the mirror component (see Recognizing
the Primary Component, page 9-5).
The examples provided relate primarily to ems screens and scripts. The enm or
nms screens and scripts are very similar. Any significant differences are noted.
********************************************************
* A T T E N T I O N !!! *
* *
* All local databases current data will be lost !!*
* *
* *
********************************************************
6. EMS or SYNCOM/XDM
A “Restore completed successfully” message appears.
Checking connectivity to mirror component:
------------------------------------------
MainComp -> 147.234.144.30 ... OK
At the end of processing, press Return to redisplay the Actions menu and
continue to step 8.
Exit code: 0
0% 50% 100%
| | | | |
........................................
0% 50% 100%
| | | | |
........................................
No user actions are required. Ignore the prompts “Would you like to do
another level of restore” and “remember to remove”.
RDR
SyncMaster
Options:
-t Instance tag (required)
-b Backup server name or IP (default – Backup Server)
dest Use specific backup target folder
-a Archive backup
-suspend Temporarily suspend synchronization
-continue Continue synchronization (if suspended)
-v Verbose mode
-i Interactive mode
-h This message
RDR.config
RestartMirror
Usage: RestartMirror
[-t|-tag] [-b hostname] [-nt|-no_trans] [-help]
Options:
-t Restore from specified instance
-b hostname Restore from specified backup component
-nt Restore from previous found cache on mirror component
-help This message
ReverseUpdate
Options:
hostname Mirror Component name or IP (required)
-t tag Instance tag (required)
-D Debug mode
SetCronRDR
LocalBackup
NOTE:
LocalBackup can be performed at any time and does not require
RDR configuration.
The instance for an action is derived from current UNIX user
(nms/enm/ems).
RestoreLocal
Restores an RDR instance from a local backup copy on the same host.
Usage: RestoreLocal [ -d backup dir]
Options:
-d backup dir Specify directory to backup to ( default: - $HOME/BACKUP)
NOTE:
RestoreLocal can be performed at any time and does not require
RDR configuration.
The instance for an action is derived from the current UNIX user
(nms/enm/ems).
E P
EMS Configurations • 1-12 Preliminary Requirements Before
Installation • 2-1
F
application requirements • 2-1
Frequencies and wavelengths • 1 backup server disk capacity • 2-2
Functional Description • 1-2 communications and bandwidth • 2-3
components • 1-2 Primary Components • 1-3
instances • 1-4 backing up • 7-1
replicas • 1-5 configuration procedure • 4-3
G messages display configuration • 4-8
reactivating • 9-1
Glossary of Terms • 1
suspending or resuming operation • 1
I
Primary-to-Mirror Configurations • 1-9
Installation Requirements • See 1 to 1 • 1-10
Preliminary Requirements Before
2 to 2 • 1-11
Installation
N to 2 • 1-12
Instances • 1-4
LightSoft backup levels • 1-6 R
viewing status • 5-5 RDR
L configurations • 1-8
functional description • 1-2
LightSoft Instance Configurations • 1-13
terminology • 1-1
LocalBackup Command • 4
what is? • 1-2
M RDR Commands • 1
Main Menu • 3-2 LocalBackup • 4
Menus • See RDR Menus RDR • 1
Messages Display Configuration • 4-8 RDR.config • 2
Mirror Components • 1-4 Restart Mirror • 2
application auto start • 6-3 RestoreLocal • 4
configuration procedure • 6-1 Reverse Update • 3
reconfiguring • 6-3 SetCronRDR • 3
recovery to • 8-1 SyncMaster • 2
Mirror Station Application Requirements RDR Menus • 3-1
• 2-2 Configuration menu • 3-3
N Main menu • 3-2
N to 2 Configuration • 1-12 Utilities/Actions menu • 3-4
RDR.config Command • 2