Warning: Read this carefully before you start
Please read the following information carefully and ask any questions your might have before executing graceful exit. Once graceful exit is started there is currently no way to stop or cancel it. Think about the consequences twice before you call it.
Requirements:
- Storage node has joined the network more than 15 months ago (requirement temporarily reduced to 6 months).
- Storage node is healthy and hasn’t lost any significant amount of data. Disqualification during graceful exit is possible.
- Storage node will have no huge downtime during the graceful exit period (30 days). The uptime score requirement is higher during graceful exit (0.8) than it is normally (0.6). If your node has too much downtime during the graceful exit period, the graceful exit will fail and you will not get back your held amount.
Start Graceful Exit
Are you sure you want to start graceful exit? Did you read the information above? Do you understand that graceful exit can’t be canceled?
Here is how you initiate it:
root@kali:~# storagenode exit-satellite
By starting a graceful exit from a satellite, you will no longer receive new uploads from that satellite.
This action can not be undone.
Are you sure you want to continue? [y/n]
:y
Domain Name Node ID Space Used
us2.storj.io:7777 12tRQrMTWUWwzwGh18i7Fqs67kmdhH9t6aToeiwbo5mfS2rUmo 534.38 MB
saltlake.tardigrade.io:7777 1wFTAgs9DP5RSnCqKV1eLf6N9wtk4EAtmN5DpSxcs8EjT69tGE 629.72 GB
ap1.storj.io:7777 121RTSDpyNZVcEU84Ticf2L1ntiuUimbWgfATz21tuvgk3vzoA6 68.04 GB
us1.storj.io:7777 12EayRS2V1kEsWESU9QMRseFhdxYxKicsiFmxrsLZHeLUtdps3S 153.83 GB
eu1.storj.io:7777 12L9ZFwhzVpuEKMUNUqkaTLGzwY9G24tbiigLiXpmZWKwmcNDDs 131.80 GB
europe-north-1.tardigrade.io:7777 12rfG3sh9NCWiX3ivPjq2HtdLmbqCrvHVEzJubnzFzosMuawymB 13.79 GB
Please enter a space delimited list of satellite domain names you would like to gracefully exit. Press enter to continue:
us2.storj.io:7777 saltlake.tardigrade.io:7777 ap1.storj.io:7777 us1.storj.io:7777 eu1.storj.io:7777 europe-north-1.tardigrade.io:7777
You can exit the satellites one by one or all at the same time. The affected satellites will repair data off of your node as they determine appropriate.
During Graceful Exit
You can watch the status of graceful exit like this: (example output from a test satellite)
root@kali:~# storagenode exit-status
Domain Name Node ID Percent Complete Successful Completion Receipt
127.0.0.1:10000 12fbck97kqEGbWPu673CpeyrXavtqgVriyv9pCfL3mpw3yz2zN9 0.00% N N/A
The “Percent Complete” field is a relic of the old graceful exit and is no longer meaningful. It will likely be removed at some point.
If you get the output No graceful exit in progress, that means graceful exit didn’t start because of the node age requirement. In the storage node logs you will find additional information such as: node is not yet eligible for graceful exit: will be eligible after 2020-04-02 01:18:23.910919 +0000 UTC.
In case of a crash, power failure, or other outage, please get your storage node back online. Graceful exit will continue.
Finish Graceful Exit
After the graceful exit period (currently 30 days) is complete, your node will no longer be in a graceful exit. Either it will succeed (if your uptime has been high enough) or it will fail.
At the end you will get output like this:
root@kali:~# storagenode exit-status
Domain Name Node ID Percent Complete Successful Completion Receipt
127.0.0.1:10000 12fbck97kqEGbWPu673CpeyrXavtqgVriyv9pCfL3mpw3yz2zN9 0.00% Y 0a473045022100da86329cfb4f5bb16f0702c1d073c3a8b54787311b54855bcf01a8e245250040022003ef911b3b2b2bea86ba34cd4927223f2718cd35c3b7de7cc030cd3a8ce4959a1220db55bd9fa76e8938be5a7a25c970d48bde19936e269dcf69a3ab9fa41b5486001a207508f9a6138cdc4089ea075f1553736d472cb1d3afa4397496a8eb948d121200220c08abe5dcf0051086e6fefe01
Your node should automatically delete any remaining data for the satellite(s) it exited from when graceful exit is complete.
As long as graceful exit was successful you will get back your held amount with the next regular payout. “Completion Receipt” contains a signature from the satellite and is your ticket to get the payback. Please keep your storagenodeID, each satelliteID and each completion receipt. With this information you can open a support ticket if needed.
If Graceful Exit was initiated under the old system
If your node was already undergoing a graceful exit when we deploy this new procedure, it will continue with its graceful exit. If the 30-day period has already elapsed since you started graceful exit, your node’s graceful exit will automatically and immediately end, and you will pass or fail graceful exit based on your node’s uptime score. If the 30 day period has not yet elapsed, you only need to wait until it does elapse.
In short, your time spent gracefully exiting under the old system will still count toward your graceful exit period under the new system.
