iim (2) Versions 0.4.0 Follow3

Installs, configures and runs IBM Installation Manager

Policyfile

Berkshelf

Knife

cookbook 'iim', '= 0.4.0', :supermarket

cookbook 'iim', '= 0.4.0'

knife supermarket install iim

knife supermarket download iim

README

Dependencies

Changelog

Quality 0%

Description

This cookbook installs IBM Installation Manager (IM) and provides lightweight resource/providers (LWRPs) that can be used to install IBM products using the IBM Installation Manager. You can use the iim_name_install LWRP to install the package using the default configuration options, or you can have full control over the configuration of your installation by using the iim_response_file_install LWRP with a response file that defines your configuration.

For further details, please visit the IBM Installation Manager Knowledge Center. The IBM Installation Manager response files page includes samples and instructions for generating your own response file.

Requirements

Platform:

linux

Cookbooks:

No dependencies defined

Attributes

node[:im][:user] - User and group name under which the server will be installed and running. Defaults to im.
node[:im][:group] - Defaults to im-admin.
node[:im][:user_home_dir] - Home directory for im user. The attribute is ignored if im user is root. For nonAdmin access mode, the registry of IBM Installation Manager (IM) is found at user_home_dir/etc/.ibm/registry/InstallationManager.dat. The registry path MUST NOT be equal to base_dir, or a parent directory or a subdirectory of base_dir. Defaults to /home/im.
node[:im][:base_dir] - Base installation directory. Defaults to /opt/IBM/InstallationManager.
node[:im][:data_dir] - Data directory. Defaults to /var/ibm/InstallationManager.
node[:im][:install_zip][:file] - The IM install zip file. Set this attribute if the installer is on a local filesystem. Defaults to nil.
node[:im][:install_zip][:url] - The IM install zip url. Set this attribute if the installer is on a remote fileserver. Defaults to nil.
node[:im][:access_mode] - The mode in which the installation is run. Valid options are: 'admin' 'nonAdmin' and 'group'. Defaults to nonAdmin.
node[:im][:secure_storeage_file] - A default secure storage file, which is only used if the cookbook that calls the provider does not supply its own secure storage file. Defaults to nil.
node[:im][:master_password_file] - A default master password file, which is only used if the cookbook that calls the provider does not supply its own master password and secure storage files. Defaults to nil.

Recipes

iim::default - Installs IBM Installation Manager.

iim::default

Installs IBM Installation Manager.

Resources

iim_install - A backend resource wrapped by name_install and response_file_install.
iim_name_install - Installs an IBM product by executing the IBM Installation manager and selecting the default installation options.
iim_response_file_install - Installs an IBM product by executing the IBM Installation Manager with a response file.

iim_install

A backend resource wrapped by name_install and response_file_install.

Actions

install: Default action.

Attribute Parameters

install_command_snippet: Defaults to <code>nil</code>.
secure_storage_file: Defaults to <code>nil</code>.
master_password_file: Defaults to <code>nil</code>.

iim_name_install

Installs an IBM product by executing the IBM Installation manager and selecting the default installation options.

Actions

install: Installs an IBM product. Default action.

Attribute Parameters

secure_storage_file: Sets the secureStorageFile imcl option. Defaults to <code>nil</code>.
master_password_file: Sets the masterPasswordFile imcl option. Defaults to <code>nil</code>.
repositories: The repository to search. Multiple repositories can be specified with a comma-separated list. Defaults to <code>nil</code>.
install_directory: The directory in which to install the package. Defaults to <code>nil</code>.

examples

Installing from a repository.

iim_name_install Package.Name do
  repositories "repository.ibm.com"
end

Installing from a password protected repository.

iim_name_install Package.Name do
  repositories "repository.ibm.com"
  secure_storage_file /path/to/secure_storage_file
  master_password_file /path/to/master_password_file
end

iim_response_file_install

Installs an IBM product by executing the IBM Installation Manager with a response file. A response file or response file template must be provided by the user.

Actions

install: Installs an IBM Product. Default action.

Attribute Parameters

response_file: The response file for the IBM Installation Manager. Takes priority over response_hash. Defaults to <code>nil</code>.
response_hash: A hash representation of the response file's xml content. Defaults to <code>nil</code>.
secure_storage_file: Sets the secureStorageFile imcl option. Defaults to <code>nil</code>.
master_password_file: Sets the masterPasswordFile imcl option. Defaults to <code>nil</code>.

Examples

Installs an IBM product from a repository by executing the IBM Installation Manager with a response file.

im_response_file = '/var/tmp/my-response-file'

template im_response_file do
  source 'response-file.xml.erb'
  variables(
    :repository_url => 'some_url',
    :install_dir => 'some_dir'
  )
end

iim_response_file_install 'Websphere 8.5.5' do
  response_file im_response_file
end

An example response file template

iim_response_file_install 'Websphere 8.5.5' do
  response_hash(
        :'clean' => true,
        :'temporary' => false,
        :'server' => {
                :'repository' => {
                        :'location' => '<%= @repository_url %>'
                }
        },
        :'profile' => {
                :'id' => 'IBM Websphere Application Server V8.5',
                :'installLocation' => '<%= @install_dir %>',
                :'data' => [
                        {:'key' => 'cic.selector.os', :'value' => 'linux'},
                        {:'key' => 'cic.selector.ws', :'value' => 'gtk'},
                        {:'key' => 'cic.selector.arch', :'value' => 'x86_64'},
                        {:'key' => 'cic.selector.nl', :'value' => 'en'},
                ]
        },
        :'install' => {
                :'modify' => false,
                :'offering' => [
                        {
                                :'id' => 'com.ibm.websphere.BASE.v85',
                                :'version' => 'someversion',
                                :'profile' => 'IBM Websphere Application Server V8.5',
                                :'features' => 'core.feature',
                                :'installFixes' => 'none'
                        }
                ]
        }
)
end

Contributing

Please see our contributing guide.

Support

Use the issue tracker for reporting any bugs or enhancements. For any questions please use the WASdev forum.

The cookbook is maintained by IBM.

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

im CHANGELOG

This file is used to list changes made in each version of the iim cookbook.

v0.4.0

[benjamin-confino] - added a second provider to provide a simpler lightweight interface.
[benjamin-confino] - added support for installing im in group mode.
[benjamin-confino] - added an option for default master password and secure storage files

v0.3.1

[fsimmend] - remove unnecessary params on install call.

v0.3.0

[fsimmend] - fix iim LWRP when using response_hash
[fsimmend] - cleanup code
[fsimmend] - add rakefile for testing and style
[fsimmend] - add knife-doc documentation for iim LWRP
[fsimmend] - fix iim LWPR when install user is not root
[fsimmend] - fixes for IBM Installation Manager >= 1.8

v0.2.0

changelog not maintained

v0.1.0

Initial release of iim cookbook

Check the Markdown Syntax Guide for help with Markdown.

The Github Flavored Markdown page describes the differences between markdown on github and standard markdown.

Foodcritic Metric

0.4.0 failed this metric

FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/attributes/default.rb:16
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/attributes/default.rb:17
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/attributes/default.rb:24
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/attributes/default.rb:27
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/attributes/default.rb:29
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/attributes/default.rb:34
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/attributes/default.rb:39
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/attributes/default.rb:42
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/attributes/default.rb:45
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/attributes/default.rb:48
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:23
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:25
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:26
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:27
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:36
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:37
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:65
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:66
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/recipes/default.rb:28
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/recipes/default.rb:29
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/recipes/default.rb:30
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/recipes/default.rb:31
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/recipes/default.rb:32
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/recipes/default.rb:34
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/recipes/default.rb:66
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/recipes/default.rb:69
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/recipes/default.rb:73
FC002: Avoid string interpolation where not required: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:23
FC002: Avoid string interpolation where not required: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:54
FC017: LWRP does not notify when updated: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/install.rb:20
FC017: LWRP does not notify when updated: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/name_install.rb:21
FC017: LWRP does not notify when updated: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/providers/response_file_install.rb:23
FC019: Access node attributes in a consistent manner: /tmp/cook/5dc2a0ebc3e8638b124e661e/iim/recipes/default.rb:42

Chef Supermarket

Adoptable Cookbooks List

Supermarket Belongs to the Community

View our collection of guides, documentation, and articles

iim (2) Versions 0.4.0 Follow3

Description

Requirements

Platform:

Cookbooks:

Attributes

Recipes

iim::default

Resources

iim_install

Actions

Attribute Parameters

iim_name_install

Actions

Attribute Parameters

examples

iim_response_file_install

Actions

Attribute Parameters

Examples

Contributing

Support

License

Dependent cookbooks

Contingent cookbooks

im CHANGELOG

v0.3.1

v0.3.0

v0.2.0

v0.1.0

Details

Updated November 3, 2015 Created on November 3, 2015

Supported Platforms

License

Adoptable Cookbooks List

Supermarket Belongs to the Community

View our collection of guides, documentation, and articles

Select Badges

Select Supported Platforms

Select Status

iim (2) Versions 0.4.0 0.4.1 0.4.0 Follow3

Description

Requirements

Platform:

Cookbooks:

Attributes

Recipes

iim::default

Resources

iim_install

Actions

Attribute Parameters

iim_name_install

Actions

Attribute Parameters

examples

iim_response_file_install

Actions

Attribute Parameters

Examples

Contributing

Support

License

Dependent cookbooks

Contingent cookbooks

im CHANGELOG

v0.3.1

v0.3.0

v0.2.0

v0.1.0

Details

Updated November 3, 2015 Created on November 3, 2015

Supported Platforms

License

iim (2) Versions 0.4.0 Follow3