Skip to main content
NetApp artificial intelligence solutions

9. Operational Guide

Contributors nkarthik

Karthikeyan Nagalingam, NetApp

This guide covers routine execution, monitoring, incident triage, training recovery, archive verification, capacity tuning, and data protection. Use it with the configuration scenarios in Section 8 to operate the same pipeline consistently across local, ONTAP S3, and LustreFS training modes.

9.1 Execution Walkthrough

Trigger a run through trigger_and_wait_ai_pipeline_sklearn.sh with a CONF_JSON payload. The script submits one uniquely named manual run, polls until it reaches a terminal state, and prints local log tails for failed tasks when available. Each primary task emits an effective_config record at startup so operators can verify the evaluated configuration rather than relying on the submitted payload alone.

9.2 Monitoring and Observability

Monitor DAG state in the Airflow UI or CLI and correlate it with the run ID and run_stamp. The guard logs are grep-friendly: [data_prep] effective_config, [model_training] effective_config, [xcp_copy] effective_config, and [checkpoint] resume_summary. Review these entries to validate the transformation engine, selected XCP destination, training source, and checkpoint reuse decision for each run.

9.3 Troubleshooting Quick Reference

Use this table to connect common task failures to the first corrective action. Resolve source connectivity and mount problems before retrying a run; retrying without correcting an invalid configuration or unavailable endpoint will reproduce the same failure.

Symptom Likely Cause Resolution

Could not resolve XCP S3 credentials

Missing/incorrect xcp_s3_profile in xcp_s3_profiles

Verify profile name and credentials map

no readable Lustre source directory

LustreFS not mounted or wrong xcp_lustrefs_dest_path

Verify the filesystem type with findmnt -T /mnt/lustre/client -o FSTYPE,TARGET -n; correct path

Missing required text dataset files

Text JSONs absent in raw S3 prefix

Upload text_base.json, text_finetune.json, text_infer.json

Preflight exit code 1

SSH unreachable

Verify ssh_default connection and host/user

Preflight exit code 2

NFS path not exported/visible

Verify export with xcp show <ip>

9.4 Checkpoint Operations

Checkpointing applies only to model_training. Set training_checkpoint_reuse_mode=resume_if_exists to reuse a valid completed training result and skip redundant model training, or use verify_only to validate checkpoint eligibility without skipping. Keep reuse disabled (off) during initial testing or whenever training inputs, configuration, or expected artifacts have changed.

9.5 Manual Archive Operations

Set manual_archive_enabled=true and choose manual_archive_stage deliberately. Use model_training when governance requires the core model baseline as soon as training succeeds; use inferencing when the archive must include final predictions. A run with model_training selected continues to fine-tuning and inference after the archival branch; it simply does not archive their later outputs. Verify uploads under the run-stamped StorageGRID prefix and review [manual_archive] logs for the selected stage, files found, and upload count.

9.6 Scaling Guidance

Tune sample_count, spark_driver_memory, spark_executor_memory, and spark_timeout_secs to the input volume and service-level objective. Start with bounded samples to validate data shape and routing, then use sample_count=0 for all-row runs after StorageGRID, ONTAP NAS, XCP, and the selected training tier have sufficient capacity and throughput.

9.7 Backup and Recovery

Protect the ONTAP NAS prepared-data bucket with ONTAP Snapshot and backup. Apply StorageGRID protection and retention policies to raw and archival buckets; the archival bucket retains history independent of pipeline re-execution. Combine these storage protections with the training checkpoint record to recover the correct run-scoped data and baseline artifacts after a task, host, or site-level interruption.