Skip to content

amimof/ansible-websphere

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

README

A set of Ansible modules that lets you manage IBM packages and WebSphere resources

Getting started

Copy the folder library in this repo to your playbook directory or to ANSIBLE_LIBRARY

$ git clone https://github.com/amimof/ansible-websphere && cp -r ansible-websphere/library <directory>

Module Summary

Module Description
ibmim_installer.py Installs and uninstalls IBM Installation Manager.
ibmim.py Manage IBM Installation Manager packages. Currently supports Install/Uninstall and Update packages.
profile_dmgr.py Creates or removes a WebSphere Application Server Deployment Manager or Base profile. Requires a Network Deployment or Base installation.
profile_nodeagent.py Creates or removes a WebSphere Application Server Node Agent profile. Requires a Network Deployment installation.
profile_liberty.py Creates or removes a Liberty Profile server runtime
server.py Start or stops a WebSphere Application Server
liberty_server.py Start or stops a Liberty Profile server

Modules

ibmim_installer.py

This module installs or uninstalls IBM Installation Manager.

Options

Parameter Required Default Choices Comments
state false present present, absent present=install, absent=uninstall
src false N/A N/A Path to installation files for Installation Manager
dest false /opt/IBM/InstallationManager N/A Path to desired installation directory of Installation Manager
logdir false N/A /tmp Directory to save installation log file
accessRights false admin admin, nonAdmin Using a root or a user installation

Example

- name: Install
  ibmim_installer:
    state: present
    src: /some/dir/install/
    logdir: /tmp/im_install.log

- name: Uninstall
  ibmim_installer:
    state: absent
    dest: /opt/IBM/InstallationManager
##
## Install IIM
  - name: IBM Installation Manager installed
    ibmim_installer:
      state: present
      src: /tmp/iimSrc/unpack
      dest: ~/IBM/InstallationManager
      accessRights: nonAdmin
      logdir: /tmp
    become_user: '{{ was_user }}'
##
## Un-Install IIM
  - name: IBM Installation Manager un-installed
    ibmim_installer:
      state: absent
      dest: ~/IBM/InstallationManager
      accessRights: nonAdmin
      logdir: /tmp
    become_user: '{{ was_user }}'

ibmim.py

This module installs, uninstalls or updates IBM packages from local or remote repositories

Options

Parameter Required Default Choices Comments
state false present present, absent, latest present=install,absent=uninstall or latest=update
ibmim false /opt/IBM/InstallationManager N/A Path to installation directory of Installation Manager
dest false N/A N/A Path to destination installation directory
im_shared false N/A N/A Path to Installation Manager shared resources folder
id true N/A N/A ID of the package which you want to install
repositories false N/A N/A Comma separated list of repositories to use. May be a path, URL or both
properties false N/A N/A Comma separated list of properties needed for package installation. In the format key1=value,key2=value
install_fixes false none N/A Install fixes if available in the repositories
connect_passport_advantage false N/A N/A Append the PassportAdvantage repository to the repository list
log false N/A N/A Specify a log file that records the result of Installation Manager operations.

Example

- name: Install WebSphere Application Server Liberty v8
  ibmim:
    name: com.ibm.websphere.liberty.v85
    repositories:
    - http://was-repos/

- name: Uninstall WebSphere Application Server Liberty v8
  ibmim:
    name: com.ibm.websphere.liberty.v85
    state: absent

- name: Update all packages
  ibmim:
    state: latest
    repositories:
    - http://was-repos/

profile_dmgr.py

This module creates or removes a WebSphere Application Server Deployment Manager profile. Requires a Network Deployment installation.

Options

Parameter Required Default Choices Comments
state true present present,absent present=create,absent=remove
wasdir true N/A N/A Path to installation location of WAS
name true N/A N/A Name of the profile
cell_name true N/A N/A Name of the cell
host_name true N/A N/A Host Name
node_name true N/A N/A Node name of this profile
username true N/A N/A Administrative user name
password true N/A N/A Administrative user password
template true management management,default management=dmgr,default=base

Example

- name: Create
  profile_dmgr:
    state: present
    wasdir: /usr/local/WebSphere/AppServer/
    name: dmgr
    cell_name: devCell
    host_name: localhost
    node_name: devcell-dmgr
    username: admin
    password: allyourbasearebelongtous

- name: Remove
  profile_dmgr:
    state: absent
    wasdir: /usr/local/WebSphere/AppServer/
    name: dmgr

profile_nodeagent.py

This module creates or removes a WebSphere Application Server Node Agent profile. Requires a Network Deployment installation.

Options

Parameter Required Default Choices Comments
state true present present,absent present=create,absent=remove
wasdir true N/A N/A Path to installation location of WAS
name true N/A N/A Name of the profile
cell_name true N/A N/A Name of the cell
host_name true N/A N/A Host Name
node_name true N/A N/A Node name of this profile
username true N/A N/A Administrative user name of the deployment manager
password true N/A N/A Administrative user password of the deployment manager
dmgr_host true N/A N/A Host name of the Deployment Manager
dmgr_port true N/A N/A SOAP port number of the Deployment Manager
federate false N/A N/A Wether the node should be federated to a cell. If true, cell name cannot be the same as the cell name of the deployment manager.

Example

- name: Create
  profile_nodeagent:
    state: present
    wasdir: /usr/local/WebSphere/AppServer/
    name: nodeagent
    cell_name: devCellTmp
    host_name: localhost
    node_name: devcell-node1
    username: admin
    password: allyourbasearebelongtous
    dmgr_host: localhost
    dmgr_port: 8879
    federate: true

- name: Remove
  profile_dmgr:
    state: absent
    wasdir: /usr/local/WebSphere/AppServer/
    name: nodeagent

was_server.py

This module start or stops a WebSphere Application Server

Options

Parameter Required Default Choices Comments
state true started started, stopped N/A
name true N/A N/A Name of the app server
wasdir true N/A N/A Path to binary files of the application server
username true N/A N/A Administrative user name
password true N/A N/A Administrative user password

Example

- name: Start
  was_server:
    state: started
    wasdir: /usr/local/WebSphere/AppServer/
    name: my-server-01

- name: Stop
  was_server:
    state: stopped
    wasdir: /usr/local/WebSphere/AppServer/
    name: my-server-01

liberty_server.py

This module start or stops a Liberty Profile server

Options

Parameter Required Default Choices Comments
state true started started, stopped N/A
name true N/A N/A Name of the app server
libertydir true N/A N/A Path to binary files of the application server

Example

- name: Start
  liberty_server:
    state: started
    libertydir: /usr/local/WebSphere/Liberty/
    name: my-server-01

- name: Stop
  liberty_server:
    state: stopped
    libertydir: /usr/local/WebSphere/Liberty/
    name: my-server-01

profile_liberty.py

This module creates or removes a Liberty Profile server runtime

Options

Parameter Required Default Choices Comments
state true present present,absent present=create,absent=remove
libertydir true N/A N/A Path to install location of Liberty Profile binaries
name true N/A N/A Name of the server which is to be created/removed

Example

- name: Create
  profile_liberty:
    state: present
    libertydir: /usr/local/WebSphere/Liberty/
    name: server01

- name: Remove
  profile_liberty:
    state: absent
    libertydir: /usr/local/WebSphere/Liberty/
    name: server01