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.