Skip to content

Installing Fixes

WayneLeishman edited this page Jan 25, 2018 · 5 revisions

Install latest fixes right after products are installed.

Fix installation process is similar to product installation, even simpler!

  1. Open templates/tutorial/template.yaml in the editor
  2. Add repo.fix: ${} parameter.
  3. Add spm.fixes: ALL parameter. The default value ALL is a special value that instructs to install all applicable fixes from the source fix repository.
  4. Add fixRepo: ${repo.fix} property to the management layer to configure the source fix repository for this layer
  5. Add fixes: ${spm.fixes} property to the plugins template to instruct the template to install a list of fixes after the products have been installed.

The final template looks like this:

alias: tutorial
description: How to bootstrap local nodes
version: 0.5
changes:
  - 0.1 Initial draft
  - 0.2 Added input parameters
  - 0.3 Added local node bootstrap
  - 0.4 Added products/plugins installation
  - 0.5 Added fix 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
    repo.fix:     ${}                              # fixes repository
    spm.fixes:    ALL                              # Default list of fixes to install
 
layers:                                            # LAYERS definition
  management:                                      # management layer with SPMs
    productRepo: ${repo.product}                   # product repository for this layer
    fixRepo:     ${repo.fix}                       # fix 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
    fixes: ${spm.fixes}                            # fixes to install

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.fix=fixes-10.1 parameter. Make sure the value points to a registered fix repository you have. For cc.installer, install.dir and repo.product use the values that you used in the previous stages.

install.dir=${user.home}/sag/${spm.alias}

# MUST use one of these!

# Defaults for Windows
# cc.installer=cc-def-10.1-fix5-w64.zip 
 
# Defaults for Linux
# cc.installer=cc-def-10.1-fix5-lnxamd64.sh
 
# Defaults for Mac
# cc.installer=cc-def-10.1-fix5-osx.sh

repo.product=products-10.1
repo.fix=fixes-10.1

Apply the template:

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

You can verify the product fixes were installed by opening the Command Central Web UI. Select dev8192 in the Installations tab. Then select the Fixes tab and you will the fixes that were installed.

Summary

Congratulations! You've successfully installed fixes from Empower.

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'll check out will overwrite them.

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