cookbook 'iim', '= 0.4.0'
iim (2) Versions 0.4.0 Follow3
Installs, configures and runs IBM Installation Manager
cookbook 'iim', '= 0.4.0', :supermarket
knife supermarket install iim
knife supermarket download iim
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 toim
. -
node[:im][:group]
- Defaults toim-admin
. -
node[:im][:user_home_dir]
- Home directory forim user
. The attribute is ignored ifim user
is root. For nonAdmin access mode, the registry of IBM Installation Manager (IM) is found atuser_home_dir/etc/.ibm/registry/InstallationManager.dat
. The registry path MUST NOT be equal tobase_dir
, or a parent directory or a subdirectory ofbase_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 tonil
. -
node[:im][:install_zip][:url]
- The IM install zip url. Set this attribute if the installer is on a remote fileserver. Defaults tonil
. -
node[:im][:access_mode]
- The mode in which the installation is run. Valid options are: 'admin' 'nonAdmin' and 'group'. Defaults tononAdmin
. -
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 tonil
. -
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 tonil
.
Recipes
- iim::default - Installs IBM Installation Manager.
iim::default
Installs IBM Installation Manager.
Resources
-
iim_install - A backend resource wrapped by
name_install
andresponse_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 usingresponse_hash
- [fsimmend] - cleanup code
- [fsimmend] - add rakefile for testing and style
- [fsimmend] - add
knife-doc
documentation foriim
LWRP - [fsimmend] - fix
iim
LWPR when install user is notroot
- [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
0.4.0 failed this metric
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