Configuring client connections

A grid administrator makes configuration choices that affect how Swift clients connect to StorageGRID to store and retrieve data. The specific information you need to make a connection depends upon the configuration that was chosen.

Client applications can store or retrieve objects by connecting to any of the following:

The Load Balancer service is new in StorageGRID 11.3. Existing clients can continue to use the legacy CLB service on Gateway Nodes to connect to StorageGRID. New client applications that depend on StorageGRID to provide load balancing should connect using the Load Balancer service.

When configuring StorageGRID, a grid administrator can use the Grid Manager or the Grid Management API to perform the following steps, all of which are optional:
  1. Configure endpoints for the Load Balancer service.

    You must configure endpoints to use the Load Balancer service. The Load Balancer service on Admin Nodes or Gateway Nodes distributes incoming network connections from client applications to Storage Nodes. When creating a load balancer endpoint, the grid administrator specifies a port number, whether the endpoint accepts HTTP or HTTPS connections, the type of client (S3 or Swift) that will use the endpoint, and the certificate to be used for HTTPS connections (if applicable).

  2. Configure Untrusted Client Networks.

    If a grid administrator configures a node's Client Network to be untrusted, the node only accepts inbound connections on the Client Network on ports that are explicitly configured as load balancer endpoints.

  3. Configure high availability groups.

    If an administrator creates an HA group, the network interfaces of multiple Admin Nodes or Gateway Nodes are placed into an active-backup configuration. Client connections are made using the virtual IP address of the HA group.

For more information about each option, see the instructions for administering StorageGRID.

Information required to make client connections

The table summarizes the information that you require to make a Swift client connection for each configuration.
Where connection is made Service that client connects to IP address Port
HA group Load Balancer Virtual IP of HA group Load balancer endpoint port
Admin Node Load Balancer Admin Node IP address Load balancer endpoint port
Gateway Node Load Balancer Gateway Node IP address Load balancer endpoint port
Gateway Node Legacy CLB Gateway Node IP address
  • HTTPS:8083
  • HTTP:8085
Storage Node LDR Storage Node IP address
  • HTTPS: 18083
  • HTTP:18085

It is possible to configure a DNS name for the IP address that clients use to connect to StorageGRID. Contact your local network administrator.