Skip to main content
AI Data Engine

Learn about proxies for AI Data Engine

Contributors netapp-dbagwell

If your AI Data Engine (AIDE) host or cluster cannot reach the internet directly, configure a forward proxy so the installer and AI Data Engine can download components, pull container images, and register with NetApp Console. The proxy options are the same for single-node and multi-node deployments. The steps to prepare for and run the installation differ, so each deployment type has its own workflow.

The installer doesn't configure the proxy for other software on the host, such as the package manager. For a single-node deployment, the installer configures the proxy for k3s and AI Data Engine, and adds the CA certificate that you supply with --proxy-ca-cert to the host trust store. For a multi-node deployment, the installer configures only the AI Data Engine workloads. You configure the container runtime proxy and certificate trust on each node.

Deploy AI Data Engine with a proxy

Each deployment type has its own topic with the complete procedure, from preparing the environment to running the installer.

What goes through the proxy

Only internet-bound traffic uses the proxy. All AI Data Engine internet destinations use HTTPS on port 443, so your proxy must allow CONNECT to port 443 for each endpoint in Outbound internet access.

Traffic on your network connects directly and must stay reachable without the proxy:

  • The Console agent (--cm-host)

  • NFS, CIFS/SMB, ONTAP, and StorageGRID data sources

  • Active Directory and LDAP

  • The Kubernetes API server and the cluster's internal networks

Supported proxy configurations

Configuration Description Authentication

No proxy

Direct connection to the internet; no proxy is used.

None

HTTP forward proxy

AI Data Engine connects to the proxy over HTTP and tunnels HTTPS destinations with CONNECT.

None, or HTTP Basic authentication (username and password)

HTTPS forward proxy

AI Data Engine connects to the proxy over TLS. If a private certificate authority (CA) signed the proxy certificate, you supply the CA certificate.

None, or HTTP Basic authentication (username and password)

TLS-inspecting proxy

The proxy decrypts HTTPS traffic and re-signs the certificate of each destination with its own inspection CA. Set --proxy-type t and supply the inspection CA certificate with --proxy-ca-cert. The proxy can listen on HTTP or HTTPS.

None, or HTTP Basic authentication (username and password)

You can address the proxy by host name or IPv4 address.

Supported proxy types

AI Data Engine supports two proxy types. Set the type with --proxy-type.

Regular forward proxy (r) TLS-inspecting proxy (t)

How it handles HTTPS traffic

Tunnels connections with HTTP CONNECT and doesn't change the destination certificates.

Decrypts HTTPS traffic and re-signs the certificate of each destination with the proxy's inspection CA.

--proxy-ca-cert

Required only if the proxy itself uses HTTPS and its certificate is signed by a private CA.

Required. Supply the CA certificate that the proxy uses for inspection. If you omit it, the installer rejects the command before it makes any network connections.

--proxy-type

r (default)

t

A TLS-inspecting proxy is different from an HTTPS proxy. An HTTPS proxy is a proxy that you connect to over TLS (--proxy-scheme https). A TLS-inspecting proxy is a proxy that re-signs the certificates of the destinations that you reach through it. A TLS-inspecting proxy can use either scheme.

Some other proxy features aren't supported. See Known limitations.

The installer uses one proxy for every internet destination and every AI Data Engine component. The proxy settings are set during installation.

Proxy configuration parameters

Parameter Default Description

--proxy-host <host[:port]>

None

Host name or IPv4 address of the forward proxy, without http:// or https://. Enables proxy configuration. Accepts an inline port (host:port). A port in --proxy-host takes precedence over --proxy-port.

--proxy-port <port>

80 for HTTP, 443 for HTTPS

Port the proxy listens on. Ignored if the port is already included in --proxy-host.

--proxy-scheme <http|https>

https

Protocol used to connect to the proxy server itself. This is not the scheme of the destinations that the proxy reaches. Most forward proxies listen on plain HTTP, so pass --proxy-scheme http for those.

--proxy-ca-cert <path>

None

Path to a PEM file, or to a flat directory of .crt and .pem files, that contains the CA certificate for the proxy. The installer reads a directory without recursing into subdirectories and merges the files into one bundle.

This is required when:

  • You use an HTTPS proxy whose certificate is signed by a private CA. Supply the CA certificate that signed the proxy certificate.

  • You use a TLS-inspecting proxy (--proxy-type t). Supply the CA certificate that the proxy uses for inspection.

Don't specify it for a regular proxy (--proxy-type r) that you connect to over HTTP (--proxy-scheme http). There is no proxy certificate to verify, so the installer doesn't use the CA certificate.

--proxy-user <user>

None

Username for basic authentication. With an HTTP proxy, the installer warns that credentials travel to the proxy unencrypted. Requires a password, supplied with --proxy-password-file or entered at the prompt.

--proxy-password-file <path>

None

Path to a local file that contains only the proxy password, with permissions set to 0600 or 0400. If you omit it, the installer prompts for the password with hidden input.

--proxy-type <r|t>

r

Type of proxy. r is a regular forward proxy and is the default. t is a TLS-inspecting proxy, which re-signs the certificate of each destination. With t, you must also specify --proxy-ca-cert.

--no-proxy

—

Explicitly disables proxy configuration and skips proxy prompts. Use it only when the host has direct internet access.

Note The installer doesn't accept --proxy-password or the PROXY_PASSWORD environment variable. Use --proxy-password-file or the interactive prompt instead.

The installer download

The install command copied from NetApp Console downloads the installer from a content delivery network (CDN) and then runs it in one step. The download doesn't use the proxy. If the target host reaches the internet only through a proxy, you download the installer yourself and run the install command from the extracted installer. The deployment topics describe these steps.

Proxy verification

Before the installer downloads anything, it runs a check from the installer host. The check confirms that the proxy responds, that the proxy accepts your credentials, and that the proxy certificate is valid for the scheme you chose. If the check fails, the installer stops and names the cause, for example a wrong port, a wrong scheme, or a rejected password (HTTP 407).

For multi-node deployments, the check covers the proxy only. It does not test whether the cluster nodes can reach the proxy.

Change proxy settings after installation

The proxy settings are set during installation. The installer doesn't run again on an installed cluster. To change the proxy host, port, credentials, or CA certificate after installation, contact NetApp Support.