Installing configuration drift detection

Edit online

Install the configuration drift detection feature to monitor and track configuration changes in your IBM Storage Protect environment.

Before you begin

Before you begin, review the configuration drift detection overview to understand the feature. For more information, see Configuration drift detection overview.

Ensure that you have the following prerequisites:

  • Ansible version 2.9 or later
  • Python 3.6 or later on the control node
  • Running IBM Storage Protect server instance with valid credentials
  • SSH access to IBM Storage Protect server hosts
  • Valid IBM Storage Protect server credentials (username and password)
  • Appropriate permissions to query server configuration
  • Control node with sufficient disk space for reports (minimum 1 GB recommended)
  • Network connectivity between control node and IBM Storage Protect servers
  • Read access to IBM Storage Protect server configuration files

About this task

The configuration drift detection feature uses Ansible to collect and compare IBM Storage Protect server configurations. This installation procedure covers the setup of the required Ansible collection and environment configuration.

Procedure

To install configuration drift detection, complete the following steps:

  1. Install the IBM Storage Protect Ansible collection:
    Method Command
    From Ansible Galaxy 
    ansible-galaxy collection install ibm.storage_protect
    From source 
    git clone https://github.com/IBM/ansible-storage-protect.git
cd ansible-storage-protect
ansible-galaxy collection build
ansible-galaxy collection install ibm-storage_protect-*.tar.gz
  2. Set the environment variables for IBM Storage Protect server credentials: 
    export STORAGE_PROTECT_SERVERNAME="your_server_name"
export STORAGE_PROTECT_USERNAME="your_username"
export STORAGE_PROTECT_PASSWORD="your_password"

    Replace the placeholder values with your actual IBM Storage Protect server credentials.

  3. Verify that the sp_server_facts module is installed: 
    ansible-doc ibm.storage_protect.sp_server_facts
    The module documentation appears if the installation is successful.
  4. Create the reports directory for storing snapshots and reports: 
    mkdir -p reports
chmod 750 reports
  5. Verify connectivity to IBM Storage Protect servers: 
    ansible -i inventory.ini all -m ping
    A successful ping response confirms that the control node can connect to the IBM Storage Protect servers.

Results

After completing these steps, the configuration drift detection feature is installed and ready to use. The Ansible collection is installed, environment variables are configured, and the reports directory is created.

What to do next

After installation, configure the drift detection parameters and inventory. For more information, see Configuring drift detection.