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}


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
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

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                     
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      
SSX                                    API      
PIFSharedBundles                       Broker    
PIFspm                                 Broker    
TPSddj                                 DDJ        
EventTypeCommon                        EDA       
NERV                                   EDA       
INMspm                                 INMJ      
CustomInstall                          Infrastructure 
WISSharedBundles                       Infrastructure  
WISSharedLibs                          Infrastructure  
sjp                                    Infrastructure  
license                                License    
CLI                                    Platform  
OSGI                                   Platform  
SPM                                    Platform  
SPMNerv                                Platform  
SUM                                    Platform  
TPS                                    Platform   
WSSOSGi                                Platform  
SCGCommon                              SCG       
jsw                                    SCG       
log4j                                  SCG       
saglic                                 SCG       
NUMRepository                          UniversalMessaging
NUMspm                                 UniversalMessaging        
WMNspm                                 WmMonitor  
ISSharedBundles                        integrationServer 
ISspm                                  integrationServer 
WOKspm                                 integrationServer  
integrationServerMigrationFrameworkLib integrationServer 
MWSspm                                 portal    

Bootstrap image file is at INSTALLDIR/profiles/CCE/data/images/

Bootstrap installer file is at INSTALLDIR/profiles/CCE/data/installers/


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.


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.

1 Like