Hitachi Virtual Storage Platform One Block Storage Modules for Red Hat® Ansible® 4.5.1

The Hitachi Virtual Storage Platform One Block Storage Modules provide a comprehensive set of Ansible modules for managing VSP block storage systems (VSP One Block, VSP 5000 series, VSP E series, VSP F series, and VSP G series) and VSP One SDS Block and Cloud systems. These modules enable seamless integration with Red Hat Ansible, allowing users to automate storage provisioning, configuration, and management tasks.

Hardware requirements

The listed microcode versions are the minimum versions.

Software requirements

• Red Hat Ansible Core - 2.16, 2.17, 2.18, 2.19
• Python - 3.9 or higher

Supported operating systems

• Oracle Enterprise Linux 8.9 or higher
• Red Hat Enterprise Linux 8.9 or higher

Recommended Host configuration

• CPU/vCPU - 2
• Memory - 4 GB
• HardDisk - 30 GB

Idempotence

• Idempotence is supported for this release

Changelog

View the Changelog.

Available Modules

For a detailed list of available modules, please refer to the Modules Documentation.

Installation

Before using this collection, you need to install it with the Ansible Galaxy command-line tool:

ansible-galaxy collection install hitachivantara.vspone_block

collections:
    - hitachivantara.vspone_block.sds_block

collections:
    - hitachivantara.vspone_block.vsp

Note that if you install the collection from Ansible Galaxy, it will not be upgraded automatically when you upgrade the Ansible package.

To upgrade the collection to the latest available version, run the following command:

ansible-galaxy collection install hitachivantara.vspone_block --upgrade

If you need to install a specific version of the collection (for example, to downgrade due to issues in the latest version), you can use the following syntax to install version 4.5.1:

ansible-galaxy collection install hitachivantara.vspone_block:==4.5.1

See using Ansible collections for more details.

Troubleshooting

For troubleshooting tips and common issues, please refer to the Troubleshooting Guide.

Testing

This collection has been tested using the following methods:

Sanity Tests

ansible-test sanity

Use Cases

Below is an example of how this collection can be used to manage a VSP One Block storage system:

Create an LDEV with a specific LDEV ID

This example shows how to create a logical device (LDEV) with a specific ID, pool, and size.

- name: Create LDEV with specific ID
  hosts: localhost
  gather_facts: false
  tasks:
    - name: Create ldev
      hitachivantara.vspone_block.vsp.hv_ldev:
        connection_info: "{{ connection_info }}"
        state: "present"
        spec:
          ldev_id: 345
          pool_id: 15
          size: "1GB"
      register: result

    - name: Debug the result variable
      ansible.builtin.debug:
        var: result

Support

As Red Hat Ansible Certified Content, this collection is entitled to support through the Ansible Automation Platform (AAP) using the Create issue button on the top right corner.

If a support case cannot be opened with Red Hat and the collection has been obtained either from Galaxy or GitHub, there may be community help available on the Ansible Forum.

For additional support, please use one of the following channels:

• GitHub Issues – for bug reports, feature requests, and technical assistance
• Hitachi Vantara Support Portal – for enterprise-grade support (requires valid Hitachi Vantara support contract)

Release Notes and Roadmap

Release Notes

Version 4.5.1 highlights:

• General performance enhancements and bug fixes

Roadmap

• Feature enhancements and new module development
• Ongoing bug fixes and maintenance

License

GPL-3.0-or-later

Author

This collection was created by the Hitachi Vantara® Ansible Team in 2025.