Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

iim (2) Versions 0.4.1

Installs, configures and runs IBM Installation Manager

Policyfile
Berkshelf
Knife
cookbook 'iim', '~> 0.4.1', :supermarket
cookbook 'iim', '~> 0.4.1'
knife supermarket install iim
knife supermarket download iim
README
Dependencies
Changelog
Quality 17%

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.

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.

Collaborator Number Metric
            

0.4.1 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

0.4.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

0.4.1 failed this metric

FC064: Ensure issues_url is set in metadata: iim/metadata.rb:1
FC065: Ensure source_url is set in metadata: iim/metadata.rb:1
FC066: Ensure chef_version is set in metadata: iim/metadata.rb:1
FC069: Ensure standardized license defined in metadata: iim/metadata.rb:1
FC070: Ensure supports metadata defines valid platforms: iim/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric
            

0.4.1 passed this metric

Testing File Metric
            

0.4.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

0.4.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number