C コマンドライン・インタフェース・リファレンス

この項を確認してodacli create-applianceコマンドについて理解し、JSONファイルの例を確認します。

内容は次のとおりです。

odacli create-applianceコマンドのreadme
readmeおよびJSONファイルの例を使用してJSONファイルを作成し、コマンドライン・インタフェースを使用してアプライアンスを作成します。
odacli create-applianceコマンドJSONファイルの例
次のJSONファイルの例およびreadmeを使用して、コマンドライン・インタフェースでのアプライアンスの作成に使用できるJSONファイルを作成します。

odacli create-applianceコマンドのReadme

readmeおよびJSONファイルの例を使用してJSONファイルを作成し、コマンドライン・インタフェースを使用してアプライアンスを作成します。

readme

提供されているJSONファイルの例に加え、このreadmeを慎重に検討します。環境および要件に基づいて、必要な変更を加えたJSONファイルを作成します。このページの例およびreadmeは、/opt/oracle/dcs/sampleディレクトリにもあります。

注意:

JSONファイルを作成する前に、readmeおよび例を慎重に検討することが重要です。設定に基づいてネットワークおよびOracle ILOMの情報を正しく入力していない場合は、ホストおよびOracle ILOMへのネットワーク・アクセスが失われます。

定義

instance:
name: display name for the appliance instance resource
instanceBaseName: This is the base name used for the service to derive the names for the other entities
dbEdition: Enter "EE" for enterprise edition, or "SE" for standard edition
timeZone: OS timeZone
ntpServers: IP address for ntp server configured in /etc/ntp.conf, enter null if NTP is not configured
dnsServers: IP address for DNS server configured in /etc/resolv.conf, enter null if dns is not configured.
domainName: domain name (for example, example.com)
isRoleSeperated: true|false
set isRoleSeperated=true if role separation is required during the installation.
need to specify 6 groups and two users. groupName and userName can be customized
Set isRoleSeperated=false if role separation is not required.
Need to specify 2 groups and one user. groupName and userName can be customized
nodes:
nodeNumber: 0 (Use 0 for ODA S|M|L)
nodeName: the Name used to configure the host name.
network:
nicName: the NIC name used for the network.
For ODA S: btbond1, sfpbond1
For ODA M: btbond1, btbond2, sfpbond1
For ODA L: btbond1, btbond2, sfpbond1
ipAddress: IP address for this network
subNetMask: subnet mask for this network
gateway: gateway address for this network
networkType: Public|Backup|Other
isDefaultNetwork: true|false
ilom:
ilomName: ilom name
ipAddress: ilom ip address
subNetMask: subnet mask for the ilom network
gateway: gateway for ilom network

grid:
diskGroup: (ODA S|M|L contains DATA and RECO Diskgroups)
diskgroupName: DATA|RECO
redundancy: Normal|High (for 2 NVMEs, only Normal is supported, for 4 NVMEs, both Normal and High is supported)
diskPercentage: Percentage of NVMe drive capacity is used for this particular diskgroup.
language: language used for GI installation

database:
dbName: dbname for the database
dbVersion: Use "12.1.0.2" for 12c database, "11.2.0.4" for 11.2 database.
instanceOnly:
true: only database instance is created without any data files
false: create a complete database (with datafiles, redo logs, etc)
isCdb: "true" if this database is container DB. Only valid for 12.1.0.2 database. "False" if this is non-cdb
pdBName: pdbName if isCdb is "true", use "null" if isCdb is "false"
pdbAdminuserName: pdb admin user name, use "null" if isCdb is "false"
adminPassword: master password for the database.
dbType: use "SI" , single instance database for ODA S|M|L
dbTargetNodeNumber: use "0" for ODA S|M
dbClass: OLTP|DSS|IMDB. For SE, only OLTP is supported. For EE, OLTP, DSS, IMDB(12c db only) are supported
dbShape: database shape, decide which database template to use for this database.
dbStorage: ACFS|ASM. Only ACFS is supported for 11.2.0.4. Both ACFS and ASM are supported for 12.1.0.2.
dbCharacterSet: Characterset for this database.
dbConsoleEnable: true|false. Whether or not to create dbconsole (11.2.0.4) or EM express (12.1.0.2)

asr:
userName/password: username/password for the ASR
proxyServerName/proxyPort/proxyUserName/proxyPassword: information about proxy server.
snmpVersion: use "v3"

odacli create-applianceコマンドのJSONファイルの例

次のJSONファイルの例およびreadmeを使用して、コマンドライン・インタフェースでのアプライアンスの作成に使用できるJSONファイルを作成します。

odacli create-applianceコマンドを使用するには、JSONファイルを作成する必要があります。ここにあるJSONファイルの例およびreadmeの情報をテンプレートとして使用して、環境に応じたファイルを作成できます。このページの例およびreadmeは、/opt/oracle/dcs/sampleディレクトリにもあります。

注意:

JSONファイルを作成する前に、readmeおよび例を慎重に検討することが重要です。設定に基づいてネットワークおよびOracle ILOMの情報を正しく入力していない場合は、ホストおよびOracle ILOM両方へのネットワーク・アクセスが失われます。

例C-1 Oracle Database Appliance X6-2をロール分離で作成するためのJSONファイル

次の記述は、Oracle Database Appliance X6-2S、X6-2MまたはX6-2Lの作成に使用されるJSONファイルの例です。この例ではロール分離を使用しています。

$ cat create-appliance.json
{
  "instance" : {
    "name" : "odambox",
    "instanceBaseName" : "odambox",
    "dbEdition" : "EE",
    "timeZone" : "UTC",
    "ntpServers" : ["10.0.3.14"],
    "dnsServers" : ["10.0.4.10","10.0.4.11","10.0.4.12"],
    "domainName" : "example.com",
    "isRoleSeparated" : true,
    "osUserGroup" : {
      "groups" : [ {
        "groupId" : 1001,
        "groupName" : "oinstall",
        "groupRole" : "oinstall"
      }, {
        "groupId" : 1002,
        "groupName" : "dbaoper",
        "groupRole" : "dbaoper"
      }, {
        "groupId" : 1003,
        "groupName" : "dba",
        "groupRole" : "dba"
      }, {
        "groupId" : 1004,
        "groupName" : "asmadmin",
        "groupRole" : "asmadmin"
      }, {
        "groupId" : 1005,
        "groupName" : "asmoper",
        "groupRole" : "asmoper"
      }, {
        "groupId" : 1006,
        "groupName" : "asmdba",
        "groupRole" : "asmdba"
      } ],
      "users" : [ {
        "userId" : 1000,
        "userName" : "oracle",
        "userRole" : "oracleUser"
      }, {
        "userId" : 1001,
        "userName" : "grid",
        "userRole" : "gridUser"
      } ]
    }
  },
  "nodes" : [ {
    "nodeNumber" : "0",
    "nodeName" : "odambox",
    "network" : [ {
       "nicName" : "btbond1",
       "ipAddress" : "10.0.1.11",
       "subNetMask" : "255.255.255.0",
       "gateway" : "10.0.1.1",
       "networkType" : [ "Public" ],
       "isDefaultNetwork" : true
      },
      {
       "nicName" : "btbond2",
       "ipAddress" : "192.168.18.24",
       "subNetMask" : "255.255.255.0",
       "gateway" : "192.168.18.1",
       "networkType" : [ "Backup" ],
       "isDefaultNetwork" : false
      }
    ],
    "ilom" : {
      "ilomName":"odambox-c",
      "ipAddress":"10.0.2.10",
      "subNetMask":"255.255.255.0",
      "gateway":"10.0.2.1"
     }
  } ],
  "grid" : {
    "diskGroup" : [ {
      "diskGroupName" : "DATA",
      "redundancy" : "NORMAL",
      "diskPercentage" :70
    }, {
      "diskGroupName" : "RECO",
      "redundancy" : "NORMAL",
      "diskPercentage" :30
    } ],
    "language" : "en"
  },
  "database" : {
    "dbName" : "db1",
    "dbVersion" : "12.1.0.2",
    "instanceOnly" : false,
    "isCdb" : true,
    "pdBName" : "pdb1",
    "pdbAdminuserName" : "pdbuser",
    "adminPassword" : "welcome1",
    "dbType" : "SI",
    "dbTargetNodeNumber" : "0",
    "dbClass" : "OLTP",
    "dbShape" : "odb1",
    "dbStorage" : "ACFS",
    "dbCharacterSet" : {
      "characterSet" : "AL32UTF8",
      "nlsCharacterset" : "AL16UTF16",
      "dbTerritory" : "AMERICA",
      "dbLanguage" : "AMERICAN"
    },
    "dbConsoleEnable" : false
  },
  "asr" :{
    "userName":"john.smith@example.com",
    "password":"xxxxx",
    "proxyServerName":"www-proxy.example.com",
    "proxyPort":"80",
    "proxyUserName":"",
    "proxyPassword":"",
    "snmpVersion":"v3"
  }
}

例C-2 Oracle Database Appliance X6-2をロール分離で作成するためのJSONファイル

次の記述は、ロール分離を使用しないOracle Database Appliance X6-2S、X6-2MまたはX6-2Lの作成に使用されるJSONファイルの例です。この例では、2つのグループ(oinstallとdba)および単一のユーザー("oracle")を作成します。


  
$ cat create-appliance.json
{
  "instance" : {
    "name" : "odambox",
    "instanceBaseName" : "odambox",
    "dbEdition" : "EE",
    "timeZone" : "UTC",
    "ntpServers" : ["10.0.3.14"],
    "dnsServers" : ["10.0.4.10","10.0.4.11","10.0.4.12"],
    "domainName" : "example.com",
    "isRoleSeparated" : false,
    "osUserGroup" : {
      "groups" : [ {
        "groupId" : 1001,
        "groupName" : "oinstall",
        "groupRole" : "oinstall"
      }, {
        "groupId" : 1002,
        "groupName" : "dba",
        "groupRole" : "dba"
      } ],
     "users" : [ {
        "userId" : 1000,
        "userName" : "oracle",
        "userRole" : "oracleUser"
      } ]
    }
  },
  "nodes" : [ {
    "nodeNumber" : "0",
    "nodeName" : "odambox",
    "network" : [ {
       "nicName" : "btbond1",
       "ipAddress" : "10.0.1.11",
       "subNetMask" : "255.255.255.0",
       "gateway" : "10.0.1.1",
       "networkType" : [ "Public" ],
       "isDefaultNetwork" : true
      },
      {
       "nicName" : "btbond2",
       "ipAddress" : "192.168.18.24",
       "subNetMask" : "255.255.255.0",
       "gateway" : "192.168.18.1",
       "networkType" : [ "Backup" ],
       "isDefaultNetwork" : false
      }
    ],
    "ilom" : {
      "ilomName":"odambox-c",
      "ipAddress":"10.0.2.10",
      "subNetMask":"255.255.255.0",
      "gateway":"10.0.2.1"
     }
  } ],
  "grid" : {
    "diskGroup" : [ {
      "diskGroupName" : "DATA",
      "redundancy" : "NORMAL",
      "diskPercentage" :70
    }, {
      "diskGroupName" : "RECO",
      "redundancy" : "NORMAL",
      "diskPercentage" :30
    } ],
    "language" : "en"
  },
  "database" : {
    "dbName" : "db1",
    "dbVersion" : "12.1.0.2",
    "instanceOnly" : false,
    "isCdb" : true,
    "pdBName" : "pdb1",
    "pdbAdminuserName" : "pdbuser",
    "adminPassword" : "welcome1",
    "dbType" : "SI",
    "dbTargetNodeNumber" : "0",
    "dbClass" : "OLTP",
    "dbShape" : "odb1",
    "dbStorage" : "ACFS",
    "dbCharacterSet" : {
      "characterSet" : "AL32UTF8",
      "nlsCharacterset" : "AL16UTF16",
      "dbTerritory" : "AMERICA",
      "dbLanguage" : "AMERICAN"
    },
    "dbConsoleEnable" : false
  },
  "asr" :{
    "userName":"john.smith@example.com",
    "password":"xxxxx",
    "proxyServerName":"www-proxy.example.com",
    "proxyPort":"80",
    "proxyUserName":"",
    "proxyPassword":"",
    "snmpVersion":"v3"
  }
}