Mount OLCF Filesystems

OLCF shared filesystems can be mounted into a container running in Slate. The mountpoints will be the same as a cluster node. The Kubernetes object will need to be annotated in order to get the necessary configuration injected into the container at runtime.

Cluster

Annotation

Value

Mounts

Marble

ccs.ornl.gov/fs

orion

/ccs/sw, /ccs/home, /ccs/sys, /ccs/proj, /lustre/orion

Onyx

ccs.ornl.gov/fs

ccsopen

/ccsopen/sw, /ccsopen/home, /ccsopen/proj, /gpfs/wolf

Onyx

ccs.ornl.gov/fs

themis

/ccsopen/sw, /ccsopen/home, /ccsopen/proj, /nl/themis

Onyx

ccs.ornl.gov/fs

wolf2

/ccsopen/sw, /ccsopen/home, /ccsopen/proj, /gpfs/wolf2

For each of the following examples, replace “ccs.ornl.gov/fs=olcf” or “ccs.ornl.gov/fs: olcf” with an annotation from the above list.

If you already have a Deployment running you can add the annotation with the client

oc annotate deployment web ccs.ornl.gov/fs=olcf

Warning

You cannot annotate an existing pod because the injection happens at pod creation time

Annotating a pod not managed by a deployment with oc annotate pod test ccs.ornl.gov/fs=olcf will not work. Instead delete the pod and add the annotation to the metadata and recreate it.

You can also add the annotations to any workload object’s YAML such as a Pod, Deployment, or DeploymentConfig.

kind: Deployment
metadata:
  annotations:
    ccs.ornl.gov/fs: olcf
---
kind: DeploymentConfig
metadata:
  annotations:
    ccs.ornl.gov/fs: olcf
---
kind: Pod
metadata:
  annotations:
    ccs.ornl.gov/fs: olcf

Full example of a deployment mounting the OLCF shared filesystems:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test-fs
  annotations:
    ccs.ornl.gov/fs: olcf
spec:
  replicas: 1
  selector:
    matchLabels:
      app: test-fs
  template:
    metadata:
      labels:
        app: test-fs
    spec:
      containers:
      - name: test-fs
        image: busybox:latest
        args:
        - cat
        stdin: true
        stdinOnce: true

Note

There are no requirements in the container image in order to mount OLCF filesystems

The following annotations have been retired and should no longer be used in workloads in OpenShift.

Cluster

Annotation

Value

Mounts

Marble

ccs.ornl.gov/fs

olcf

/ccs/sw, /ccs/home, /ccs/sys, /ccs/proj, /gpfs/alpine