Skip to content

Commit

Permalink
Merge branch 'develop'
Browse files Browse the repository at this point in the history
  • Loading branch information
Amir Mofasser committed Sep 16, 2017
2 parents 5f757bb + 77984f4 commit c92ab24
Show file tree
Hide file tree
Showing 14 changed files with 1,461 additions and 400 deletions.
4 changes: 2 additions & 2 deletions .gitignore
100644 → 100755
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
.DS_store
*.swp
.DS_store
*.swp
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# 1.0.1
* Merged ibmim and ibmwas modules to one module, ibmim. This new updated module can be used to install, uninstall and update all IBM products that can be used with Installation Manager. Not just WebSphere. Installing Installation Manager itself can be done using the ibmim_installer module

# 1.0.0
* Initial Version
344 changes: 229 additions & 115 deletions README.md
100644 → 100755
Original file line number Diff line number Diff line change
@@ -1,115 +1,229 @@
# README

## ibmim.py
This module installs or uninstalls IBM Installation Manager.
#### Options
| Parameter | Required | Default | Choices | Comments |
|:---------|:--------|:---------|:---------|:---------|
| state | true | N/A | present, abcent | present=install, abcent=uninstall |
| src | true | N/A | N/A | Path to installation files for Installation Manager |
| dest | false | N/A | /opt/IBM/InstallationManager | Path to desired installation directory of Installation Manager |
| logdir | false | N/A | N/A | Path and file name of installation log file |
```
# Example:
# Install:
ibmim: state=present src=/some/dir/install/ logdir=/tmp/im_install.log
# Uninstall
ibmim: state=abcent dest=/opt/IBM/InstallationManager
```

## ibmwas.py
This module installs or uninstalls IBM WebSphere products using Installation Manager.
#### Options
| Parameter | Required | Default | Choices | Comments |
|:---------|:--------|:---------|:---------|:---------|
| state | true | present | present, abcent | present=install,abcent=uninstall |
| ibmim | true | N/A | N/A | Path to installation directory of Installation Manager |
| dest | true | N/A | N/A | Path to destination installation directory |
| im_shared | true | N/A | N/A | Path to Installation Manager shared resources folder |
| repo | true | N/A | N/A | URL or path to the installation repository used by Installation Manager to install WebSphere products |
| offering | true | com.ibm.websphere.ND.v85 | N/A | Name of the offering which you want to install |

```
# Example:
# Install:
ibmwas: state=present ibmim=/opt/IBM/InstallationManager/ dest=/usr/local/WebSphere/AppServer im_shared=/usr/local/WebSphere/IMShared repo=http://example.com/was-repo/ offering=com.ibm.websphere.ND.v85
# Uninstall:
ibmwas: state=abcent ibmim=/opt/IBM/InstallationManager dest=/usr/local/WebSphere/AppServer/
```

## liberty_server.py
This module start os 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:
# Start:
liberty_server: state=started libertydir=/usr/local/WebSphere/Liberty/ name=my-server-01
# Stop:
liberty_server: state=stopped libertydir=/usr/local/WebSphere/Liberty/ name=my-server-01
```

## 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,abcent | present=create,abcent=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 |
```
# Example:
# 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
# Remove:
profile_dmgr: state=abcent wasdir=/usr/local/WebSphere/AppServer/ name=dmgr
```

## profile_liberty.py
This module creates or removes a Liberty Profile server runtime
#### Options
| Parameter | Required | Default | Choices | Comments |
|:---------|:--------|:---------|:---------|:---------|
| state | true | present | present,abcent | present=create,abcent=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:
# Create:
profile_liberty: state=present libertydir=/usr/local/WebSphere/Liberty/ name=server01
# Remove
profile_liberty: state=abcent libertydir=/usr/local/WebSphere/Liberty/ name=server01
```

## 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,abcent | present=create,abcent=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:
# 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
# Remove:
profile_dmgr: state=abcent wasdir=/usr/local/WebSphere/AppServer/ name=nodeagent
```
# README
A set of Ansible modules that lets you manage IBM packages

## 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 profile. Requires a Network Deployment 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 |

#### Example
```yaml
- 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
```
### 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 | present=install,absent=uninstall or 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 |
| repo | false | N/A | N/A | Comma separated list of URLs or paths to installation repositories used by Installation Manager |
| 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 |
#### Example
```yaml
- name: Install WebSphere Application Server Liberty v8.5
ibmim:
id: com.ibm.websphere.liberty.BASE.v85
repositories: /var/data/was

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

- name: Update all packages
ibmim:
id: null
state: update
repositories: /var/data/was
```
### 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 |
#### Example
```yaml
- 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
```yaml
- 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
```
### 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
```yaml
- name: Start
server:
state: started
wasdir: /usr/local/WebSphere/AppServer/
name: my-server-01

- name: Stop
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
```yaml
- 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
```yaml
- 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
```
25 changes: 25 additions & 0 deletions examples/install-installation-manager.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
#
# Downloads Installation Manager from an URL and installs it at a default location.
#

- hosts: localhost
connection: local
tasks:
- name: Download installer zip
get_url:
url: http://myserver.domain.com/~ibmrepo/im/linux/agent.installer.linux.x86_64-latest.zip
dest: /tmp/

- name: Create IM directory
file:
state: directory
path: /tmp/im

- name: Unarchive installer zip
unarchive:
src: /tmp/agent.installer.linux.x86_64-latest.zip
dest: /tmp/im/

- name: Install Installation Manager
ibmim_installer:
src: /tmp/im/
Loading

0 comments on commit c92ab24

Please sign in to comment.