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
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
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.
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:
- The image MUST include Platform Manager
- The image MUST include Update Manager
- The image MUST include ALL Platform Manager Plug-Ins
- The image MUST include ALL required dependencies of all of the above products
- The image MUST follow standard naming convention: spm-all-{versionMajor.minor}-release-{platform}
- 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.