External Connection¶
Before you start¶
Goal
- Connect the Altair SLC Hub to an existing object store.
Prerequisites
- Have the credentials for the running object store.
- Altair SLC Hub configuration privileges for the host.
Configuring an S3 object store connection¶
Internal Object Store
- If intending to use the internal object store, see here.
Altair SLC Hub requires a connection to an object store to store large object data.
The connection to the object is configured using the object_store
configuration section.
A list of the configuration settings and comments on their use is found in the hub configuration file [etc directory]/config.d/object_store.yaml
.
To configure an object store connection, create a new file in the same directory with a lexicographically greater name.
For example, create an object_store_custom.yaml
file, then modify the settings in that file appropriately.
Make sure the type
is set to s3
:
object_store:
type: s3
endpoint: <URL endpoint>
accessKeyId: <access key>
secretAccessKey: <secret key>
bucketName: <bucket name>
The Altair SLC Hub stores all objects in a single bucket in the object store, and it is assumed that a dedicated bucket is intended for use by Altair SLC Hub. For security, we recommended a dedicated user is created, ensuring that only the dedicated user has write permission to the relevant bucket.
Instructions on installing and configuring MinIO locally for use by Hub are available in the Altair Community Knowledge base. Alternatively, use the Altair SLC Hub internal object store.
Verification¶
Verify object store
- run the hubctl verify objectstore command
Before continuing, it is necessary to verify that the connection information for the object store is correct.
To do this, use the following hubctl
command:
hubctl verify objectstore