v2.8.0

Please use the official Constellation Network repository. This repository is no longer supported.

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 official release. v2.0.0 through v2.7.0 were in beta on TestNet.

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

v1.12.0

MAINNET 2.0 ONLY !!!

This is not compatible with Testnet

https://github.com/netmet1/constellation_testnet_nodectl/

Release Notes

• upgrade nodeid layer0 link bug
  • upgrade ser-346 tolerance feature add
    • added nodeid derivation verfication to attempt to avoid this error
    • ser-346 is triggered when the Node is unable to join due 'an error' [most likely] a configuration error
• clear_logs deprecated
  • replaced with clear_files
  • upgrader clear files bug fixed
• nodeid refactor
  • added -t [target] flag to allow nodeid retrieval of any
    Node on the cluster based on IP address
  • eg) sudo nodectl nodeid -t <ip_address>
• whoami refactor
  • added -t [target] flag to allow nodeid retrieval of any
    Node on the cluster based on IP address
  • eg) sudo nodectl whoami -t <ip_address>
• auto_restart bug fix

INSTALL INSTRUCTIONS

UPGRADES

---

important: this is an upgrade path not for new installations
no need to use the upgrade path to v0.14.1 if your version is already above v0.14.0
no need to use the upgrade path if your version is already above v1.8.0
any version --> v0.14.1 ---> v1.8.1 ---> v1.12.0

v1.7.0 and above

sudo nodectl upgrade-nodectl

versions below v1.7.0

It is important that you upgrade to the latest version to remove any unknown bugs. Please use the wget commands from the installation below to upgrade your Node to the latest nodectl.

NEW INSTALLATIONS

---

New installs can start at current latest release

X86

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.12.0/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

ARM

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.12.0/nodectl_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

v1.11.7

MAINNET 2.0 ONLY !!!

This is not compatible with Testnet

https://github.com/netmet1/constellation_testnet_nodectl/

Release Notes

• auto_restart feature added
  • sudo nodectl auto_restart help
    • will show an explanation of this feature via the extended help.
• bug fix
  • Debian10 installation issue with invalid imports
  • join bug fixed
  • version check bug fixed
• separate logs between layer0 and layer1
  • modified archiving
  • modified show logs
  • modified send logs
• update archiving to avoid double execution on restart
• updated leave on upgrade process
• refactored
  • show status to remove sticky status elements
  • check_connections method
  • status feature refactor
  • on-network bug fixed
  • find feature refactored
  • added -t target and -s source flags, updated help file
  • see sudo nodectl find help for extended help and examples.
• deprecated count command (replaced with find)
• new feature
  • uploads
  • the send log feature will save the files to the "uploads" directory
  • sudo nodectl clear_uploads or sudo nodectl -cul
    • offer ability to clear the uploads directory if too large
    • clear uploads added to upgrader
  • show markets command
    • sudo nodectl markets
      • display top 10 Crypto markets adding in Constellation Network's ranking.

INSTALL INSTRUCTIONS

UPGRADES

---

important: this is an upgrade path not for new installations
no need to use the upgrade path to v0.14.1 if your version is already above v0.14.0
no need to use the upgrade path if your version is already above v1.8.0
any version --> v0.14.1 ---> v1.8.1 ---> v1.11.7

v1.7.0 and above

sudo nodectl upgrade-nodectl

versions below v1.7.0

It is important that you upgrade to the latest version to remove any unknown bugs. Please use the wget commands from the installation below to upgrade your Node to the latest nodectl.

NEW INSTALLATIONS

---

New installs can start at current latest release

X86

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.11.7/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

ARM

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.11.7/nodectl_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

v1.8.1

MAINNET 2.0 ONLY !!!

This is not compatible with Testnet

https://github.com/netmet1/constellation_testnet_nodectl/

Release Notes

• default version bug fix
  • if user chooses the default version it was not being accepted
• service stop bug fix
  • previously if the service was already in ApiNotReady or Offline nodeclt would skip the command, this caused the service to say up and in ApiNotReady but still running.

INSTALL INSTRUCTIONS

UPGRADES

important: this is an upgrade path not for new installations
no need to use the upgrade path if your version is already above v0.14.0
any version --> v0.14.1 ---> v1.8.1

v.1.7.0 and above

sudo nodectl upgrade-nodectl

versions below v1.7.0

It is important that you upgrade to the latest version to remove any unknown bugs. Please use the wget commands from the installation below to upgrade your Node to the latest nodectl.

NEW INSTALLATIONS

New installs can start at current latest release

X86

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.8.1/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

ARM

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.8.1/nodectl_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

v1.8.0

MAINNET 2.0 ONLY !!!

This is not compatible with Testnet

https://github.com/netmet1/constellation_testnet_nodectl/

Release Notes

• version verification added during upgrades
  • users were entering in y or yes instead of a valid version identification
• adds upgrade wait time tolerance
  • previously if a Node was joining Layer0 it would timeout if it did not move from Observing to Ready state in around 1.5 minutes. The Node will now ask you if you want to continue waiting after the timeout is reached. If you choose not to wait you can cancel and return to join Layer1 later.
• adds $DAG balances to the sudo nodectl dag feature
• adds ability to upload archive log directories for developer review
• adds session testing to sudo nodectl status command
  • previously if you disconnected from the cluster; however, your node was still on-line and in Ready state, you would get a false positive that we were connected properly.
• fixes installation bug for older Nodes from TestNet

INSTALL INSTRUCTIONS

UPGRADES

important: this is an upgrade path not for new installations
no need to use the upgrade path if your version is already above v0.14.0
any version --> v0.14.1 ---> v1.8.0

v.1.7.0 and above

sudo nodectl upgrade-nodectl

versions below v1.7.0

It is important that you upgrade to the latest version to remove any unknown bugs. Please use the wget commands from the installation below to upgrade your Node to the latest nodectl.

NEW INSTALLATIONS

New installs can start at current latest release

X86

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.8.0/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

ARM

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.8.0/nodectl_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

v1.7.3

MAINNET 2.0 ONLY !!!

This is not compatible with Testnet

https://github.com/netmet1/constellation_testnet_nodectl/

Release Notes

• final preparation for Batch 2 on-boarding

INSTALL INSTRUCTIONS

NEW INSTALLS
New installs can start at current latest release

X86

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.7.3/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

ARM

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.7.3/nodectl_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

UPGRADES

important: this is an upgrade path not for new installations
no need to use the upgrade path if your version is already above v0.14.0
any version --> v0.14.1 ---> v1.7.3

v.0.14.1 and above

sudo nodectl upgrade-nodectl

v1.7.1

MAINNET 2.0 ONLY !!!

This is not compatible with Testnet

https://github.com/netmet1/constellation_testnet_nodectl/

Release Notes

• bug fix - nodectl update-seedlist
  • manual seed list was not pulling the version properly

INSTALL INSTRUCTIONS

NEW INSTALLS
New installs can start at current latest release

X86

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.7.1/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

ARM

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.7.1/nodectl_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

UPGRADES

important: this is an upgrade path not for new installations
no need to use the upgrade path if your version is already above v0.14.0
any version --> v0.14.1 ---> v1.7.1

v.0.14.1 and above

sudo nodectl upgrade-nodectl

v1.7.0

MAINNET 2.0 ONLY !!!

This is not compatible with Testnet

https://github.com/netmet1/constellation_testnet_nodectl/

Release Notes

• updates L1 -> L0 link
• minor bug fixes
  • some debugging turned off

INSTALL INSTRUCTIONS

NEW INSTALLS
New installs can start at current latest release

X86

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.7.0/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

ARM

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.7.0/nodectl_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

UPGRADES

important: this is an upgrade path not for new installations
no need to use the upgrade path if your version is already above v0.14.0
any version --> v0.14.1 ---> v1.7.0

v.0.14.1 and above

sudo nodectl upgrade-nodectl

v1.6.0

MAINNET 2.0 ONLY !!!

This is not compatible with Testnet

https://github.com/netmet1/constellation_testnet_nodectl/

Release Notes

• migrate HyperGraph endpoint LBs
• updates seed-list location
• disable auto_restart temporality
  • this feature is still under development

INSTALL INSTRUCTIONS

NEW INSTALLS
New installs can start at current latest release

X86

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.6.0/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

ARM

sudo wget https://github.com/netmet1/constellation_nodectl/releases/download/v1.6.0/nodectl_arm64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl

UPGRADES

important: this is an upgrade path not for new installations
any version --> v0.14.1 ---> v1.6.0

v.0.14.1 and above

sudo nodectl upgrade-nodectl