- Step 1: Provision a cluster in the PX-Enterprise console
- Step 2: Run discovery and bootstrap on a server node
- Step 3: Configure the Hardware Profile
- Step 4: Expand the cluster
Lighthouse is a management and GUI service that allows you to create PX clusters and launch PX nodes to join your clusters. You can then manage your PX clusters via the Lighthouse web interface.
This section walks through installing and configuring a PX-Enterprise cluster via Lighthouse. In this example, you run the PX-Enterprise Docker container on server nodes. Running the container enables PX-Enterprise to aggregate storage capacity and monitor hardware for degradation and failure. Server nodes are joined into a cluster for the sake of high availability. You can use direct attached disks, storage arrays, or cloud volumes for the underlying storage.
Step 1: Provision a cluster in the PX-Enterprise console
Log in to the PX-Enterprise Lighthouse console. If a cluster has not already been created for your account, click the Manage Clusters menu and then click Manage Clusters.
On the Clusters page, click the + icon to create a new storage cluster.
Then, type a unique Name for your PX-Enterprise cluster and click Create.
(Don’t use the “Existing Cluster” option, unless directed by Portworx Support.)
The new cluster appears in the Clusters list.
Step 2: Run discovery and bootstrap on a server node
You will now add your first server node to the storage cluster. On the Clusters page, click Get Startup Script for the cluster you just created.
A window containing a
curl command opens. The following
curl example includes an authentication token and downloads the PX-Enterprise Docker container.
Log in to each node that will install PX-Enterprise and join the cluster. Open a terminal window and run as
sudo su to give privileges. On your system, copy the
curl string provided by the pop-up window and paste it into a terminal session and press Enter, as shown below.
Step 3: Configure the Hardware Profile
The bootstrap startup script discovers the server/node configuration. It lets you specify which storage and network elements you want to participate in PX-Enterprise.
First menu is Storage Selection Menu You can either pick individual storage devices or can choose to add all devices.
Second menu is Data Network Interface Selection Menu This will let you assign one of your network interfaces as data interface for your this node. The data interface is used between server nodes, primarily for data transfer as part of data availability (that is, multi-node data replication).
Last menu is Management Network Interface Selection Menu This will let you assign one of your network interfaces as management interface for your this PX node. The management interface is used for communication between the hosted PX-Enterprise product and the individual server nodes, for control-path as well as statistics and metrics.
Note: You can choose to use the same interface both for data interface and management interface.PX-Enterprise requires at least one NIC and only needs a maximum of two NICs.
To instruct the PX-Enterprise container on the server node to complete the installation, click Commit Selections on the Management Network Interface Selection Menu. Upon installation, PX-Enterprise aggregates the specified storage and uses the network interfaces selected.
From the server node that ran the
curl command, you should see the following status:
Bootstrap script also saves your selection as a unique Hardware Profile. You can reference this on any other node where you want to run PX-Enterprise with the same storage and network elements.
Step 4: Expand the cluster
You can add new servers nodes to the existing cluster by running the bootstrap script for a cluster. Server nodes can have different Server Profiles, where some servers might contribute little or no storage to the cluster.
For server node connections, use a low-latency network, as opposed to spanning a WAN. For more details, see Step 1: Verify requirements.
At this point you will have a PX-Enterprise cluster that you will be able to monitor from PX-Enterprise console.