Skip to content

Installing Products

WayneLeishman edited this page Jan 24, 2018 · 9 revisions

At this point in the tutorial, you have an empty managed installation and it is online. Next you can start installing products in this installation. You will start with customizing the SPM by installing specific product plugins. SPM product plugins are installed automatically when a parent product is installed, but for this tutorial, we'll do it explicitly.

Repositories

Since you used automated Command Central setup, repositories have already been defined in Command Central. Double check by running this command:

[user@linuxbox tutorial]$ sagcc list repository products
Display Name    Type    Version Platforms       Description
webMethods-10.1 MASTER     10.1 ALL             Latest GA
webMethods-9.8  MASTER      9.8 ALL
webMethods-10.0 MASTER     10.0 ALL             Innovation release
webMethods-9.10 MASTER     9.10 ALL
products-10.1   MIRROR     10.1 LNXAMD64
webMethods-9.12 MASTER     9.12 ALL
webMethods-9.9  MASTER      9.9 ALL

For manual repository configuration please see Command Central documentation.

Install Product SPM Plugins

To install product plugins you need to define a plugins template and link it to the management layer.

  1. Edit templates/tutorial/template.yaml and change the version to 0.4 and add a description to the change list.
  2. Add new templates: section with a template alias called plugins which has products: section.
  3. Then add product plugin ids to the products: section.
  4. In the layers: management: section, specify the productRepo and templates to use for this layer.

To find out product ids use Command Central Web UI Repositories or run sagcc command:

[user@linuxbox tutorial]$ sagcc list repository products content products-10.1 | grep spm

The template should now look like this:

alias: tutorial
description: How to bootstrap local nodes
version: 0.4
changes:
  - 0.1 Initial draft
  - 0.2 Added input parameters
  - 0.3 Added local node bootstrap
  - 0.4 Added products/plugins installation
 
environments:
  default:
    install.dir:  ${}                              # SPM installation directory
    spm.port:     8192                             # SPM connection port
    spm.alias:    dev${spm.port}                   # SPM alias
    repo.product: ${}                              # default product repo
 
layers:                                            # LAYERS definition
  management:                                      # management layer with SPMs
    productRepo: ${repo.product}                   # product repository for this layer
    templates:   [plugins]                         # templates to apply to this layer
 
templates:                                         # TEMPLATES definition
  plugins:                                         # template alias
    products:                                      # product list to install
      ISspm:                                       # Platform Manager Plug-Ins / IS
      NUMspm:                                      # Platform Manager Plug-Ins / UM
 
nodes:                                             # NODES definition
 default:                                          # defaults for any environment type
   default:                                        # default node definition
     port: ${spm.port}                             # SPM connection HTTP/S port
     secure: false                                 # do not use SSL port
     bootstrapInfo:
       installDir: ${install.dir}                  # installation directory
       installer:  ${cc.installer}                 # cc installer that can be found in cc_home/profiles/CCE/data/installers    
 
   ${spm.alias}:                                   # definition for specific nodeAlias
     host: localhost                               # Use localhost
 
 
provision:                                         # PROVISIONing mapping of layers to nodes
  default:                                         # default environment type
    management: ${spm.alias}                       # management layer is single node

Edit environments/default/env.properties and add a repo.product=products-10.1 parameter. Make sure it points to the repository you have and matches the release version of the target managed installation. Use the values for install.dir and cc.installer from previous steps to bootstrap the nodes.

install.dir=${user.home}/sag/${spm.alias}
cc.installer=cc-def-10.1-fix5-lnxamd64.sh
repo.product=products-10.1

Save the changes to template.yaml and env.properties.

Apply the template:

[user@linuxbox tutorial]$ ant up
...
BUILD SUCCESSFUL
Total time: ....

Summary

Congratulations! You have installed new products on your dev8192 node using your template.

If you have problems achieving the goals of this tutorial stage, use the following command to checkout everything that needed to be done so far. Make a note about your modifications of environment/default/env.properties because the version that you check out will overwrite them.

[user@linuxbox tutorial]$ git checkout stage-04 -f
Switched to branch 'stage-04'