This repository is obsolute and replaced by new repository functionality. https://github.com/kokleong98/aura-m
This unofficial guide is based on my personal experience on aura staking and I am not associated with Aurora nor its associates. The provided contents comes with no warranty. You may freely use and modify the software according to your needs.
Aura staking setup
- SSH to your node and run following script section to install aurad and dependencies.
curl -O https://raw.githubusercontent.com/kokleong98/aura-setup/master/aura-deploy.sh
chmod +x aura-deploy.sh
sudo ./aura-deploy.sh
- Login with the new user account you have setup on step 1.
- Run following to configure your staking.
aura config
- Fill in your cold wallet address and sign it with ether wallet.
Install aura as systemd service auto run aura at system reboot. This have depedency on nvm. The service include following functionality.
- Monitoring staking offline and auto restart aura.
- Auto aura start on system reboot and aura.service failures.
- Email notification when staking offline (disabled by default, need configuration on aura-start.sh).
- Aurad block sync wait at aura.service start-up.
- Auto restart aurad container when stuck during Aurad block sync stage.
- Aurad software update email notification.
- Support "aura.conf" configuration file.
- Support attach mode if aura services are started.
- **Keep overall monitor service CPU consumption max range (4% - 6%) (Trying to uphold this.)
- **Staking online statistics logging (In development)
Make sure you have finished sync with the network before starting aura.service else it will restart aura because staking is offline.
- SSH to your node and run following script section to install aurad service and key in username setup during aura-setup. *You may be prompt for sudo password.
curl -O https://raw.githubusercontent.com/kokleong98/aura-setup/master/aura-service-install.sh
chmod +x aura-service-install.sh
sudo ./aura-service-install.sh
You shall see 2 service shell script files (aura-start.sh, aura-stop.sh) created and 1 systemd aura service file (aura.service) created.
- Upon finish aurad sync. Running following command to start your aura monitoring service.
sudo systemctl start aura.service
- Prepare mail server TLS settings before starting step 2. I will recommend to create new mail account.
- Mail server name. (eg. smtp.gmail.com)
- Mail server port. (eg. 587)
- Mail account. (eg. [email protected])
- Mail account password.
If you are using gmail account please make sure security setting "Allow less secure app: ON". Login to gmail acccount and visit following link to check your gmail account setting: https://myaccount.google.com/lesssecureapps
- SSH to your node and run following script section to configure email.
curl -O https://raw.githubusercontent.com/kokleong98/aura-setup/master/configure_mail.sh
chmod +x configure_mail.sh
sudo ./configure_mail.sh
#check interval minutes
interval=1
#staking offline count before restart aurad
off_restart=3
#staking offline cooling period after restart aurad
off_cool=10
#send mail on staking offline option (1=Enabled, 0=Default,Disabled)
sendmail=0
#send mail on staking offline mail options
mail_subject="Your mail subject."
mail_message="Your mail messsage."
mail_to="[email protected]"
#aurad update notification option (1=Enabled, 0=Default,Disabled)
update_notify=0
#external ethereum node option (1=Enabled, 0=Default,Disabled)
rpc_option=0
rpc_url=""
- SSH to your node and run following script section to install aurad service and key in username setup during aura-setup.
curl -O https://raw.githubusercontent.com/kokleong98/aura-setup/master/aura-service-install.sh
chmod +x aura-service-install.sh
sudo ./aura-service-install.sh
- You may further edit aura-start.sh to support email notification. You MUST setup mail relay server using the following guide to make mail notification work else keep setting as sendmail=0. https://www.linode.com/docs/email/postfix/configure-postfix-to-send-mail-using-gmail-and-google-apps-on-debian-or-ubuntu/
sendmail=1
mail_to="[email protected]"
mail_message="custom email content"
mail_subject="custom email subject"
- Upon finish aurad sync and adjusting your aura-start.sh script. Running following command to start your aura monitoring service.
sudo systemctl start aura.service
Aura droplet migration
- Setup the new droplet as per aura staking setup above and without signing new node with ether wallet.
- Stop source droplet aura services.
aura stop
- SSH to source droplet and copy ".aurad" directory recursively to new droplet using scp command. Replace with your droplet account name and droplet public ip address.
scp -r ~/.aurad/ <myusername>@<hostip>:~
- SSH to your node and run following script section to create cron.bash and mon_actions.sh file on account home directory.
curl -O https://raw.githubusercontent.com/kokleong98/aura-setup/master/aura.bash
curl -O https://raw.githubusercontent.com/kokleong98/aura-setup/master/mon_actions.sh
chmod +x aura.bash mon_actions.sh
- Setup a recurring cron job to check log status every 5-10 minutes.
- Add the following line to your first line of the "crontab -e" command.
SHELL=/home/<myusername>/aura.bash
- Add the line below to run on every 5 minutes. Replace with your droplet account name.
*/5 * * * * /home/<myusername>/mon_actions.sh
- Complete setup on "aura cron staking offline monitoring setup" above.
- Setup mail relay server using the guide. https://www.linode.com/docs/email/postfix/configure-postfix-to-send-mail-using-gmail-and-google-apps-on-debian-or-ubuntu/
- Edit following internal parameters in "mon_actions.sh" file.
sendmail=1
mail_to="[email protected]"
mail_message="custom email content"
mail_subject="custom email subject"
- Setup the new droplet as per aura staking setup above and without signing new node with ether wallet.
- SSH to source droplet and copy ".aurad/ipc" directory recursively to new droplet using scp command. Replace with your droplet account name and droplet public ip address.
scp -r ~/.aurad/ipc/settings.json <myusername>@<hostip>:~/.aurad/ipc/