Skip to main content
************* PRERELEASE CONTENT *************

MapMirrors

Define mirror members for mirrors that include this instance.

Synopsis

[MapMirrors.m]    Name=a,b,c,d,e,f,g,h,i,j,k,l,m,n

Description

For each mirror (m) connected to the current instance, InterSystems IRIS® data platform creates a section in the CPF called [MapMirrors.m], which contains an entry for all instances connected to that mirror. The entries are made up of a Name and 14 comma-separated values (an), as follows:

  • Name – Required. Unique name identifying this member within the mirror. An uppercase alphanumeric string with a maximum length of 15 characters, cannot contain spaces or tabs, commas (,), semicolons (;), or equal signs (=), and is converted to uppercase before saving.

    This is the name of this instance in this mirror. Mirror system names must be unique across all of the mirrors as an instance has a single mirror system name which may appear in multiple mirror sets (that is, an async member may connect to multiple mirrors). For the most part the GUID is used to identify a mirror member, the Name is used for display purposes. The name cannot contain a colon (:) .

  • a (AgentAddress) – The network address (IP address preferred to avoid DNS issues) that mirror members which connect to the primary should use to contact the Agent on this failover member. This is omitted on async members as the agent is not used for mirroring on those instances. This is required on failover members. The agent can transfer journal data so a private address may be desirable here to avoid network congestion.

  • b (AgentPort) – Port # which the agent on this instance is configured to listen on. ##class(SYS.Agent).GetApplicationPort() returns the current value if the local agent is active.

  • c – For internal use.

  • d (SuperServerAddress) – The network address used to connect to the primary by external mirror-aware systems (currently only ECP application servers, although in the future this may extend to other connections). Other mirror members may connect to a member's superserver address for control and monitoring purposes. When a member is primary, an async member attempts to establish its data channel (over which it receives journal data) using this address if the primary’s mirror private address (MirrorPrivate) is not accessible.

  • e (GUID) – Required. An internal GUID, unique to this mirror. Uniquly identifies this node in the mirror. Apart from identifying the nodes, primarily used to identify the instance that owns a particular copy of a mirrored database.

  • f (InstanceDirectory) – The installation directory of the instance (the parent of the mgr directory). Used primarily on failover members to identify the instance to the agent.

  • g (MemberType) – Numeric value indicating the type of mirror member. One of:

    • 0 - Failover member

    • 2 - Async member

  • h (MirrorPrivate) – When this instance is primary, other mirror members use this address to establish the mirror data channel, over which they receive journal data from the primary. Async members fall back to the primary’s superserver address (SuperServerAddress) if they cannot reach it at the mirror private address.

  • i (MirrorSSPort) – Superserver port for this instance. Used in conjunction with both the MirrorAddress and the ECPAddress by clients establishing connections to this instance.

  • j, k, l, m, and n – For internal use.

Example

Each entry is on one line:

[MapMirrors.MIMI]
MIMI_A=mirrorhostA,2188,,mirrorhostA,C7BA9224-3851-47D4-83BD,c:\intersystems\20142302july10a\,0,mirrorhostA,56776,,0,
MIMI_B=mirrorhostB,2188,,mirrorhostB,D14611B3-E0F5-4708-A111,c:\intersystems\20142302july10b\,0,mirrorhostB,56777,,0,
MIMI_D=mirrorhostD,2188,,mirrorhostD,06E1D307-59D9-4500-AA3B,c:\intersystems\20142302jul10d\,2,mirrorhostD,56779,,0,
Copy code to clipboard

Changing This Parameter

On the Create a Mirror page of the Management Portal (System Administration > Configuration > Mirror Settings > Create a Mirror), enter the requested information. You can edit an existing mirror on the Edit Mirror page, but only from the primary failover member.