Generation bootstrap installers and images

Why Generating Bootstrap Images and Installers?

You need to generate bootstrap images and installers to be able to bootstrap new installations from Command Central that is NOT configured with MASTER or MIRROR repositories.

Before you begin

IMPORTANT: Command Central MUST be configured with MASTER or MIRROR repositories

To properly generate bootstrap images and installers Command Central must have access to a MASTER or MIRROR repository for the target release version. If this does not apply to your Command Central instance you MUST perform this process on a Command Central that has access to these types of repositories.

To confirm you have MASTER or MIRROR repositories run this command, or use Web UI Repositories view

cc list repository products -e "MASTER|MIRROR"
Display Name                      Type
webMethods-9.5                    MASTER
webMethods-9.6                    MASTER
webMethods-9.7                    MASTER
webMethods-9.8                    MASTER
webMethods-9.9                    MASTER
webMethods-9.9_mirror1            MIRROR
IMPORTANT: Repository names must follow default naming convention webMethods-{versionMajor.minor}_{optionalLabel}

Generation

Automatic Generation from Web UI

Command Central will automatically generate bootstrap image and/or installer when you attempt to bootstrap a new Installation from this Command Central. Use Web UI Add Installation wizard and select source MASTER or MIRROR repository for the desired release version, Complete distribution type and Push or Pull method.

If Push method is selected Command Central will generate bootstrap image only. The image will be registered as a new IMAGE repository with spm-all--release- name. The image .zip file will be saved under INSTALLDIR/profiles/CCE/data/images folder.

If Pull method was selected Command Central will generate both bootstrap image and the installer. The installer has the same name as the image and will be available under INSTALLDIR/profiles/CCE/data/installers folder.

NOTE: Image and installer generation starts when you click Finish in the wizard and will take at least 10 minutes to complete

Use Web UI Jobs view to monitor the progress

On Demand Generation from CLI

You can generate bootstrap images and installers using CLI. For example to generate installer and image for webMethods 9.7 on Linux run:

cc create provisioning bootstrap installers repoName=webMethods-9.7 platform=LNXADM64
ID Duration Status    Progress Description                                           
36        0 SCHEDULED        0 Make bootstrap installer spm-all-9.7-release-lnxamd64 

Use the following command to find out supported platform codes

cc list repository platforms local
Code     Display Name                    
OSX      Apple Mac OSX
SOLAMD64 Sun Solaris x86-64
LNX      Linux RHEL and SLES x86
W64      Microsoft Windows x86-64
HP11     HP HP-UX PA-RISC
HP11IT   HP HP-UX Intel Itanium
LNXS390X Linux RHEL and SLES IBM System z
AS400    IBM AS/400
WNT      Microsoft Windows x86
SOL      Sun Solaris SPARC
LNXAMD64 Linux RHEL and SLES x86-64
AIX      IBM AIX

Wait for bootstrap image creation to complete or use Web UI Jobs view to monitor the process.

cc list repository products properties=displayName -e "spm-all-9.7-release-lnxamd64" -w 1200 -c 60
Display Name                     
webMethods-9.6                   
cc-all-9.9-release-osx           
spm-all-9.7-release-lnxamd64     
webMethods-9.5                   
webMethods-9.8                   
webMethods-9.7                   
The expected values were successfully retrieved after ...

Check the image content. Notice SUM, SPM and ALL XXXspm plugins are included.

cc list repository products content spm-all-9.7-release-lnxamd64
ID                                     Group              Version     
ACDLDeployerSharedBundle               ACDL               9.7.0.0.163 
SSX                                    API                9.7.0.0.1975
PIFSharedBundles                       Broker             9.6.0.0.210 
PIFspm                                 Broker             9.6.0.0.210 
TPSddj                                 DDJ                9.7.0.0.16  
EventTypeCommon                        EDA                9.7.0.0.227 
NERV                                   EDA                9.7.0.0.227 
INMspm                                 INMJ               9.7.0.0.504 
CustomInstall                          Infrastructure     9.7.0.1.179 
WISSharedBundles                       Infrastructure     9.7.0.0.75  
WISSharedLibs                          Infrastructure     9.7.0.0.75  
sjp                                    Infrastructure     1.7.0.0.30  
license                                License            9.7.0.0.11  
CLI                                    Platform           9.7.0.0.250 
OSGI                                   Platform           9.7.0.0.400 
SPM                                    Platform           9.7.0.0.291 
SPMNerv                                Platform           9.7.0.0.291 
SUM                                    Platform           8.2.1.0.329 
TPS                                    Platform           9.7.0.0.14  
WSSOSGi                                Platform           9.7.0.0.244 
SCGCommon                              SCG                9.7.0.0.161 
jsw                                    SCG                9.7.0.0.161 
log4j                                  SCG                9.7.0.0.161 
saglic                                 SCG                9.7.0.0.161 
NUMRepository                          UniversalMessaging 9.7.0.0.12911
NUMspm                                 UniversalMessaging        
WMNspm                                 WmMonitor          9.7.0.0.94  
ISSharedBundles                        integrationServer  9.7.0.0.361 
ISspm                                  integrationServer  9.7.0.0.361 
WOKspm                                 integrationServer  9.7.0.0.94  
integrationServerMigrationFrameworkLib integrationServer  9.7.0.0.361 
MWSspm                                 portal             9.7.0.0.209 

Bootstrap image file is at INSTALLDIR/profiles/CCE/data/images/spm-all-9.7-release-lnxamd64.zip

Bootstrap installer file is at INSTALLDIR/profiles/CCE/data/installers/spm-all-9.7-release-lnxamd64.zip

FAQ

Can I generate bootstrap image using SAG Installer

Technically you can, but you have to satisfy the following requirements:

  1. The image MUST include Platform Manager
  2. The image MUST include Update Manager
  3. The image MUST include ALL Platform Manager Plug-Ins
  4. The image MUST include ALL required dependencies of all of the above products
  5. The image MUST follow standard naming convention: spm-all-{versionMajor.minor}-release-{platform}
  6. The image SHOULD not include any other products to limit it size to minimum.

It is safer and more reliable to let Command Central generate the image for you.

Can I generate bootstrap Image from an IMAGE repository

NO, you cannot generate image from another image. You can generate image from MASTER or MIRROR repository only.

Can I generat bootstrap Installer from an IMAGE repository

NO, while technically you can, you should NOT generate bootstrap installer from an image. You need to generate bootstrap installer from MASTER or MIRROR repository to obtain proper content and naming.

Troubleshooting

Bootstrap image generation from a MASTER repository fails with installer error

Check bootstrap log file for the error details. The bootstrap log file is available from the Jobs view for the failed job.

Ensure that this master repository is configured with valid Empower credentials. For webMethods-9.8 and newer you can validate this by listing the contents of the repository using CLI:

cc list repository products content webMethods-9.8

What's Next

The generated bootstrap image(s) can now be uploaded to other Command Centrals that do not have access to the MASTER or MIRROR repositories and used as source repository for bootstrapping SPM.

The generated bootstrap installer(s) can be copied to a file system location that is accessible from hosts that need to be bootstrapped using pull method.