v2.11.3

Release Notes

• bug fix
  • p12 installer migration issue was identified where if a Node Operator requests to migrate an existing p12 file however did not properly upload, the installer would fail. Added valid error with hint to verify p12 was uploaded.
• bug fix
  • Seed list was being incorrectly named on MainNet as well as the the seedlist url was not properly picking up the current Tessellation version number. Made corrections to fix this issue.
• bug fix
  • In the event the an API call was unable to reach the backend explorer on a status request, nodectl would crash on certain circumstances when it wasn't able to complete the data pulls, added double check and proper error on failure.

RETRIEVE

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.11.3/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.11.3/nodectl_unittests_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl_unittests; sudo chmod +x /usr/local/bin/nodectl_unittests

ARM_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.11.3/nodectl_arm64 -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.11.3/nodectl_unittests_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl_unittests; sudo chmod +x /usr/local/bin/nodectl_unittests

v2.11.2

Release Notes

• bug fix
  • p12 migration issue was identified where a traceback while attempting to check the p12 location occured in certain circumstances.
  • updated the ownership and versioning of migrated p12 files
  • updated the ownership of new p12 creation during installation
• bug fix
  • upgrade_path command would report incorrect path next version choosing last instead of first.
• bug fix
  • upgrade_nodectl script build updated to disable auto_restart before upgrading, previously if the service was running there was a chance the binary would be busy and not upgrade properly.

RETRIEVE

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.11.2/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.11.2/nodectl_unittests_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl_unittests; sudo chmod +x /usr/local/bin/nodectl_unittests

ARM_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.11.2/nodectl_arm64 -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.11.2/nodectl_unittests_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl_unittests; sudo chmod +x /usr/local/bin/nodectl_unittests

v2.11.1

Release Notes

• feature enhancement
  • added download_status --snapshot feature
  • If you add --snapshot to download_status command it will take a snapshot of progress at that specific point in time and exit.
• feature enhancement
  • added -v option to upgrade_nodectl
  • If you use the -v option if will force nodectl to upgrade or downgrade to the specific version requested.
• bug fix
  • check_versions incorrectly tested version match on Tessellation versions
• bug fix
  • auto_upgrade on auto_restart was incorrectly skipping the upgrade for secondary profiles.

RETRIEVE

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.11.1/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.11.1/nodectl_unittests_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl_unittests; sudo chmod +x /usr/local/bin/nodectl_unittests

ARM_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.11.1/nodectl_arm64 -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.11.1/nodectl_unittests_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl_unittests; sudo chmod +x /usr/local/bin/nodectl_unittests

v2.11.0

v2.11.0 Release Notes

• new feature
  • removed static versioning fetching with file based version
  • added sudo nodectl update_version_object
    • update_version_object will review the current known versioning and update if out-of-date based on timing
    • -f will force the upgrade
    • -v will verify the versioning object if valid
• refactored help service
  • added some formatting to handle available commands and future refactoring of help file.
• feature enhancement
  • sudo nodectl find -p <profile>
  • added DownloadInProgress, WaitingForDownload, WaitingForObserving, WaitingForReady counts.
  • fixed not found bug
• feature enhancement
  - experimental! added --estimate to the download_status command. If used nodectl will attempt to give an estimated time frame for when the node will complete the DownloadInProgress stage, and enter into Observing. The values created by this feature are only for an estimate and is not reliant.
• bug fix
  • check_versions produced a traceback when attempting to retrieve new versioning, this was fixed.
• bug fix
  • download_status produced a traceback in circumstances when the log scrapping returned an invalid entry, added automatic recovery to avoid future tracebacks.
• bug fix
  • nodeid -t would produce a traceback if not found in the API return results, as well as an invalid error if the external lookup was not reachable. Fixed traceback and updated error message.

RETRIEVE

X86_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.11.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.11.0/nodectl_unittests_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl_unittests; sudo chmod +x /usr/local/bin/nodectl_unittests

ARM_64

nodectl

sudo nodectl auto_restart disable; sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.11.0/nodectl_arm64 -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.11.0/nodectl_unittests_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl_unittests; sudo chmod +x /usr/local/bin/nodectl_unittests

v2.10.1

Release Notes

• Bug Fix - Auto Restart
  • Previously on an exception being created for any reason the auto_restart would report the error; however, would not restart the auto_restart services. This has been corrected.
  • Bug found with the minority fork detection being checked against layer1, this has been removed.
• Bug Fix - download_status
  • As the status was calculating values, a traceback was found when attempting to format the display output. nodectl will now check the values before attempting to display them.
  • The output display was misrepresenting the actions taking place. Reworded the display on ordinal downloads in an attempt to make it more clear to the Node Operator watching the status.
• Bug Fix - upgrade_nodectl
  • After versioning service was put in place the upgrade_nodectl command stopped working properly, this was corrected.

RETRIEVE

X86_64

nodectl

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

unittests

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

ARM_64

nodectl

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

unittests

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

v2.10.0

Release Notes

• new security feature
  • added new command sudo nodectl verify_nodectl
  • added digital signature to the nodectl binary to validate locally against the repository
• refactor enhancement
  • added version_obj fetching service
  • removed excessive call stack for class object creation
• auto_restart feature enhancement
  • added on-boot option.
    • The auto_restart feature can be started on the boot of the VPS automatically.
  • added minority fork detection
    • In the event that your Node is processing snapshot proofs in parallel with the main fork of the current cluster the Node is configured as a peer on, but that do not match up with the cluster's last known snapshot, the Node will restart to ensure the Node re-joins the main fork.
• new feature
  • added new command sudo nodectl download_status
  • If the node is in DownloadInProgress nodectl will review the snapshots from the app.log and report the status with a progress indicator and snapshot ordinals.
• new feature
  • added new command sudo nodectl show_node_proofs
  • Reviews the latest proofs being processed on the Node at the current moment in time.
• new feature
  • added new command sudo nodectl uptime
  • this command will output cluster and node uptime
• new feature
  - added new command sudo nodectl show_dip_error
  - this command will output any errors found during the DownloadInProgress state of the node that may result in a WaitingForDownload state.
• feature enhancement
  • added nodeid, restart time, and uptime to status and quick_status
• feature enhancement
  • added -v option to refresh_binaries command
  • if -v is used the refresh_binaries will use this version to attempt to download the Tessellation jar files. If the version is inaccurate this will render your Node inoperable until corrected. Use with caution.
• bug fix
  • configurator new configuration builds unable to clean old snapshot directories if the profile names changed.
• bug fix
  • install Constellation MainNet seedlist download would fail for an invalid version lookup
  • updated version lookup definition
• bug fix
  • auto_restart versioning issue lookup crashed the auto_restart
  • removed possible race condition on auto_upgrade
• bug fix
  • check_version exception on --skip_warning_messages
  • check_version was not properly reporting mismatch in nodectl versions
• command removal
  • clean_snapshots removed.
    • This command no longer hold any efficacy. Snapshot storage is now migrated to incremental snapshots that should not be manually manipulated by the Node Operator.
  • auto_upgrade option removed from a manual start of the auto_restart service. This should be set in the configuration via the configure command.
  • deprecate the -ni option for --ni (non-interactive option) for various commands that support this option.

RETRIEVE

X86_64

nodectl

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

unittests

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

ARM_64

nodectl

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

unittests

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

v2.9.0

v2.9.0 Release Notes

• New Features
  - support for custom pre-defined profiles.
  • Adds support for Metagraphs.
  • Add Metagraph jar file support.
  • Add custom incremental snapshot re-directs.
  • Add custom jar execution arguments.
  • Add custom environment variable inputs.
  • Add Metagraph Token Identifier.
• New Feature
  • Add quick_status feature
  • Shows only Node status states
  • sudo nodectl quick_status or sudo nodectl -qs
  • use -p <profile_name> for single profiles
• New Feature
  • Add show_service_log feature
  • Outputs the journalctl log entries for a specified profile
• New Feature
  • Added profile or environment selection list to most commands that require
    such, if not specified. In the past, the Node Operator was met with a error message and
    hint to provide the -p or -e options.
• Feature Update - status (and quick status) command
  • adds -w <range_in_seconds> watch option.
  • when the option is added to either command nodectl will continue to check the status for you until you issue a quit command.
• Feature Update - list command
  • adds list of custom Metagraph arguments if configured.
• Feature Update:
  • If check_connection is called using -e or -s if the edge or source
    is not found on the cluster, the method will now warn the user and
    use a random alternative.
• Feature Update:
  • Added join WaitingForDownload and DownloadInProgress state checks to
    speed up wait times for an upgrade or restart request.
• Feature Update:
  • Add backup and restore on failure to the method responsible for retrieving
    binary files. In previous versions of nodectl if the file
    failed to download, it would leave an empty file with the correct naming convention
    that could corrupt nodectl's ability to properly operate.
• Feature Update:
  • Added -id switch to the check_seedlist command .
  • If a -id followed by a nodeid is added to the command, nodectl will
    specifically lookup that nodeid against the Node's known seed list.
• Feature update:
  • upgrade_path now requires environment option -e because multiple
    release versions may be present on systems with multiple environments.
• Feature Update:
  • Added -r option to restart command.
  • If the -r <number (integer)> is added to the restart command, the number of
    times nodectl retries a connection will be changed from default of 3 to whatever
    integer value the Node Operator inputs.
• Feature Update:
  • Added -p option to list command.
  • print out only a list of profiles without details.
• Refactor Configuration File
  - cn-config.yaml
  • Adds support for Metagraphs.
  • Flattens configuration parameters.
  • Deprecates https parameter.
    • replaced by adding port 443 to the edge_point port value.
• Refactor Configurator
  • Configurator can now load any approved pre-defined configuration.
  • Updated Edit sections to handle new configuration format.
  • Enabled auto reload of configuration.
    • In previous releases the configurator needed to be reloaded for certain
      updates.
  • Auto restart engage and disengage when enabled/disabled
    • In previous releases the configurator would not enable auto restart; instead,
      the Node Operator needed to execute a nodectl command to engage the auto_restart.
• Bug Fix
  • added support for unlocking p12 files used for various authentication purposes created
    on legacy nodes that may be incompatible with newer versions of openssl.
• Deprecate snapshot cleanup on Join
  • Reduce ingress/egress and avoid creating longer DownloadInProgress wait times.
• Update service change threads to attempt to lower latency on service changes.
• Added seedlist match issue error to the troubleshoot module.
• Added DownloadInProgress to -cc allow list for peer checking.
• Logger updated
  • Now allows Node Operator to set the logging level in the global configuration.
  • Previously this was statically set.

RETRIEVE

X86_64

nodectl

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

---

ARM_64

nodectl

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

v2.8.1

Release Notes:

• IntegrationNet config upgrade
  • Updates static single source node to load balancers
  • This will create a more stable connection and status experience
• Deprecate versioning flat file for upgrade_path.json
• Deprecate all netmet github repository dependencies
• Merge all environments to single nodectl version(s)
  • Refactoring of upgrade logic
• Minor UX rewording

MANUAL INSTALLATION

note: manual instructions assume nodectl is already installed

x86

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

arm64

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

v2.8.0

Release Notes

• Preparation for IntegrationNet
  • predefined integrationnet profile added
• Redirect internal static links to Github open sourced repository
• Configurator Updates
  • add snapshot cleanup to new configuration builds
• Fix bug
  • dag command sudo nodectl dag -p <profile_name>
  • calculating valid DAG amount function to display transactions was off by 1 digit causing feature not to display all valid transaction in the final output list.
• Fix bug
  • log request was forcing profile input for nodectl log when not necessary.
• Fix bug
  • change_ssh_port sudo nodectl change_ssh_port --port <port_number>
  • removed confusing and conflicting -p switch for --port and updated help files.
• Miscellaneous
  • added catch blocks for dependency error on install
  • fixed duplicate error-code

MANUAL INSTALLATION

note: manual instructions assume nodectl is already installed

x86

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

arm64

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

v2.7.1

note nodectl was developed and released to the TestNet prior to this official release. v2.0.0 through v2.7.0 were in beta on TestNet.

note Version 2.7.1 is not compatible with IntegrationNet.

Release Notes

• dynamic configuration added

• feature add - clean snapshots

  • sudo nodectl clear_cache deprecated
  • sudo nodectl clean_snapshots sudo nodectl -cs
    • Dedicated command to clear snapshots that may be filling up the disk
    • Cleans snapshots older than 30 days

• program wide refactoring of code

• performance latency updates

• swap file utilization fixes

• restart, join

  • service state detection added
  • threading enabled
  • -w watch added see help

• added file size error checking for

  • Tessellation binaries during download
  • Seed List file during download

• join

  • joins are only attempted against other Nodes
    that are participating in consensus
    • join peer connection status removal -w
      • join will only watch peers join until Layer0 link dependencies are met unless -w (watch) switch added.

• status command

  • added -p all option as default
  • options
    • nodectl status -p profile_name
    • nodectl status -p all
    • nodectl status (will default to -p all)

• find command enhancement

  • added overall, Ready, and Observing count

• nodeid refactor

  • added -t [target] flag to allow nodeid retrieval of any
    Node on the cluster based on NodeId address
  • eg) sudo nodectl nodeid -i <node_id>
  • deprecated -t switch (redundant to whoami)

• whoami feature add

  • added -id [nodeid] with -p [profile_name]
    allows lookup of an IP address on the cluster (based on the profile_name) derived from nodeid
    • nodectl whoami -id abc123...xyz321 -t dag-l0

• updated help file

  • added extended help for most commands
  • added hints

• peers command

  • fixed bug where the Node states were not showing up
  • peers now defaults to node IP with:
    - added TCP public port
    - nodeid (shortened)
    - DAG wallet address (shortened)
  • added -c (count) option (synonymous for find command)
  • added --extended switch to show full nodeid and DAG wallet.
  • added --basic switch to show only TCP/IP.

• nodectl_upgrade command enhancement

  • added automated upgrade capabilities
    • certain nodectl upgrades require an additional upgrade to modify services, files, or other components in the background.
      Previous versions required you issue the sudo nodectl_upgrade followed by sudo nodectl upgrade in these cases. nodectl will now offer the option on upgrading nodectl.

• installation

  • includes ability to transfer p12 or create new on installation
  • installer offers instructions on how to proceed including p12 file search
    • auto find available p12 files.

• new feature

  • automated auto_restart
    • auto_restart can be enabled in the configuration. This will enable it to re-engage if disabled either manually or by nodectl for any command that requires auto_restart to be temporarily disabled.

• new feature

  • auto_upgrade
    • if enabled in the configuration, auto_restart will attempt to upgrade Tessellation if a new version is detected.
    • --auto_upgrade switch added to auto_upgrade command.

• new feature

  • auto_restart status
    • synonymous with 'check_pid'

• new feature

  • sudo nodectl upgrade_path
    • offers the user ability to check on their node's version and how it relates
      to the newest release.

• new feature

  • sudo nodectl refresh_binaries (-rtb)
    • offers the Node Operator ability to download binaries independant of an upgrade.
    • command should be used in conjunction with a restart command (see help)

• new feature

  • sudo nodectl show_current_rewards (-scr)
    • shows rewards accumulated per snapshot for all found wallets
    • sudo nodectl -scr help for details

• new feature

  • sudo nodectl nodeid2dag
    • this command takes in a 128 hexadecimal node id and returns its associated Constellation Network DAG wallet address.
    • sudo nodectl nodeid2dag <nodeid>
    • note: this is a one-way hash function

• new feature

  • sudo nodectl view_config (-vc) (-np)
    • new to v2.x.x is a configuration file used for all aspects of nodectl's decision making. This command will allow you to review the configuration
      • the file will be paginated unless -np is used (no pagination).

• CSV (comma separated values) enhancement added

  • peers
  • show_current_rewards
  • dag
    • utilize the --csv switch to pipe output of the following commands to default named csv file.
    • utilize the --output <file_name> with the --csv to create custom or append to existing file name.

• new global parameter

  • add --pass switch that will allow the Node Operator to enter the global p12 private key passphrase into the command line verses having it in clear text in the configuration file.

UPGRADE

sudo nodectl upgrade_nodectl

MANUAL INSTALLATION

x86

sudo wget https://github.com/StardustCollective/nodectl/releases/download/v2.7.1/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

arm64

sudo wget https://github.com/StardustCollective/nodectl/releases/v2.7.1/nodectl_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v