ocf_heartbeat_db2(7)

1OCF_HEARTBEAT_DB2(7)          OCF resource agents         OCF_HEARTBEAT_DB2(7)
2
3
4

NAME

6       ocf_heartbeat_db2 - Resource Agent that manages an IBM DB2 LUW
7       databases in Standard role as primitive or in HADR roles as
8       master/slave configuration. Multiple partitions are supported.
9

SYNOPSIS

11       db2 [start | stop | monitor | promote | demote | meta-data |
12           validate-all]
13

DESCRIPTION

15       Resource Agent that manages an IBM DB2 LUW databases in Standard role
16       as primitive or in HADR roles in master/slave configuration. Multiple
17       partitions are supported.
18
19       Standard mode:
20
21       An instance including all or selected databases is made highly
22       available. Configure each partition as a separate primitive resource.
23
24       HADR mode:
25
26       A single database in HADR configuration is made highly available by
27       automating takeover operations. Configure a master / slave resource
28       with notifications enabled and an additional monitoring operation with
29       role "Master".
30
31       In case of HADR be very deliberate in specifying intervals/timeouts.
32       The detection of a failure including promote must complete within
33       HADR_PEER_WINDOW.
34
35       In addition to honoring requirements for crash recovery etc. for your
36       specific database use the following relations as guidance:
37
38       "monitor interval" < HADR_PEER_WINDOW - (appr 30 sec)
39
40       "promote timeout" < HADR_PEER_WINDOW + (appr 20 sec)
41
42       For further information and examples consult
43       http://www.linux-ha.org/wiki/db2_(resource_agent)
44

SUPPORTED PARAMETERS

46       instance
47           The instance of the database(s).  (unique, required, string, no
48           default)
49
50       dblist
51           List of databases to be managed, e.g "db1 db2". Defaults to all
52           databases in the instance. Specify one db for HADR mode.
53           (optional, string, no default)
54
55       admin
56           DEPRECATED: The admin user of the instance.  (optional, string, no
57           default)
58
59       dbpartitionnum
60           The number of the partion (DBPARTITIONNUM) to be managed.
61           (optional, string, default 0)
62

SUPPORTED ACTIONS

64       This resource agent supports the following actions (operations):
65
66       start
67           Starts the resource. Suggested minimum timeout: 120.
68
69       stop
70           Stops the resource. Suggested minimum timeout: 120.
71
72       promote
73           Promotes the resource to the Master role. Suggested minimum
74           timeout: 120.
75
76       demote
77           Demotes the resource to the Slave role. Suggested minimum timeout:
78           120.
79
80       notify
81           Suggested minimum timeout: 10.
82
83       monitor
84           Performs a detailed status check. Suggested minimum timeout: 60.
85           Suggested interval: 20.
86
87       monitor (Master role)
88           Performs a detailed status check. Suggested minimum timeout: 60.
89           Suggested interval: 22.
90
91       validate-all
92           Performs a validation of the resource configuration. Suggested
93           minimum timeout: 5.
94
95       meta-data
96           Retrieves resource agent metadata (internal use only). Suggested
97           minimum timeout: 5.
98

EXAMPLE

100       The following is an example configuration for a db2 resource using the
101       crm(8) shell:
102
103           primitive p_db2 ocf:heartbeat:db2 \
104             params \
105               instance=string \
106             op monitor depth="0" timeout="60" interval="20" \
107             op monitor depth="0" timeout="60" role="Master" interval="22"
108
109           ms ms_db2 p_db2 \
110             meta notify="true" interleave="true"
111

AUTHOR

116       Linux-HA contributors (see the resource agent source for information
117       about individual authors)
118
119
120
121resource-agents 3.9.2             07/08/2011              OCF_HEARTBEAT_DB2(7)