added aix_nimclient module

[molekuul]

SUMMARY

This new module is ment for AIX. It installs software at a nimclient using nimclient command and removes software using local commands. This module also updates ALL to latest version, and ia able to issues nimclient action on the nimclient like reset or deallocate

ISSUE TYPE

• New Module Pull Request

COMPONENT NAME

aix_nimclient

ADDITIONAL INFORMATION

Examples:

- name: install latest version of OpenGL.OpenGL_X.rte.soft from lpp_source lppsource_aix6109-06
  aix_nimclient:
    name:
      - OpenGL.OpenGL_X.rte.soft
    lpp_source: lppsource_aix6109-06

- name: install latest version of OpenGL.OpenGL_X.rte.soft from lpp_source lppsource_aix6109-06 and apply only
  aix_nimclient:
    name:
      - OpenGL.OpenGL_X.rte.soft
    lpp_source: lppsource_aix6109-06
    commit: False

- name: install version 6.1.9.30 of OpenGL.OpenGL_X.rte.soft from lpp_source lppsource_aix6109-06
  aix_nimclient:
    name:
      - OpenGL.OpenGL_X.rte.soft 6.1.9.30
    lpp_source: lppsource_aix6109-06

- name: remove fileset OpenGL.OpenGL_X.rte.soft
  aix_nimclient:
    name:
      - OpenGL.OpenGL_X.rte.soft
    state: absent

- name: commit fileset OpenGL.OpenGL_X.rte.soft
  aix_nimclient:
    name:
      - OpenGL.OpenGL_X.rte.soft
    state: commit

# install all filesets to latest level f.i. install a TL or ML
- name: update all filesets to latest level from lpp_source lppsource_aix6109-06
  aix_nimclient:
    name:
      - update_all
    lpp_source: lppsource_aix6109-06

- name: allocate spot and lpp_source to the nimclient
  aix_nimclient:
    lpp_source: lppsource_aix6109-06
    spot: spot_aix6109-06
    state: allocate

- name: deallocate all resources from the nimclient
  aix_nimclient:
    state: deallocate

- name: reset the nimclient
  aix_nimclient:
    state: reset

[ansibot]

cc @MorrisA @dagwieers @flynn1973 @gforster @kairoaraujo
click here for bot help

[ansibot]

@AugustusKling @ColOfAbRiX @EvanK @LinusU @Mogztter @MorrisA @abulimov @adejoux @ahtik @azaghal @bgurney-rh @dankeder @davidobrien1985 @davixx @dirtyharrycallahan @dougluce @dsummersl @flynn1973 @gforster @giovannisciortino @goozbach @groks @haad @hryamzik @indrajitr @jasperla @jbenden @jdauphant @jhoekx @jsumners @jtyr @kairoaraujo @kevensen @lberruti @mattjeffery @matze @mcv21 @mpdehaan @mulby @natefoo @nibalizer @obourdon @ovcharenko @pilou- @pmarkham @pyykkis @rhaido @risaacson @ryan_sb @saito-hideki @sebastiendarocha @sfromm @srvg @tacatac @tdtrask @tmshn @xen0l

As a maintainer of a module in the same namespace this new module has been submitted to, your vote counts for shipits. Please review this module and add shipit if you would like to see it merged.

click here for bot help

[dagwieers]

Trying to make multiline edits with the Github suggestion mechanism was rather painful :-(

These are mostly cosmetic changes at this time. Will do second review of the code after this has been accepted.

[molekuul]

Well that was painfull..... this tool isn't just not made for these kind of small adjustments.
I don't know if all are correct now. I will run tests at my own system, shippable will take some time to process all 50+ commits :-)

kind regards,

Joris Weijters

[dagwieers]

bot_skip

[molekuul]

@dagwieers

I did look at all proposed changes, and included then into the module however the status is still Changes requested. What else has to be done to get this module in Ansible?

Kind regards,

Joris Weijters

Outdated

[molekuul]

NIM stands for Network Install Manager. It is meant to install AIX by the network.
At a NIM server you define the LPP-source. This is a repository of filesets containing LPP and RPM packages The LPP packages are the traditional AIX packages, the RPM packages are the Linux packages ported to AIX,

From this LPP-source you install AIX. Multiple LPP_sources can exist.
Installing a AIX server starts with configuring the nimclient at the NIM-Server, and install it.
Compared to Linux you could say: The NIM-Server is like a Satellite server, and the nimclient is the Linux instance where the nimclient command is like the yum command.

How to patch a AIX server which is a nimclient:
The system manager of the NIM-Server updates the software repositories with the patches.
Now there are 2 ways to install these patches at the nimclient:

• push from the NIM-Server
• pull from the nimclient

pushing the patches, means a central management of the clients, and so access to the NIM-Server.
pulling means the owner of the nimclient can patch "his AIX server" without access to the NIM-Server.

In traditional aix system managemt, there is a central team managing the IBM Power hardware, VIO-Server and NIM-Server and nimclients.
In the cloud, the nimclients are owned by the consumer, So pulling patches is the prefered way.
This module is for installing AIX software by pulling

There is a little overlap with the installp module: The "nimclient" command can not remove or commit software. However to have this functionality, in the nimclient module this is done by the installp command.
The installp command is a command to install, update, commit and remove local accessible software packages , if compared to Linux, see it as the rpm command ( however only local packages, no remote http support)

The aixoss packages are written for defining and managing the NIM-Server, and pushing patches to VIO-Servers. A VIO-Server is a special type of server, Virtual I/O Server. This server is used for connecting virtual devices to physical devices. If compared to VMWare, it's like the ESX layer, but it's not the same.

Kind regards,

Joris Weijters

[dagwieers]

LGTM, although this module needs to be reviewed and tested by AIX users.
(We could also benefit from having integration tests)

[flynn1973]

ready_for_review

[flynn1973]

folks, please review to get it merged before collections makes things even more complicated.

[ansibot]

@molekuul Your branch does not contain a shippable.yml file. Please rebase your branch to trigger running of current tests.

click here for bot help

[Akasurde]

Hi @molekuul, Thank you very much for your interest in Ansible. This plugin/module is no longer maintained in this repository and has been migrated to https://github.com/ansible-collections/community.general

If you have further questions please stop by IRC or the mailing list:

* IRC: #ansible on irc.freenode.net
* mailing list: https://groups.google.com/forum/#!forum/ansible-project

needs_info