paul-dh/fujitsu-ansible-irmc-integration

The Fujitsu Software Serverview Ansible iRMC Integration features modules and playbooks to access and manage Fujitsu PRIMERGY servers via iRMC.

Manage Fujitsu PRIMERGY servers via iRMC

The Fujitsu Software Serverview Ansible iRMC Integration features modules to access and manage Fujitsu PRIMERGY servers via iRMC.

Table of Contents

1. Overview
2. Requirements
3. Getting Started
4. API Documentation
5. Usage
6. Modules
7. Playbooks
8. History
9. License
10. Authors

Overview

These modules and examples are intended to provide easy-to-follow and understandable solutions to manage Fujitsu PRIMERY server settings via iRMC.

Version: V1.2

Requirements

• Fujitsu PRIMERGY Server with iRMC S4 FW >= 9.04 or iRMC S5 FW >= 1.25
• Ansible >= 2.4
• Python >= 2.6
• Python modules 'future', 'requests', 'urllib3', 'requests_toolbelt'

The modules were tested on RHEL 6, RHEL 7, SLES 12, SLES 15.

Getting started

• Copy or clone the content of this repo to your playbook directory or to your ANSIBLE_LIBRARY
• See DOCUMENTATION.md, the examples in examples or the modules in library how to use Fujitsu's iRMC modules
• Copy the example playbooks to the main folder and adapt the and the variables in group_vars to your environment and run the playbooks.

Documentation

• Specification: iRMC RESTful API
• Specification: iRMC Redfish API
• Whitepaper: iRMC RESTful Server Management API
• Whitepaper: iRMC Remote Scripting and Configuration

Usage

Examples should be run from the root folder.
Note that the library and module_utiles folders are automatically searched by Ansible for modules when running from playbooks.

Example command to run irmc_facts_examples.yml:

ansible-playbook irmc_facts_examples.yml

Run the verbose version with:

ansible-playbook -vvv irmc_facts_examples.yml

Modules

The following modules are part of this project:

• irmc_biosbootorder - configure iRMC to force next boot to specified option
• irmc_certificate - manage iRMC certificates
• irmc_compare_profiles - compare two iRMC profiles
• irmc_connectvm - connect iRMC Virtual Media Data
• irmc_eventlog - handle iRMC eventlogs
• irmc_facts - get or set Fujitsu PRIMERGY server and iRMC facts
• irmc_fwbios_update - update iRMC Firmware or server BIOS
• irmc_getvm - get iRMC Virtual Media Data
• irmc_idled - get or set server ID LED
• irmc_ldap - manage iRMC LDAP settings
• irmc_license - manage iRMC user accounts
• irmc_ntp - manage iRMC time options
• irmc_powerstate - get or set server power state
• irmc_profiles - handle iRMC profiles
• irmc_scci - execute iRMC remote SCCI commands
• irmc_session - handle iRMC sessions
• irmc_setnextboot - configure iRMC to force next boot to specified option
• irmc_setvm - set iRMC Virtual Media Data
• irmc_task - handle iRMC tasks
• irmc_user - manage iRMC user accounts

For details please refer to the Module Documentation

Playbooks

The following playbooks are part of this package to demonstrate the usage of the modules:

• irmc_biosbootorder_examples.yml
• irmc_cas_examples.yml
• irmc_certificate_examples.yml
• irmc_compare_profiles_examples.yml
• irmc_connectvm_examples.yml
• irmc_eventlog_examples.yml
• irmc_facts_examples.yml
• irmc_fwbios_update_examples.yml
• irmc_getvm_examples.yml
• irmc_idled_examples.yml
• irmc_ldap_examples.yml
• irmc_license_examples.yml
• irmc_ntp_examples.yml
• irmc_powerstate_examples.yml
• irmc_profiles_examples.yml
• irmc_scci_examples.yml
• irmc_session_examples.yml
• irmc_setnextboot_examples.yml
• irmc_setvm_examples.yml
• irmc_task_examples.yml
• irmc_user_examples.yml

The following playbooks are part of this package to demonstrate the solution for common bare-metal-server provisioning tasks:

• boot_to_virtual_cd.yml
• compare_server_configuration_against_saved_profiles.yml
• create_new_user_and_remove_old_user.yml
• create_user_from_file.yml
• export_ldap_settings_to_file.yml
• export_server_configuration_profiles_to_files.yml
• export_user_data_to_file.yml
• get_server_facts.yml
• import_ldap_settings_from_file.yml
• set_bios_boot_order.yml
• set_bios_boot_order_default.yml

Change log

• V1.0: Initial version
• V1.1: New: iRMC FW/BIOS update, BIOS boot order, iRMC profile management
• V1.2: New: eLCM Offline/Online Update, RAID configuration

License

FUJITSU LIMITED Copyright 2018-2019 FUJITSU LIMITED

GNU General Public License v3.0+ (see LICENSE.md or https://www.gnu.org/licenses/gpl-3.0.txt)

Authors

• [Nakamura Takayuki] (https://github.com/nakamura-taka)