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

RSS

ibm-installmgr (5) Versions 1.2.0

Installs/Configures IBM Installation Manager

Berkshelf/Librarian
Policyfile
Knife
cookbook 'ibm-installmgr', '~> 1.2.0'
cookbook 'ibm-installmgr', '~> 1.2.0', :supermarket
knife cookbook site install ibm-installmgr
knife cookbook site download ibm-installmgr
README
Dependencies
Changelog
Quality

IBM Installation Manager Cookbook

Build Status

Scope

This cookbook installs IBM Installation Manager and provides resources for installing IBM packages with a response file.

This cookbook currently uses the Installation Manager Installer method rather than Installation manager to install packages. For more details see http://www-01.ibm.com/support/knowledgecenter/SSDV2W_1.8.4/com.ibm.silentinstall12.doc/topics/c_installing_differences.html

Group install mode has not been tested. Only admin and nonAdmin have.

Requirements

  • Chef 12.5 or higher
  • Installation Media for Installation manager and any other packages. This can be sourced from an online repository like IBM PassportAdvantage, or from your own download link. Supports tar, tar.gz and zip.
  • Installation Kits may need to be packaged into a single folder. For example the Websphere installation kit comes in 3 folders disk1, disk2 and disk3. Make sure all disks are in the same folder like so:

    • WAS/
    • WAS/disk1/
    • WAS/disk2/
    • WAS/disk3/
    • WAS/repository.config

Platforms

  • Centos 6
  • Red Hat Enterprise 6
  • Centos 7
  • Red Hat Enterprise 7

Usage

See the test cookbook in test/fixtures/cookbooks/ibm-im-test for examples.

Install Installation Manager

install_mgr 'ibm-im install' do
  install_package 'https://myrepository/agent.installer.linux.gtk.x86_64_1.8.4000.20151125_0201.zip'
  install_package_sha256 '28f5279abc28695c0b99ae0c3fdee26bfec131186f2ca7e41d1317e303adb12e'
  package_name 'com.ibm.cic.agent'
  ibm_root_dir '/opt/IBM'
  service_user 'ibm-im'
  service_group 'ibm-im'
end

ibm_secure_storage_file '/root/MySecureStorageFile' do
  master_pw_file '/root/MyMasterPassFile'
  master_pw 'mypassphrase'
  passport_advantage true
  username 'myPassportAdvUser'
  password 'mypassword'
end

ibm_package 'IHS install' do
  package 'com.ibm.websphere.IHS.v85_8.5.5000.20130514_1044'
  install_dir '/opt/IBM/WAS'
  passport_advantage true
  imcl_dir '/opt/IBM/InstallationManager/eclipse/tools'
  master_pw_file '/root/MyMasterPassFile'
  action :install
end

Install Websphere with Installation Manager
# installation manager must be installed before calling this resource
ibm_package 'WAS ND install' do
  package 'com.ibm.websphere.ND.v85'
  install_dir '/opt/IBM/WAS'
  repositories ['/opt/ibm-media/WASND']
  imcl_dir '/opt/IBM/InstallationManager/eclipse/tools'
  action :install
end

Resources

install_mgr

Installs IBM Installation Manager

Example
install_mgr 'ibm-im install' do
  install_package 'https://some-repository/agent.installer.linux.gtk.x86_64_1.8.4000.20151125_0201.zip'
  install_package_sha256 '28f5279abc28695c0b99ae0c3fdee26bfec131186f2ca7e41d1317e303adb12e'
  package_name 'com.ibm.cic.agent'
  ibm_root_dir '/opt/IBM'
  service_user 'ibm-im'
  service_group 'ibm-im'
end
Parameters
  • :install_package, Url or local path to a compressed file. Must be .tar, .tar.gz or .zip. String, required: true, default: nil
  • :install_package_sha256, Hash of install package. String, default: nil
  • :download_temp_dir, Scratch folder to download to. String, default: Chef::Config['file_cache_path']
  • :extract_dir, String, default: ""#{download_temp_dir}/ibm-installmgr"
  • :install_dir, String, default: "#{ibm_root_dir}/InstallationManager/eclipse"
  • :package_name, String, default: 'com.ibm.cic.agent'
  • :repositories, [String, Array], default: [extract_dir]
  • :ibm_root_dir, String, default: '/opt/IBM'
  • :data_location, This is where Installation Manager stores data about it's installed packages. String, default: '/var/ibm/InstallationManager'
  • :service_user, String, default: 'ibm-im'
  • :service_group, String, default: 'ibm-im'
  • :access_rights, String, default: 'nonAdmin', Can only be nonAdmin, admin or group. Group is not tested.
  • :preferences, A hash of preferences that are often contained within a response file. Hash, default: nil
  • :properties, A hash of properties that are often contained within a response file. Can be used in place of response file. [Hash], default: nil
Actions
  • :install - Installs Installation Manager. Does not start it as this requires gui.

ibm_package

Installs an IBM application using Installation Manager

Example
# ... omitted ibm_secure_storage_file resource.

# example to install IHS HTTP Server
ibm_package 'IHS install' do
  package 'com.ibm.websphere.IHS.v85,core.feature,arch.64bit'
  install_dir '/opt/ibm/HTTPServer'
  properties ({
    'eclipseLocation' => '/opt/ibm/HTTPServer',
    'user.import.profile' => 'false',
    'user.ihs.httpPort' => '9080',
    'user.ihs.installHttpService' => 'true',
    'user.ihs.allowNonRootSilentInstall' => 'true',
    'cic.selector.nl' => 'en'
  })
  preferences ({
    'com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' => 'true'
  })
  repositories ['http://www.ibm.com/software/repositorymanager/com.ibm.websphere.IHS.v85']
  master_pw_file '/root/MyMasterPassFile'
  secure_storage_file '/root/MySecureStorageFile'
  action :install
end

# example to install IBM Directory server.  Note the dual value properties containing two commas ,,

ibm_package 'IBM Diretcory Server' do
  package 'com.ibm.security.directoryserver.v64,main.feature.db2,main.feature.gskit,main.feature.jdk,main.feature.javaclient,'\
    'main.feature.server,main.feature.cclient,main.feature.proxy,main.feature.webadmin'
  install_dir '/opt/ibm/ldap/V6.4'
  repositories [sds_repo]
  access_rights 'admin'
  properties ({
    'eclipseLocation' => '/opt/ibm/ldap/V6.4',
    'user.import.profile' => 'false',
    'cic.selector.os' => 'linux',
    'cic.selector.arch' => 'x86_64',
    'cic.selector.ws' => 'gtk',
    'user.use.existing.db2,,com.ibm.security.directoryserver.v64' => 'false',
    'user.db2.executable.path,,com.ibm.security.directoryserver.v64' => db2_installer_dir,
    'user.use.existing.gskit,,com.ibm.security.directoryserver.v64' => 'false',
    'user.gskit.executable.path,,com.ibm.security.directoryserver.v64' => gskit_installer_dir,
    'user.jdk.executable.path,,com.ibm.security.directoryserver.v64' => jdk_installer
  })
  sensitive_exec false
  action :install
end

Parameters
  • :package, The package application id to install. Eg 'com.ibm.websphere.ND.v85_8.5.5000.20130514_1044', String required: true, default: nil
  • install_dir, Where to install the package. String, required: true, default: nil
  • imcl_dir, Path to the imcl utility binary You shouldn't need to change this. String, default: '/opt/IBM/InstallationManager/eclipse/tools'
  • repositories, Array of local dirs or urls to repositories. Installation Kits may need to be packaged into a single folder, see the Requirements section above. [String, Array], required: true, default: nil
  • service_user, String, default: 'ibm'
  • service_group, String, default: 'ibm'
  • properties, Hash, A hash of properties that are usually found in response files.
  • preferences, Hash, A hash of preferences that are usually found in response files.
  • additional_options, a string of additional options to append if needed. String, default: ''
  • access_rights, String, default: 'nonAdmin', regex: /nonAdmin|admin|group$/
  • log_dir, String, default: '/var/ibm/InstallationManager/logs'
  • :passport_advantage, When set to true adds passportAdvantafe repo url to repositories. default: false
  • :secure_storage_file, path to secure storage file to use for repo credentials. String, default: nil
  • :master_pw_file, path to file containing password to access encrypted secure_storage_file. String, default: nil
  • :sensitive_exec, Default: true, Only change this in exceptional debugging circumstances. When set to false you can see the imcl command being executed in the chef logs, which could contain a password.

    Actions
  • :install - Installs the package. Does not start, setup a service at this stage.

ibm_fixpack

Similar to ibm_package but specifically installs an IBM fixpack. All parameters are exactly the same as ibm_package.

Example

# ... omitted required ibm_secure_storage_file resource.

ibm_fixpack 'WAS ND Fixpack' do
  package 'com.ibm.websphere.ND.v85_8.5.5008.20151112_0939,core.feature,ejbdeploy,thinclient,embeddablecontainer,com.ibm.sdk.6_64bit'
  install_dir '/opt/IBM/Websphere/AppServer'
  repositories ['http://www.ibm.com/software/repositorymanager/com.ibm.websphere.ND.v85']
  master_pw_file '/root/MyMasterPassFile'
  secure_storage_file '/root/MySecureStorageFile'
  action :install
end

Parameters

Exactly the same as parameters for ibm_package

Actions
  • :install

ibm_response_file

A simple wrapper around the template resource to create a response file for the ibm_package_response resource. You can use the template resource directly if you like.

Example
ibm_response_file '/opt/IBM/response_files/my_was_response.xml' do
  cookbook 'ibm-im-test'
  template_source 'was_response.xml.erb'
  variables({
    :key1 => 'val1'
  })
end

Parameters
  • :package, The package application id to install. Eg 'com.ibm.websphere.ND.v85_8.5.5000.20130514_1044', String required: true, default: nil, name_property: true
  • response_file, Path to create the response file. String
  • group, File group. String, default: 'ibm-im'
  • owner, File owner. String, default: 'ibm-im'
  • template_source, String, default: nil
  • cookbook, String, default: nil
  • variables, [Hash], default: nil
Actions
  • :create

ibm_package_response

NOTE: It's easier and more intuitive to use the ibm_package command and pass in properties and preferences instead of this resource.

Installs an IBM package using a response file. Please note you may need to create and required users and directories mentioned in the response file first. You do not need to accept the license or set the accessRights in the response file, this is handled with the command.

Example
ibm_package_response 'com.ibm.websphere.ND.v85' do
  response_file '/opt/IBM/response_files/my_was_response.xml'
  action :install
end

Parameters
  • response_file, String, name_property: true, required: true
  • imcl_dir, String, default: '/opt/IBM/InstallationManager/eclipse/tools'
  • log_dir, String, default: '/var/ibm/InstallationManager/logs'
  • group, Only used to for log_dir. String, default: 'ibm-im'
  • owner, Only used to for log_dir String, default: 'ibm-im'
  • access_rights, String, default: 'nonAdmin', regex: /nonAdmin|admin|group$/
Actions
  • :install

ibm_secure_storage_file

Creates an encrypted Eclipse Storage file to store password credentials to repositories such as IBM passport Advantage.

Example
ibm_secure_storage_file '/root/MySecureStorageFile' do
  master_pw_file '/root/MyMasterPassFile'
  master_pw 'mypassphrase'
  passport_advantage true
  username 'myemail@somedomain.com'
  password 'mypass'
end
Parameters
  • secure_file, String, name_property: true
  • master_pw_file, Contains the password to access the secure_file. String
  • master_pw, password to put in master_pw_file. String, default: nil
  • url, String, default: 'http://www.ibm.com/software/repositorymanager/entitled/repository.xml'
  • passport_advantage, Set to true when credentials are to access passportAdvantage. The url will be ignored if set. [TrueClass, FalseClass], default: false
  • username, String, default: nil
  • password, For encrypting the secure file. String, default: nil
  • imutilsc_dir, Path to imutilsc binary. You shouldn't need to change this from the default. String, default: '/opt/IBM/InstallationManager/eclipse/tools'

    Actions
  • :create

License and Author

  • Author: Lachlan Munro, Chris Bell

Copyright: 2015, J Sainsburys

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

websphere Applicable Versions

IBM Installation Manager Cookbook CHANGELOG

v1.2.0

  • change default access_rights from nonAdmin to admin

v1.1.1

  • update readme with ibm_fixpack
  • remove java depenency as it's not needed

v1.1.0

  • add sensitive_exec override for debugging.
  • fix property warnings

v1.0.0

  • first release.

Collaborator Number Metric
            

1.2.0 failed this metric

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

Contributing File Metric
            

1.2.0 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
            

1.2.0 passed this metric

License Metric
            

1.2.0 passed this metric

No Binaries Metric
            

1.2.0 passed this metric

Publish Metric
            

1.2.0 passed this metric

Supported Platforms Metric
            

1.2.0 failed this metric

ibm-installmgr should declare what platform(s) it supports.

Testing File Metric
            

1.2.0 passed this metric

Version Tag Metric
            

1.2.0 passed this metric