Skip to content

Conversation

@errnair
Copy link
Owner

@errnair errnair commented Nov 8, 2025

Summary

Cleanup and deprecation of all old script locations, providing clear migration paths to modernized scripts.

Changes

Deprecated Scripts Removed

Removed 12 old scripts from their original locations and replaced with deprecation notices:

server_management/CentOS/

  • system_stats.sh
  • change_hostname.sh
  • permissive_selinux.sh
  • create_db.sh
  • sync_emails.sh
  • nginx/newuser.sh

server_management/Debian/

  • install_salt_minion.sh

miscellaneous/

  • checkssh_conn.sh
  • dirbackup.sh
  • etcbackup.sh
  • passgen.sh
  • webpagedl.sh

Deprecation Notices Created

Each old script location now has a DEPRECATED_*.sh file that:

  • Displays a clear deprecation warning
  • Shows the new location of the modernized script
  • Lists what has changed/improved
  • Provides migration examples
  • Exits with code 1 to prevent accidental usage

Documentation Added

Created README.md files in deprecated directories:

  • server_management/CentOS/README.md
  • server_management/Debian/README.md
  • miscellaneous/README.md

Each README provides:

  • Status of the directory (deprecated)
  • Complete mapping table of old to new locations
  • Explanation of enhancements
  • Timeline for removal

Migration Guide

Script Location Changes

Old Location New Location Status
server_management/CentOS/system_stats.sh server_management/system_stats.sh Multi-OS
server_management/CentOS/change_hostname.sh server_management/change_hostname.sh Multi-OS
server_management/CentOS/permissive_selinux.sh server_management/selinux_troubleshoot.sh Enhanced
server_management/CentOS/create_db.sh installation_scripts/create_db.sh Multi-OS
server_management/CentOS/sync_emails.sh installation_scripts/sync_emails.sh Multi-OS
server_management/CentOS/nginx/newuser.sh installation_scripts/install_flask.sh Replaced
server_management/Debian/install_salt_minion.sh installation_scripts/install_salt_minion.sh Multi-OS
miscellaneous/dirbackup.sh utilities/dirbackup.sh Enhanced
miscellaneous/etcbackup.sh utilities/etcbackup.sh Wrapper
miscellaneous/passgen.sh utilities/passgen.sh Enhanced
miscellaneous/webpagedl.sh utilities/webpagedl.sh Enhanced
miscellaneous/checkssh_conn.sh installation_scripts/checkssh_conn.sh Multi-OS

Benefits

Cleaner Repository Structure

  • Scripts organized by function (installation, server management, utilities)
  • No OS-specific subdirectories for multi-OS scripts
  • Consistent naming and location conventions

Clear Migration Path

  • Users immediately see deprecation notices when running old scripts
  • README files in each old directory explain the reorganization
  • Migration examples provided for every script

Prevents Confusion

  • Old scripts cannot be accidentally used
  • Deprecation notices exit with error code 1
  • Clear messaging about which script to use instead

Testing

Tested deprecation notice functionality:

  • Deprecation scripts display correct information
  • Scripts exit with code 1
  • Messages are clear and actionable
  • Examples are accurate

Impact

This is a breaking change for users with existing automation using old script paths.

Required Actions for Users

  1. Update any scripts or automation referencing old paths
  2. Review new script features and environment variables
  3. Test with new scripts before deploying to production

Timeline

  • Deprecation notices are immediate (this PR)
  • Old script files removed (this PR)
  • Deprecated directories may be removed in future release
  • Users have migration path via deprecation notices

Example Deprecation Notice

When a user runs an old script path:

$ ./miscellaneous/passgen.sh ================================================================================ DEPRECATION NOTICE ================================================================================ This script has been DEPRECATED and moved to a new location. OLD LOCATION: miscellaneous/passgen.sh NEW LOCATION: utilities/passgen.sh WHAT CHANGED: - Multiple password types (alphanumeric, special, passphrase, PIN) - Password strength assessment with entropy calculation - Avoid ambiguous characters option - Multiple output formats (text, JSON, CSV) - Clipboard integration - Bulk password generation MIGRATION: Old: ./miscellaneous/passgen.sh [count] [length] New: ./utilities/passgen.sh [count] [length] [... examples ...]

Files Changed

  • 12 scripts removed
  • 12 deprecation notices added
  • 3 README files added
  • Net: +503 lines (documentation), -615 lines (old code)
This commit deprecates all old script locations and provides clear migration paths to the new modernized scripts. Changes: - Removed old scripts from original locations - Created DEPRECATED_*.sh notices for all moved scripts - Added README.md files in old directories explaining reorganization Deprecated Locations: - server_management/CentOS/*.sh → Moved to server_management/ or installation_scripts/ - server_management/Debian/*.sh → Moved to installation_scripts/ - miscellaneous/*.sh → Moved to utilities/ or installation_scripts/ Each DEPRECATED script provides: - New location of the modernized script - Summary of enhancements - Migration examples - Exit code 1 to prevent accidental usage README files added: - server_management/CentOS/README.md - server_management/Debian/README.md - miscellaneous/README.md These provide directory-level migration guides with complete mapping tables. Timeline: Deprecated scripts will be removed in a future release. Users should update to new locations immediately.
@errnair errnair merged commit 0c2c5c2 into master Nov 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants