Skip to main content

"group"

The "group" object contains actions to manage availability groups.

Examples

"create" with publication definition example

{
  "memphis": {
    "name": "MEMPHIS",
    "uid": "admin",
    "pwd": "ADMIN",
    "port": "7597"
  },
  "options": {
    "profile": true,
    "replace": true,
    "ignoredeploy": false,
    "recursivedel": false,
    "recursivesearch": true
  },
  "group": {
    "actions": [
      "create"
      ],
    "name": "group1",
    "engines":[
      {
        "name":"FAIRCOMS@HOST100",
        "primary":true,
        "synchronized":true,
        "publication": {
          "name": "pubctreeSQL",
          "create":  true,
          "mode": "db",
          "dbname": "ctreeSQL"
        }
      },
      {
        "name":"FAIRCOMS@HOST450",
        "synchronized":true,
        "primary":false
      }
    ]
  }
}
{
  "memphis": {
    "name": "MEMPHIS",
    "uid": "admin",
    "pwd": "ADMIN",
    "port": "7597"
  },
  "options": {
    "profile": true,
    "replace": true,
    "ignoredeploy": false,
    "recursivedel": false,
    "recursivesearch": true
  },
  "group": {
    "actions": [
      "create",
      "deploy",
      "start"
    ],
    "name": "group001040",
    "engines":[
      {
        "name":"FAIRCOMS@HOST001",
        "primary":true,
        "synchronized":true,
        "publication": {
          "name": "pubFiles",
          "create":  false
        }
      },
      {
        "name":"FAIRCOMS@HOST040",
        "synchronized":true,
        "primary":false
      }
    ]
  }
}
{
  "memphis": {
    "name": "MEMPHIS",
    "uid": "admin",
    "pwd": "ADMIN",
    "port": "7597"
  },
  "group": {
    "actions": [
      "deploy"
    ],
    "name": "group0012"
  }
}
{
  "memphis": {
    "name": "MEMPHIS",
    "uid": "admin",
    "pwd": "ADMIN",
    "port": "7597"
  },
  "options": {
    "profile": true,
    "ignoredeploy": true
  },
  "group": {
    "actions": [
      "start"
    ],
    "name": "groupCompany12"
  }
}
{
  "memphis": {
    "name": "MEMPHIS",
    "uid": "admin",
    "pwd": "ADMIN",
    "port": "7597"
  },
  "group": {
    "actions": [
      "stop"
    ],
    "name": "availGroup57"
  }
}
{
  "memphis": {
    "name": "MEMPHIS",
    "uid": "admin",
    "pwd": "ADMIN",
    "port": "7597"
  },
  "group": {
    "actions": [
      "delete"
    ],
    "name": "availGroup46"
  }
}

Property summary

Table 1. "group" action summaries

Property

Description

"create"

creates an availability group

"deploy"

deploys the specified availability group

"start"

starts a previously stopped availability group

Note

The plan or group should be deployed to be started correctly, but the "ignoredeploy" main option can override this constraint.

"stop"

stops the specified availability group

"delete"

deletes the specified availability group



The "create" action creates a new group.

Property summary

Table 2. "create" action summaries

Property

Description

Type

"name"

defines the name of the group

string

"engines"

contains a list of servers composing the availability group

array of objects



the "deploy" action starts the deployment of the specified replication plan.

Things to know:
  • "deploy" can be specified together with the "create" action.

  • If the group already exists, only the group name is required.

  • The "deploy" action implies the start of the group.

  • This action can be specified together with the "create" action

The "delete" action deletes the specified availability group.

Things to know:
  • The related replication plan that was created by the group deployment and its publication will not be deleted by the operation.

  • The "stop" action can be run together with "delete".