v2.15.2

Release Notes

---

Connectivity Refactor

• ipv6 - Previously, this command would remove all IPv6 connectivity to the VPS (node), potentially disrupting access to the node after disabling IPv6. This has been corrected to provide more granular options, disabling only the necessary elements of IPv6 while attempting to maintain access to the node.
  • options: --sysctl, --grub, --both

---

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.15.2/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

v2.15.1

Release Notes

---

Security fixes

• During the process of unlocking the p12 file that contains the node's private/public keys, the passphrase was briefly exposed to the root user if they were monitoring system processes. This issue has been patched. It would only have affected the node if root access had already been compromised.

Feature Enhancements

• --balance option added to dag command to show wallet balance only

Bug fixes

• upgrade_nodectl - Fixed feature reporting False as the current version.
• auto_restart - The feature was not disengaging/reengaging after executing a command that required it to be disabled before completion.
• various bug fixes

---

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.15.1/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

v2.15.0

Release Notes

---

• important feature
  • Tessellation v2.x.x to v3.x.x snapshot structure migration elements added:
    • upgrade process.
    • auto_upgrade process.
    • migrate_datadir feature for manual standalone process.
• new features
  • check_tcp_ports - check the API port access inbound to the Node and output from the Node based on the nodectl configuration settings. Troubleshoot hardware and software firewall/security group rules to ensure they are configured properly.
  • console - menu driven nodectl commands
  • mobile - menu driven nodectl commands - iterative
  • alerting - nodectl now has the ability to send you alerts when your node is not properly on the cluster and daily reports.
  • ipv6 - with added status, enable or disable option to enable or disable IPv6 on the VPS the node is running on.
  • revision - allows nodectl to upgrade itself over itself in the event of a revision during pre-release.
  • added support for Ed25519 SSH key types
  • verify_specs - installation feature that will review the specifications of the VPS to determine if it meets the requirements to run a node.
  • added disk check to the shell handler to warn Node Operator if the node's disk is reaching warning or critical stage
    • 85% warning
    • 95% critical
• feature enhancements
  • send_logs - added ability to upload only singular logs in reference
    to the app.log and nodectl.log.
  • added --leave or -l to the stop command to bypass the request to leave the cluster before stopping the node service, if the node is in a state where is it best practice to leave the cluster before stopping the services on the node.
  • --peer command option now checks if the peer is available before continuing.
  • find option now can accept a --file option with a list of nodeids to check for on the cluster of a given profile.
  • allow unlimited wait requests on join when waiting for layer0 to reach Ready state.
  • update auto_restart to handle SessionStarted timeout handler.
  • find option includes count of nodes found in consensus
  • installer added json-ouput message at end of installation if the --json-output is used.
  • added fallback feature to the download service (being used on TestNet cluster).
  • added -y to bypass confirmation on upgrade
  • added -y to bypass confirmation on refresh_binaries
  • updated the clean_files feature to exclude the newest found configuration backup in order to avoid accident removal with inability to recover a configuration, after-the-fact.
• bug fixes
  • Updated the status command to report WaitingForDownload in yellow and setting ON_NETWORK to True in red.
  • Updated the health command to report memory percentage and fix an uptime counting bug.
  • Updated the configurator to avoid issues with p12 information populating properly; as well as, properly removing old cluster data on migrations and new configurations from an existing node.
  • Updated troubleshooting module unbound error when if a profile list is not found.
  • Updated NTP setup to gracefully handle invalid return codes during setup.
  • Updated join process to better handle new synchronization elements of the protocol to help ensure a Node joins the correct fork prior to transitioning into WaitingForDownload.
  • installer fixed terminal size checks during a quick install if --quiet used as well as removed some output that should not have been showing.
  • Fix UX experience in various places.

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.15.0/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

v2.14.1

Release Notes

---

• update: Dor Metagraph edge point configuration
• bug fix: p12 migration error while setting permissions fixed

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.14.1/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

v2.14.0

Release Notes

---

• add feature: Node can now operate as an NTPv4 (RFC 5905) peer.
  • update to the VPS time, to coordinate with Debian ntp server pool that synchronize their time with highly accurate sources, which may include atomic clocks.
  • sync_node_time to force time sync also with -v verbose option.
• add feature: profile issues lookup.
  • show_profile_issues to review the profile logs and attempt to determine the cause of any issues.
• add feature: Abiltity to execute nodectl user tests integrated into nodectl
  • execute_tests
  • Offers an extensive step by step walk through of most nodectl commands. Can be used to educate about the available commands and also to functionality testing while a version is in pre-release.
• add feature: Copy p12 and/or single file (p12, log, etc) to nodeadmin user for backup
  • prepare_download_file
  • Allows for more simplistic nodeadmin management by setting permissions of root only files temporarily so they can be downloaded and/or backed up off-node.
• add feature: view the snapshot chain link status on your Node
  • display_snapshot_chain
  • This command will parse through your snapshot respository local to your Node and verify that there are no unlinked ordinal to hash elements. *This can sometimes help to identify the cause of a WaitingForDownload state issue.
• enhancement: send_logs
  • updated the send logs menu to be more clear, previously it offered profiles and nodectl, now it offers, profile app logs and nodectl logs.
• enhancement: nodectl_upgrade
  • added extra verbiage to a nodectl_upgrade, to allow a UX distinction between a full upgrade and a nodectl only upgrade.
  • command will now accept a -v with vX.X.X, VX.X.X, and X.X.X (where X.X.X is major, minor and patch level of the version. For example) v2.14.0.
• bug fix: installer
  • Updated a permissions issue while migrating p12 files during installation
• bug fix: auto_restart
  • auto_restart was attempting to read a non-existent file which was causing it to crash.
• bug fix: restart/join bug
  • previously if the configuration was improperly configured, nodectl was not able to determine which profile was affected, and crashing.
• bug fix: starchiver
  • fixed issue with starchiver integration where starchiver was being downloaded from a pre-stardust collective location (techware). Updated the --datetime element to handle all supported datetime formats.
• various bug fixes

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.14.0/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

v2.13.3

Release Notes

---

• Fix bug with join process on error
  • nodectl was calling the error lookup method without valid length argument.
• Fix auto_complete option error

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.13.3/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

v2.13.2

Release Notes

---

• Fixes to installer.
• Enhanced remove_snapshots migrated to display_snapshot_chain.
• Enhanced find command.
  • -t ordinal <ordinal>.
  • -t hash <hash>.
• Added p12 passphrase space restriction.
  • nodectl's encryption methods do not work well with spaces.
• Add nodeid to the show_p12_details command.
• Fix --file and --location settings bug in p12_creation command.
• Refactor to avoid possible system injection attack vectors.
• Added Linux distribution check to installer.
• Minor random stability and bug fixes.

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.13.2/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

v2.13.1

Release Notes

---

• Added full functionality to nodectl if the edge point defined is offline or unavailable.
  • Except in the case of core functionality commands that cannot be utilized unless an external edge point is required (restarts, joins, upgrades).
  • Added ability to bypass edge point manually with --peer and --port.
• Added developer_mode ability to handle WaitingForDownload issues through removal of corrupted snapshots.
• Added getting-started help option
  • sudo nodectl getting-started
• Added new functionality to find command:
  • Now includes nodeid in output of a requested peer ip address.
  • Now includes ip address in output of a requested nodeid.
• Added ability to download Node Operator tests for development purposes directly from nodectl.
• Updated installer:
  • Added --quiet and --json-output to installer.
    • Create a node from automation tools without any output or threading events.
    • You can request a json file output of the final node details after installation.
  • Added DAG wallet address display to final installation output.
• Refactored auto_complete and merged between upgrader and installer for better code reuse and consistency.
• Added improved default configuration options.
• Fixed bugs within the primary functionality of nodectl that would cause a traceback if the network is unreachable.
• Fixed bug with TCP port modifications in the configurator.
• Fixed versioning service issues when the network is unreachable.

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.13.1/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

v2.13.0

Release Notes

• New Feature Enhancement
  • configuration passphrase encryption
    • optional SHA3-512 encryption added to installation and configurator.
• New Feature
  • uninstall
    • sudo nodectl uninstall
    • user can now uninstall the node which would be equivalent to a factory reset on a mobile phone.
• New Feature
  • show_service_status
  • shows the status of all the nodectl specific services
    • owner, service, status code, and status, pid
• New Feature
  • upgrade_vps
  • more simple way to update and upgrade the Debian Linux distribution directly through nodectl
• New Feature
  • show_cpu_memory or -scm
  • validates the 'moment-in-time' CPU % and memory % and compares against Node thresholds.
• New Feature
  • execute_starchiver
  • allows Node operators to access a community owned script to quickly and easily update a Node's local snapshot directories minimizing the 'time-to-participation' on a given cluster, especially during Node installations or Node rebuilds.
• New Feature
  • backup_config
  • allows the Node Operator to backup the nodectl configuration on-demand.
• New Feature
  • restore_config
  • supplies a list of configuration files found in the backup directory and offers ability to restore
    to active configuration.
• New Feature
  • added auto_complete to commands after sudo nodectl is entered.
  • double-tap the <tab> key to see auto_complete options.
• auto_restart
  • added consensus fork detection
  • added auto_upgrade support for Metagraphs
  • added stuck in WaitingForReady detection
  • fix various bugs
• Feature Enhancement
  • Added quick installation
    • quick install will be requested during an installation before continuing
    • sudo nodectl install --quick-install
    • CLI options added to allow "single-click" installations:
      • --quick-install
      • --normal
      • --confirm
      • --cluster-config <requested_cluster_config_name>
      • --user <requested_username>
      • --user-password <requested_user_account_password>
      • --p12-migration-path <full_path_to_p12_to_migrate>
      • --p12-destination-path <full_path_to_p12_destination>
      • --p12-alias <requested_p12_key_store_alias>
      • --p12-passphrase <requested_p12_passphrase>
    • quick install uses all recommended settings otherwise.
    • auto p12 alias extraction on migrations
    • added --brief and -w options to the check_consensus command.
    • removed LB online requirement for stop and leave actions.
  • Full refactor of the installer.
  • added --alias option to the show_p12_details command.
    • If the --alias option is supplied at the command line the p12 for the desired profile will be the only value shown.
  • added current stable and experimental nodectl version to check_version and versioning class
    • will allow for more clear output for an end user to understand.
  • updated user experience for the health command
    • added process memory allocation stats to health command
    • better output visualization
  • added yaml version to check_versions and version command
  • added nodectl log collection option to send_logs command
• Configuration File Updates
  • added external option to gl0-link-key and ml0-link-key
    • this eliminates the Node Operator's need to lookup, enter or modify the nodeid for
      any external host or ip_address entered for both the metagraph and global hypergraph link
      requirements.
  • added jar_version
    • This separates the version from the jar_repository key pair which allows for more
      simplified management of versioning updates.
  • added seed_version
    • This separates the version from the seed_repository key pair which allows for more
      simplified management of versioning updates.
    • set to default to use jar_version otherwise disable or vX.X.X
  • removed p12 alias static configuration requirement
  • added section options to the view_config command.
    • Issuing the appropriate option after the sudo nodectl view_config will only display the specifics requested by the option.
    • to view all available options, please see the help sudo nodectl view_config help and/or enter sudo nodectl view_config -- followed by double tapping the <tab> key on your keyboard to auto_complete the available options.
• Structure Modification
  • seed lists will be stored under their prospective profile directories
• Added further support for Metagraphs
• Various bug fixes

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.13.0/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

unittests

sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.13.0/nodectl_unittests_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl_unittests; sudo chmod +x /usr/local/bin/nodectl_unittests

v2.12.11

Release Notes

• Metagraph Updates
  • Profile identification bug fix. Fixes auto_restart issues as well.
• Seedlist Update Bug Fix
• Download Status feature updates
  - Tweaked the percentage indicator and snaps left elements.

RETRIEVE

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.12.11/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v