The goal of this document is to help you set up a machine that can connect to your Fusion environment.
If you need a high level overview of Pure Fusion please check out this Youtube playlist.
- Pure Fusion control plane
- Pure1 Edge Services enabled in Pure1
- 1+ Arrays configured with Fusion Agents installed
- An API Client (Application) registered with Pure1 and its associated private key. This API key will need Pure1 Admin permissions.
- An x86-64 Ubuntu linux machine as your control server
- Windows WSL2 with Ubuntu 20.04 is tested working and is actually the author's setup
- Testing and scripting for this project done in a Ubuntu 20.04 vm
- Pull requests for direct Windows and MacOS support welcome
The objective of this guide is to help you setup the tools you can use to interact with your Fusion environment. To that end, you should start by making the setup script executable and running it.
sudo chmod +x setup.sh
./setup.sh API_CLIENT_ID /absolute/PATH_TO_PRIV_KEY
Running this script will set up the following.
HMCTL is the remote CLI utility provided with Fusion. The setup.sh script will install this and configure your profile so that you will be able to interact with your Fusion environment using the API client you provide. It will also run a smoke test to make sure HMCTL is working.
After this install you should be able to run commands as seen in this guide.
Our Python library has full support for all Fusion APIs. The setup.sh script will install the needed dependencies and run a smoke test to make sure it works.
After installation is complete you can refer to the documentation for guidance on writing your own Python scripts.
Our Ansible collection has full support for all Fusion APIs. The setup.sh script will install Ansible and needed dependencies and run a smoke test to make sure it's working.
After installation you can check out the ansible collection from the Ansible documentation page here for more information on the individual modules.
Our Terraform provider supports consumer workflows in Fusion. The setup.sh script will install Terraform and needed dependencies and verify that it is ready. Terraform won't do a full smoke test because it is a consumer-focused provider and requires more Fusion configuration before it can execute.
After installation you can see the Terraform module documentation here for guidance on writing your own Terraform templates.