new_beamline

Setting up a new beamline

This assumes the service is deployed via the helm chart included in the project.

Outline

1. Create a volume mount for GDA integration (if required) a. Restart service
2. Add the path templates to the service configuration

Create a volume mount

Note

This step can be skipped if the GDA integration is not required. The scan number will be tracked internally

The directory used for GDA's number file system needs to be made available to the service. This can be done by adding the directory under the extraVolumeMounts section of the values.yaml when deploying numtracker. At diamond, using the athena-app configuration this can share the single volume defined under the extraVolumes section and just add a subpath as the mount.

extraVolumeMounts:
  - # ... other existing mounts
  - mountPath: /trackers/ixx
    name: dls-sw
    mountPropagation: HostToContainer
    subPath: ixx/software/var

The service will need to be restarted to include this new mount. When deployed with argoCD (as at Diamond), this will be automatic when the change for the volume mounts has been merged.

Add path templates

This can be done by anyone with admin rights to the beamline being configured and is possible via the graphql interface. To work with the authentication, it may be easiest to use the CLI.

numtracker client configure ixx \
    --directory '/dls/ixx/data/{year}/{visit}' \
    --scan '{subdirectory}/{instrument}-{scan_number}' \
    --detector '{subdirectory}/{instrument}-{detector}-{scan_number}'

Note

If GDA uses an extension other than the instrument name for the tracker files, (eg 'tmp'), this should be set via --tracker-file-extension tmp to the configure command.