Skip to content

docs: perfSONAR toolkit installer updates (fetch more helpers, version bump)#64

Merged
ShawnMcKee merged 1 commit intomasterfrom
docs/perfsonar-toolkit
Dec 16, 2025
Merged

docs: perfSONAR toolkit installer updates (fetch more helpers, version bump)#64
ShawnMcKee merged 1 commit intomasterfrom
docs/perfsonar-toolkit

Conversation

@ShawnMcKee
Copy link
Contributor

@ShawnMcKee ShawnMcKee commented Dec 16, 2025

Cleaned PR description: installer & lsregistration helper updates

Summary

  • Installer (install_tools_scripts.sh): bump to 1.0.1 and expand fetch behavior to provide a fuller set of helper scripts and documentation files. The installer now attempts to download accompanying .sha256 checksum files when present.
  • Added to installer fetch list: fasterdata-tuning.sh, repair-state-json.sh, and other recent helper scripts so bootstrap installs get the latest tooling.
  • Checksums: added/updated .sha256 files for modified scripts under docs/perfsonar/tools_scripts/ so verification scripts can validate releases.
  • lsregistration helper (perfSONAR-update-lsregistration.sh): improved restart behavior to better support RPM (non-container) installs by preferring the perfsonar-lsregistrationdaemon unit when present, falling back to lsregistrationdaemon, and finally to signalling the process; encapsulated restart logic in helper functions.
  • Docs: updated CHANGELOG.md, README-lsregistration.md, and install-perfsonar-toolkit.md to document these changes.

Testing & reviewer checklist

  1. Run the installer on a staging host and verify /opt/perfsonar-tp/tools_scripts contains the expected scripts and .sha256 files.
  2. Verify checksum consistency for key scripts (example):
    • sha256sum /opt/perfsonar-tp/tools_scripts/fasterdata-tuning.sh
    • Compare result with the contents of fasterdata-tuning.sh.sha256 in the same directory.
  3. Test perfSONAR-update-lsregistration.sh in both modes:
    • Container mode (default): confirm it copies, updates, and restarts inside the running perfsonar-testpoint container.
    • Local mode (--local): confirm it writes to /etc/perfsonar/lsregistrationdaemon.conf and attempts to restart perfsonar-lsregistrationdaemon (or falls back to lsregistrationdaemon).
  4. Optionally run shellcheck on modified scripts for style/safety checks.

Notes

  • I verified checksums locally and confirmed the installer fetch list includes the newly-added helpers.
  • I also updated install_tools_scripts.sh.sha256, perfSONAR-update-lsregistration.sh.sha256, and other relevant checksum files.

If you want, I can squash commits, add more documentation examples, or merge the PR when it's approved.

@ShawnMcKee
Copy link
Contributor Author

Summary of changes in this PR:\n\n- Installer: bumped to 1.0.1. It now fetches a fuller set of helper scripts and docs and attempts to download accompanying checksum files when available.\n- Added to installer fetch list: , , and other recent helpers.\n- Checksums: updated files for modified scripts (see ).\n- lsregistration helper: now prefers (RPM installs) and falls back to or when appropriate; restart logic encapsulated in helper functions.\n- Docs: and updated to reflect the installer bump and restart behavior.\n\nTesting & notes:\n- I verified checksums locally and that the installer includes the listed scripts.\n- Suggested reviewer test: run the installer on a staging host and verify contains scripts and corresponding files, then run the and container modes to confirm restart behavior.\n\nIf you want, I can squash commits, add more docs, or merge the PR when approved.

…mp to 1.0.1 and expand fetched helper scripts and docs.\n- Add and to installer fetch list.\n- Update .sha256 checksum files for modified scripts.\n- Improve restart behavior for RPM/local installs; prefer unit.\n- Update CHANGELOG and README-lsregistration.
@ShawnMcKee ShawnMcKee force-pushed the docs/perfsonar-toolkit branch from 207834c to 016d56d Compare December 16, 2025 19:31
@ShawnMcKee ShawnMcKee merged commit ff6885f into master Dec 16, 2025
@ShawnMcKee ShawnMcKee deleted the docs/perfsonar-toolkit branch December 16, 2025 19:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant