Software AG Command Central 10.0 | Command Central Developer Reference | Using the Command Line Interface | Provisioning Bootstrap Installers Commands | sagcc exec provisioning bootstrap nodes
 
sagcc exec provisioning bootstrap nodes
Installs a bootstrap installer image on a local or remote machine and registers the new Platform Manager installation under a specified node alias.
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] [version=version] [distribution=type]  
[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 bootstrap installer image. The default is localhost.
[repoName=name]
Optional. Name of the product repository from which the bootstrap installer image is created.
When you do not include this parameter, the command uses:
*The product repository that matches the version specified in the version=version argument
*If the version=version argument is not specified, the registered repository for the latest version.
*If only one product repository is registered in Command Central, that repository.
If no repositories are registered in Command Central, the command returns an error.
[version=version]
Optional. Version of the product repository from which the bootstrap installer image is created.
Valid values are:
*major version (for example, 9)
*major.minor version (for example, 9.6)
*latest
If Command Central cannot match the specified version to a registered product repository, Command Central returns an error.
When you do not include this parameter, the command uses the latest version available in the product repository.
[distribution=type]
Optional. Software distribution in the bootstrap installer image. Valid values are:
*MIN. Platform Manager only.
*DEF. Platform Manager, Update Manager and the Command Central command line interface.
*ALL. Platform Manager, Update Manager, the Command Central command line interface, and all Platform Manager product plug-ins.
If you do not specify a value, the command includes the complete distribution.
[platform=platform]
Optional. ID of the target operating system of the bootstrap installer image.
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 or C:\opt\softwareag on Windows.
[httpPort=port]
Optional. HTTP port for the bootstrap Platform Manager installation. The default is 8092.
[httpsPort=port]
Optional. HTTPS port for the bootstrap Platform Manager installation. The default is 8093.
[options]
Optional. Any 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 bootstrap Platform Manager installation.
When the execution of the sagcc get landscape nodes command is successful, you can apply templates to the bootstrap 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 installing a bootstrap Platform Manager installation:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>        
<bootstrapInfo>        
     <repoName>webMethods-9.6_US</repoName>        
     <version>latest.integration</version>        
     <platform>OSX</platform>        
     <distribution>ALL</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
Copyright © 2013-2017 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release