Command Central 10.1 | Command Central Developer Reference | Using the Command Line Interface | Provisioning Bootstrap Installers Commands | sagcc exec provisioning bootstrap nodes
 
sagcc exec provisioning bootstrap nodes
DEPRECATED. Installs a Platform Manager node on a local or remote machine and registers the new Platform Manager installation under a specified node alias.
Use the Command Central bootstrap installer to bootstrap Platform Manager installations for releases 9.12 and higher. You can download the Command Central bootstrap installer for the release that you want from the Empower Product Support website. Save the downloaded Command Central bootstrap installer file into the $CC_HOME/profiles/CCE/data/installers directory, so that you can use the installer in the nodes section of the composite templates to bootstrap remote Platform Manager installations.
Syntax
*Command Central syntax:
*With an input file:
sagcc exec provisioning bootstrap nodes nodeAlias 
{--input | -i}  filename{.xml | .json}
*With arguments:
sagcc exec provisioning bootstrap nodes nodeAlias [hostname=hostname]  
[repoName=name] [platform=platform] [installDir=directory]
[httpPort=port] [httpsPort=port] [options]
*Not supported on Platform Manager.
Options
Option
Description
{--input | -i} filename{.xml | .json}
Optional. Input file in XML or JSON format that contains bootstrap installation details. For more information, see input.
You can either use an input data file or specify arguments for the command. For an example of a bootstrap details XML file, see the Usage Notes section.
nodeAlias
Required. Alias name of the bootstrapped Platform Manager installation that you want to add to the target machine.
[hostname=hostname]
Optional. Host name of the machine on which to install the Platform Manager node. The default is localhost.
[repoName=name]
Optional. Name of the product repository, registered in Command Central from which the bootstrap installer image is created.
When you do not include this parameter, the command uses the product repository with the latest version.
If no repositories are registered in Command Central, the command returns an error.
[platform=platform]
Optional. ID of the target operating system of the bootstrap installer.
When you do not include this parameter, the command uses the operating system on the localhost machine.
[installDir=directory]
Optional. Directory in which to install the bootstrap Platform Manager installation. The value for the installDir argument is platform independent and Command Central resolves the format of the installation directory path based on the target operating system. For example, if you specify installDir=/opt/softwareag, Command Central resolves the format of the installation directory path to C:\opt\softwareag on Windows.
[httpPort=port]
Optional. HTTP port for the bootstrapped Platform Manager installation. The default is 8092.
[httpsPort=port]
Optional. HTTPS port for the bootstrapped Platform Manager installation. The default is 8093.
[options]
Optional. Any common option supported by the Command Line Interface (see Common Options)
Usage Notes
*You can use this command to install Platform Manager only if the target UNIX or Windows operating systems have Open Secure Shell (OpenSSH) installed and are configured for remote access. For information about how to install and configure OpenSSH on Windows operating systems, see the OpenSSH documentation.
*After you execute the sagcc exec provisioning bootstrap nodes command, use the sagcc get landscape nodes command to verify the node status. For example:
sagcc get landscape nodes sag01 --expected-values ONLINE  
--wait 60 --check-every 5
where “sag01” is the alias name of the bootstrapped Platform Manager installation.
When the execution of the sagcc get landscape nodes command is successful, you can apply templates onto the new Platform Manager installation. For more information about the --expected-values, --wait, and --check-every options see expected-values, wait, and check-every.
*Following is an example of a bootstrap details XML file required for bootstrapping a Platform Manager installation:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bootstrapInfo>
<repoName>webMethods-9.12_US</repoName>
<version>latest.integration</version>
<platform>OSX</platform>
     <distribution>DEF</distribution>
<useImage>true</useImage>
<hostname>localhost</hostname>
<protocol>SSH</protocol>
<port>22</port>
<credentials>
         <authenticationType>BASIC</authenticationType>
         <authenticationMethod>INTERACTIVE</authenticationMethod>
         <userName>Administrator</userName>
         <password>manage</password>
     </credentials>
     <installDir>/some/dir</installDir>
     <installJava>false</installJava>
     <httpPort>1234</httpPort>
     <httpsPort>1235</httpsPort>
</bootstrapInfo>
Valid values for the <authenticationMethod> parameter are PASSWORD (default), INTERACTIVE, and CERTIFICATE.
Examples When Executing on Command Central
*To install a Platform Manager from the latest version of a bootstrap image generated from a node with alias name “sag01”, HTTP port “8092”, and HTTPS port “8093”, in the “c:\install\test” directory on a local node:
sagcc exec provisioning bootstrap nodes  sag01  
installDir=c:\install\test httpPort=8092 httpsPort=8093
*To install a Platform Manager from a bootstrap image with alias name “sag01”, default authentication credentials, and default installation details (such as ports, installation directory, and distribution type) on a remote node with host name “rubicon” and operating system “LNXADM64”:
sagcc exec provisioning bootstrap nodes sag01  hostname=rubicon 
platform=LNXADM64
*Bootstrap installation details are in the boostrapInfo.xml file. To install a Platform Manager from a bootstrap image with alias name “sag01”, using the details in the bootstrapInfo.xml file:
sagcc exec provisioning bootstrap nodes sag01 --input bootstrapInfo.xml