Understanding workspace and syslogreceiver directories

On Linux HA (Helm) and Swimlane Platform Installer (SPI - Standalone and HA), two directories '/app/workspace' and '/app/log/syslogreceiver', are mounted inside the tasks container by default.

The directory, '/app/workspace' is primarily used from inside the Swimlane Python tasks or forked plugin tasks to temporarily store/retrieve (read/write) files from within the tasks container.

The directory, '/app/log/syslogreceiver', is the storage location when working with Syslog receiver.

The volume type for the aforementioned directories is emptyDir. When the tasks pod(s) are removed/deleted (container restarts are ok), the data is deleted forever.

Using persistent data

In Linux HA Helm, you can change the volume type to persistent data by enabling sharedfs. When sharedfs is enabled, the data in the aforementioned directories are not only accessible from all the tasks pods but more importantly, the data is the same. This is because all task pod(s) will point to the same underlying persistent volume. The main benefit here is that when the tasks pod(s) are removed/deleted, the data will still be available once the pods start up again. In this case, data is not deleted.

To enable this feature:

# Update <your-swimlane-values>.yaml file and run a helm update # Enable syslog and sharedfs.persistentvolume to true syslog: enabled: true sharedfs: persistentVolume: enabled: true

NOTE: Linux HA Helm will be eventually deprecated and sharedfs (enabling persistent data) is NOT available in Swimlane Platform Installer (SPI). If you’re currently using this feature in Helm, then consult your Professional Service Engineer to explore other options.

In Linux Standalone Toolkit (Docker), the two directories, '/app/workspace' and '/app/log/syslogreceiver', are not mounted by default. However, you can mount and allow data to persist by following the steps below:

# Update /opt/swimlane/docker-compose.override.yml services: sw_tasks: volumes: - /opt/swimlane/workspace-vol:/app/workspace sw_syslog_receiver: container_name: sw_syslog_receiver image: swimlane/swimlane-syslog-receiver:latest restart: unless-stopped volumes: - /opt/swimlane/syslog-vol:/app/log/syslog-receiver ports: - 514:5514/udp # Restart sw-tasks

Newer version :

version: '3.7' services: sw_web: sw_mongo: sw_api: #volumes: # - /path/to/thirdpartycerts:/usr/local/share/ca-certificates/swimlane/ sw_tasks: #volumes: # - /path/to/local/workspace:/app/workspace # - /path/to/thirdpartycerts:/usr/local/share/ca-certificates/swimlane/ sw_syslog_receiver: container_name: sw_syslog_receiver image: swimlane/swimlane-syslog-receiver:latest restart: unless-stopped volumes: - syslog-vol:/app/log/syslog-receiver ports: - 514:5514/udp #chrome: # container_name: chrome # image: selenium/standalone-chrome:3.141.59 # restart: unless-stopped # shm_size: '2gb' # networks: # - internal_network volumes: syslog-vol: external: false