SmartCash SmartNode Setup Guide v2.1 (MAC Version) Quick Setup


#1

SmartCash SmartNode Setup Guide v2.1 for Mac Users Quick Setup

Mac 10.13.2 (Local Wallet)
Ubuntu 16.04 LTS x64 (VPS smartnode)
Date 28/1/2018
By @controllinghand
Credit to @nflaw for maintaining the SmartNode site. Please visit this for updates and FAQs
http://smartnodes.cc/
Credit to @hannahlicious for her awesome video this new version was inspired by her video found here


Credit to @msg768 for his install smartnode script

Last but not least
Credit to my new friend @Zaphoid who can be found on discord https://discord.gg/BDUh8jr helping everyone through setting up SmartNodes and more

Donation to my Smartcash please: SebFkuHrqDnj3obXvMtfxtQKRgFeVpXF5x

Digital Ocean referral link https://m.do.co/c/4f0c81328877 Free money $10 credit

Introduction

Welcome to this step by step guide that will take you through the process of creating your own SmartCash SmartNode. This guide is aimed at the casual MAC user who has already installed the SmartCash Wallet, purchased SmartCash but has little or no experience of using Linux or VPS (virtual private servers).
This guide also includes the install smartnode bash scripts for quick install provided by @msg768.
As a recommendation, please read through each section first and try to understand what is going on before doing it. As soon as one section is complete, please move to the next one. Don’t miss any steps and please take your time.
This document is not an official document of the SmartCash team and has only been created by a hive member in the hope to assist others.
Creating a Virtual Private Server (VPS)
For a small monthly fee, you can run your own Virtual Private server to host a SmartNode without having to create one at home and having the extra headache of worrying about having your machine running 24/7 and managing static IP-addresses etc.
This guide has been created to give a step by step account using Digital Ocean. However, I would like to state that there is no recommended preference from the SmartCash team for picking a VPS service.
If you would like to see similar service offering please visit the OPTIONAL SECTION 3 for vultr.com in yoyomonkey’s Guide http://smartnodes.cc/files/SmartCash_SmartNode_Setup_Guide_v1.2.pdf Which is also Windows friendly.

Requirements
10,000 SmartCash for each SmartNode.
Computer for running a local wallet only to start nodes and hold funds. Mac is used in this guide, but other QT version wallets work.
VPS server for remote node running 24hrs/day which includes:

  •  1GB RAM (about half used for the OS and half for the daemon we install)
    
  •  20GB drive (less than 1GB used for wallet, some for OS, and some for future.
    
  •  1 Static IPV4 Address per node (IPV4 address that never changes) (No IPV6)
    

The remote node is actually the SmartNode, but for this guide we will call that remote node.

Section 0: Protect Yourself

  • Backup:
    • (!) IMPORTANT! First step you need to perform.
      How to backup and recover your SmartCash Wallet (Mac Version)
  • Protect Yourself:
  • Disclaimer:
    • The Author of this Guide is not responsible for, and expressly disclaims all liability for, damages of any kind arising out of use, reference to, or reliance on any information contained within document. While the information contained within the document is periodically updated, no guarantee is given that the information provided in this guide is correct, complete, and up-to-date.
      Although the guide may include links providing direct access to other Internet resources, including Web sites, The Authors are not responsible for the accuracy or content of information contained in these sites.

Section 1: Configure Mac SmartCash Wallet

  1. Install 1.1.0 SmartCash Wallet
    https://smartcash.cc/wallets/
  2. On your Mac machine start your SmartCash wallet
  3. As soon as the wallet starts up go to the Smartcash menu and select Quit Smartcash. We need to make a Config change before syncing the wallet to make it able to manage the SmartNodes
  4. To run a SmartNode we need to create a smartcash.conf file in the Smartcash folder (or the Data directory you selected when you installed the SmartCash Installer). Bring up your Finder and go to your Library Folder. If the Library Folder is missing go to Home folder and select View->Show View Options and check the Library box.

    Reveal the Library directory

  5. Navigate to the smartcash directory
  6. Now edit the smartcash.conf file
    You can use whatever editor your like. Or use the built in one that comes with Mac TextEdit. He is how you bring it up in case you don’t know. Highlight smartcash.conf and right click ->Open With -> Other then navigate to TextEdit.


  7. Input the following into the smartcash.conf file
    txindex=1
    And Save
    Note: some guides have you put in rpcuser? However, that opens up an unneeded security hole.
  8. Optional Step - Bootstrapping
    (!)Use at your own risk(!)
    Do NOT do this unless you have backed up your wallet
    (!)You can lose everything.(!)
    This will download the blockchain and overwrite two directories. You don’t have to do this step, but it can save you some time with syncing.
    Open up a terminal and navigate to the smartcash directory: If you don’t know how to do this skip this step.
    curl -L0 http://proteanx.com/txindexstrap.zip > txindexstrap.zip

    This will download the txindexstrap.zip file and you will see progress:

    Next we will unzip and overwrite the blocks and chainstate directories
    unzip txindexstrap.zip
    when prompted type A to overwrite all

    now for some clean up
    rm txindexstrap.zip
  9. Start the SmartCash wallet again
  10. Wait for the wallet to fully sync. This can take up to 8 hours depending on many factors including Network Traffic. Look for the tick in the Bottom Right Corner of the wallet to signify that the wallet has fully synced. If you did the optional step the bootstrap of the block-chain will save some time.
  11. Now open up the smartnode.conf file

    This is where you will copy and paste all the variables related to your smartnode

    Keep this open while your work through the rest of the steps
  12. On your Smartcash Wallet
    Go to File in the top menu bar and then select “Receiving addresses”.
  13. Important Keep this SmartNode Name Create a new address. Click New. Call it something identifiable i.e. “SmartNode01”. Click Ok.

    Input this into smartnode.conf file
    A second address should now appear in Receiving Addresses Window. Click the button “Copy”.
  14. This is your Receiving address that you will send your 10,000 coins to
    Close the Receiving addresses window and lets send 10,000 coins to that address
    Send exactly 10,000 in one transaction. You can send from within the same wallet if you wish. Sending from an exchange may require an email approval - accept that and wait for an hour or two. Once off an exchange, in network transfers are seconds.
    Paste the address into the PayTo Field: You will notice that the Label will automatically populate. Do NOT select subtract fee from amount and put in exactly 10,000 coins and hit Send

    Put in the Password you used to encrypt your wallet

    Select Yes to send
  15. While that’s working let’s fill out the rest of the smartnode.conf file
    In the SmartCash wallet select Help in the top menu bar.
    Click “Debug window”
  16. In the Debug window click the console tab.
  17. Let’s get the genkey.
    At the bottom of the window type into the input box.
    smartnode genkey
    This will generate a long string of text. Copy and paste this into the smartnode01-addr-genkey file as you will need it later
    Copy and paste this into the smartnode.conf file.


    At this point you have #1 nodename and #2 genkey in the smartnode.conf file
  18. VERY IMPORTANT
    (!) If you already backed up your wallet you can skip this step (!)
    We now have to encrypt the wallet with a secure password.
    Go to the main SmartCash window and go to “Settings” in the menu and select Encrypt Wallet
  19. (!) If you already backed up your wallet you can skip this step (!)
    First, create a complex password in a notepad file (Save it as “SmartWallet-Encrypt-Password.txt”) and keep this somewhere very safe. Copy and paste this password into the Encrypt wallet Window twice and select OK.
    If you lose this password you will lose your SmartCash and no one will be able to get it back. Keep this file really safe!

  20. (!) If you already backed up your wallet you can skip this step (!)
    Read and confirm that you understand the message that if you lose this password there is no way of getting your SmartCash back!
    If you agree click “Yes” to continue.
  21. (!) If you already backed up your wallet you can skip this step (!)
    Please read this window carefully and backup your password file.
    Once the “SmartWallet-Encrypt-Password.txt” file is backed up (printed it out on paper and I saved it on usb pendrive) remove this file from the machine itself.
    Select “OK” and the SmartCash Wallet will close.
  22. Start the Smartcash wallet again.
    Can’t hurt to backup again :-).
    Back up the wallet file by going to the File Menu and Backup Wallet.
    Save this file to two USB backups and label them. The filename defaults to name as wallet.dat. Do not use these USB drives for any other use as these store your SmartCash funds.
  23. Now let’s ket the transaction id and index id
    In the Mac Wallet Debug Console (Help in the Menu and Debug Console) type:
    smartnode outputs
    Copy and paste the key and index(0,1,2…) in the file in smartnode.conf file
  24. At this point you should have the following:
    SmartNode Name:
    SmartNode Genkey:
    SmartNode Transaction ID:
    SmartNode Index ID:
    At this point you can update your smartnode.conf will all the variable except your VSP IP which you will get in the next steps

    Please continue with Section 2

Section 2: Using the built-in SSH client in MAC OSX

Mac OS X includes a command-line SSH client as part of the operating system. To use it, go to Finder, and select Go-> Utilities from the top menu. Then look for Terminal. Terminal can be used to get a local terminal window, and also supports SSH connections to remote servers.
RUNNING SSH FROM THE TERMINAL COMMAND LINE
Once you have the terminal window open, you have two alternatives. The first approach is to type ssh hostname or ssh user@hostname into the terminal window. This is more familiar for Linux and Unix users who are used to using a command line.
RUNNING SSH WITH A GRAPHICAL USER INTERFACE
The second option is to select New Remote Connection… from the Shell menu of Terminal. This opens a graphical dialog asking for the host to connect to and the user name. This also allows saving connections. This is recommended for users who are not accustomed to using a command line.
We will show you examples how to use this in the next section.

Section 3: Digital Ocean sign up and Droplet Creation

Digital Ocean referral link https://m.do.co/c/4f0c81328877

If you click the referral you get a $10 credit

Next are the steps to create a Virtual Server on Digital Ocean. For a small amount each month you can have an Ubuntu machine running in the cloud 24 hours a day, 7 days a week to run your SmartCash SmartNode.

  1. Open Google Chrome and go to
    https://www.digitalocean.com/
  2. Click on the blue “Sign In” button in the top right
  3. Enter your email and create a password.
  4. Go to your email and check for a digital ocean email. Confirm the email.
  5. Enter in Payment Details so that you can create a Droplet (VPS)
  6. Once this is all done, log in again to Digital Ocean and go to “Create Droplet”
  7. Select an Ubuntu Distribution use Ubuntu Version 16.04 LTS. Select a monthly plan.
    Our suggestion is to setup with 1GB or more of RAM. Although, 512MB of RAM will work for a few days, it will often cause the wallet to lockup when it runs out of memory. As we add features, our wallets will use more resources too.
  8. You Don NOT need to Add block storage so leave this empty.
    Choose a Datacenter Region. If you have multiple nodes use different locations.
    DO NOT select additional options
    DO NOT add SSH keys
  9. Give your VPS a name and select create.
  10. Check your email account for an email from Digital Ocean which will contain the root password.
  11. Back on the Digital Ocean page in your Internet Browser.
    Once the machine is created you will be presented with this screen. Click on more link and select Access console.
  12. On the console screen enter the root credentials with the password from the email (step 10) to log in.
    Please note copy and paste may not work. So please type carefully.
  13. You will be asked to change your password so please follow the instructions and make note of your new password and keep it safe.

    Congratulations. You have successfully created and logged into the VPS in Digital Ocean

Section 4: Install your smartnode software on to your VSP server

  1. In the connection to the virtual machine let us get the latest updates, please type in
    apt-get update
    And hit enter.
  2. Now type
    apt-get upgrade
    And hit enter it will ask you if you want to upgrade just type yes.
  3. Restart the machine with
    reboot
    And log in again.
  4. While that is rebooting update your VSP-IP in your smartnode.conf
  5. Let’s open up a terminal session on your local Mac
  6. Now let’s log into our VSP with ssh as root
    ssh root@VSP-IP
  7. Now download the install script
    wget https://rawgit.com/smartcash/smartnode/master/install.sh
  8. Now install the smartnode software
    bash ./install.sh
    And input the GenKey (See Video for example)


  9. Wait a minute or two and ssh back into the VSP
    ssh root@VSP-IP
  10. Check the status of the smartnode
    Now that smartcashd is running please leave it to sync the complete blockchain this can take about an hour.
    smartcash-cli getinfo
    Type the above command every couple of minutes and check that the “block” field is increasing. When these numbers get within 1 block of the latest block explorer number you should then be fully synced.
    Go to your Chrome Browser and get the latest block number from
    https://explorer.smartcash.cc

  11. Once your VPS has completely synced run the command.
    smartcash-cli smartnode status
    This will return a smartnode status.
    “Smartnode is capable but not activated"
    or
    "Smartnode is not capable"
    That doesn’t matter, just continue to the next step
    Once you run the start command from your LOCAL wallet (Section 9) and wait a few minutes, it will say
    "Smartnode successfully started”.

Section 5: Start the SmartCash SmartNode

  1. Save your smartnode.conf file on your Mac

    Save the file.
    Note: for those doing more than one SmartNode
    You would follow the same steps up to this point but add a new row into this file
  2. Start the SmartCash wallet (If it is already started please close the application and restart the wallet so it can read the changes made).
    Wait for the wallet to fully sync: Indicated by the tick in the bottom right corner
  3. Click on the “SmartNodes” Tab.

    Wait a few minutes for the screen to load it sometimes takes a little bit
  4. Click on the “My SmartNodes” Tab.
  5. Not to finally start your SmartNode.
    Click on “Start MISSING” button. (Clicking on “Start all” will reset any other SmartNode already started and push their payment date back. Start MISSING only starts nodes that need to be started.)
    You will be asked to type in your passphrase.

  6. Your SmartNode will change from a “missing” status to a “pre-Enabled” to finally “Enabled” this takes about 10 minutes.

    Congratulations you are now running your first SmartCash Smartnode! The local Mac wallet does not need to be left on 24/7. The Mac wallet can be used to see the rewards and SmartNode uptime.
    Congratulations your SmartNode is now configured.

Section 6: Secure your Smartnode

This section will guide you through disabling ssh access for root and creating a smartadmin user that will have access via ssh with the keys controlled on your MAC.

Section 7: Monitoring your Smartnode going forward

This section will guide you through how to monitor your Smartnode and how to setup alerts when your Node becomes over burdened


Secure Your SmartCash SmartNode VPS on Ubuntu 16.04 with a Mac Wallet v1.0
Adding a 2nd+ SmartCash SmartNode Setup Guide v2.0 for Mac Users (Quick Setup Guide)
Bash checker v1.1 for smartnode on Ubuntu (If you already have a SmartNode Configured)
*OLD Version* SmartCash SmartNode Setup Guide v1.4 for Mac Users *Including smartnode checking and anti-ddos* & Optional Bootstrap
SmartCash SmartNode SetUp Guide
#2

Amazing work! Thanks


#3

Thanks :blush:
Long live the Hive


#4

Thank you, ControllingHand. I wouldn’t have been able to get my Node running without your thorough walk-thru guide.

I was wondering about maintenance of the Node. I have read that the debug.log file grows very fast, is this file local to my mac or is it stored on the VPS or on both. Any guidance on how to tackle this would be greatly appreciated.


#5

Hi,

I am having endless trouble with this. Firstly the DigitalOcean wouldn’t accept my login from my Mac, so I had to flip to a set up on a PC for DigitalOcean. That has worked but now I cannot get the Bitvise to accept my password. The differences between the Mac instructions and the PC instructions are also confusing me. I am halfway down step 4 at point 4 and nothing seems to be working.

I have been speaking to people on the Discord channel but it seems to have deteriorated into just a mess and the direct messages have gone unanswered for 2 days. Any assistance would be appreciated.


#6

Glad I could help. If you followed all my guides you should be good to go. The install script will also include managing the debug.log. It puts a cronjob in the crontab to clean up the debug file every “At every other day”
0 0 */2 * * ~/smartnode/clearlog.sh


#7

I followed the “SmartCash SmartNode Setup Guide v2.1 for Mac Users Quick Setup” to the letter, did this include managing the debug.log?


#8

Yes if you followed this guide it should have included the crontab for this. do at crontab -l to verify


#9

no crontab for smartadmin


#10

sorry please type
sudo -i crontab -l
It’s in root’s crontab
and being that you respond in kind you did follow all of the steps. I’m proud!
@controllinghand


#11

Received the following “no crontab for root”


#12

then maybe you didn’t follow my guide? the bash ./install.sh command is supposed to install the cronjobs. something went wrong.
can you come to discord to discuss?


find me on @controllinghand


#13

Sounds good. I will message you.


#14

Stuck here. Can anyone help?


#15

yes go to next step. or ping me on discord


#16

Yeah man, @controllinghand great job on those tutorials. SmartNode running nicely.


#17

Ok so I screwed up. I downloaded my smart wallet and let it sync with the blockchain. I deposited exactly 10,000 Smartcash into my wallet and went through the Smartnode set up guide for mac as detailed by the Youtube video. Unfortunately, everything was going well until I restarted my wallet and got an error message stating that I needed to “Please add txindex=1 to your configuration and start with -reindex”. Is there a way I can safely and easily do this now after funding and going through the process of setting up my node or do I have to send the Smartcash out of my wallet, delete the wallet from my applications folder, re-download the wallet and add the smartcach.conf file and begin again. Thanks for any info.


#18

no just update your smartcash.conf file with the txindex=1 and restart your wallet and wait for it to sync or you can bootstrap it. All of this is in my guide


#19

When I go through the steps, I do not have the smartcash.conf file. I downloaded a wallet on another mac (from the Smartcash website) and it also lacks the smartcash.conf file.


#20

Create one :slight_smile:

Just go into the texteditor and edit a file and put in it
txindex=1

Then save to the same directory you have on this screen as smartcash.conf