Updated Witness Hotbox Install Directions

2 years ago

updated-install-howto.png

After walking through the steps with some people looking to use tho Witness Hotbox I saw a need to update and make the install instructions more clear. This project is still a work in progress and will be improved to increase simplicity as we progress as a network and community.

If you have any questions or things are unclear please message me on Discord. You can find be me in the smoke.io Discord group as "J. R. Swab".

Please use these install instructions as of October 15th, 2018. If the docker is newer than 1.0.0 please head over to my profile to find the most up to date installation walk-through.

Hotbox Version 1.0.0

Scroll down to see the steps on setting up a new witness.

Moving an existing witness to the Hotbox:

  1. Disable your witness
    a. update_witness "username" "url" "SMK1111111111111111111111111111111114T1Anm" {} true
    b. Replace username and url with your information.
    c. Copy and paste the command into the CLI_Wallet.
    d. Wait for it to broadcast. You will see some yellow words scroll by and then a group of grayish-white text.
  2. Use the official instructions to install Docker for ubuntu
  3. Close your wallet with ctrl+d if open.
  4. Shut down smoked with ctrl+c.
  5. Make a copy of your smoke directory:
    a. cp -r ~/smoke ~/smokebackup
  6. Pull the Hotbox Git repository:
    a. cd - this is to move into your home directory
    b. git clone https://gitlab.com/jrswab/hotbox
  7. Copy your smoke directory into hotbox:
    a. cp -r ~/smoke/* ~/hotbox/smoke
  8. docker pull jrswab/hotbox:1.0.0
  9. ./runDocker.sh && ./enterHotbox.sh
    a. To specify ports just add them directly after runDocker.sh eg. ./runDocker.sh 20001 28090
    b. If no ports are specified the script will expose port 2001 to 20001 and port 8090 to 28090.
    c. If you have a firewall make sure to open the ports used.
  10. cd smoke
  11. ./smoked
  12. ctrl+b c to make a new Tmux window.
  13. cd smoke
  14. ./run_wallet.sh
  15. Unlock the wallet with your secret passphrase.
  16. Re-enable your witness.

To get back to the smoked screen to see the blocks fall into place type ctrl+b 0.

To detach from the Docker:

  1. ctrl+b c to enter a new tmux window. If you try to run the next command from inside the wallet or smokeD nothing will happen.
  2. ctrl+h to detach the docker to the background of your server.

To renter the detached Docker and see witness feed:

./enterhotbox (after typing this if looks like it hangs press enter and you will see the prompt.)

hackThePlanet.gif

Starting up a new witness:

For information on securing your server please read the official documentation for Smoke witnesses.

If at anytime while using this guide, these instructions are unclear or you get stuck please message me on Discord. You can find be me in the smoke.io Discord group as "J. R. Swab".

  1. Install Docker for Ubuntu
  2. Pull the Hotbox Git repository:
    a. git clone https://gitlab.com/jrswab/hotbox
  3. cd hotbox && docker pull jrswab/hotbox:1.0.0
  4. ./runDocker.sh && ./enterHotbox.sh
    a. To specify ports just add them directly after runDocker.sh eg. ./runDocker.sh 20001 28090
    b. If no ports are specified the script will expose port 2001 to 20001 and port 8090 to 28090.
  5. ./install.sh
  6. cd smoke
  7. ./run_wallet.sh
  8. set_password *PickPassphrase*
  9. import_key *Your Smoke Private Active Key*
  10. suggest_brain_key
    a. This will give you three keys. A private brain key (all words), a private WIF, and a Public WIF in that order from top to bottom.
    b. Save these in a safe place. If you can I recommend encrypting them.
  11. import_key *Private WIF*
    a. Use the private WIF from the suggested brain key command above.
  12. ctrl+b c to open a new Tmux window
  13. cd smoke/witness_node_data_dir/
  14. nano config.ini
    a. Vim is also included in the Docker if you prefer that editor.
  15. Find the line that says #witness =
    a. remove the # and add your Smoke username
    b. eg. witness = "jrswab"
    c. Quotes are required.
  16. Find the line that says #private-key =
    a. remove the # and add your private WIF we got from the wallet in step 10.
    b. eg. private-key = xxxxxxxxxxxxxxxx
    c. No quotes around the key.
  17. Save and exit the config
    a. In nano: ctrl + x then y to save the press enter to execute.
  18. cd ..
  19. ./smoked
  20. Now the witness is running. Wait until you see handled block ] Got 1 transactions on block showing on the screen. Once you see them you can now enable your witness.
  21. ctrl+b 0 to go back to the screen with your wallet.
  22. update_witness "username" "url" "Public Key" {} true
    b. Replace username and url with your information.
    c. The "Public Key" is the public key we got from the wallet in step 10.
    d. Copy and paste the command into the CLI_Wallet.
    e. Wait for it to broadcast. You will see some yellow words scroll by and then a group of grayish-white text.
  23. Now you can go back to the feed with ctrl+b 1 to see the blocks!

Congrats! You are a witness now!

To detach from the Docker:

In order to keep the witness running without being logged into the server use the following:

  1. ctrl+b c to enter a new tmux window. If you try to run the next command from inside the wallet or smokeD nothing will happen.
  2. ctrl+h to detach the docker to the background of your server.

To renter the detached Docker and see witness feed:

./enterhotbox (after typing this if looks like it hangs press enter and you will see the prompt.)


Hope this docker is helpful in making running a witness more predictable and reliable. If you have any ideas on how to make this better please let me know.


vote-jrswab-for-steem-Witnesses—Steemit.gif
Go to https://smoke.io/~witnesses and and find jrswab in the list.
Or simply type jrswab in the box at the bottom.



Get 4.2 Free Smoke Power On Sign Up To Start Your Journey On Smoke! The First Cannabis Community That Pays You To Post And Curate Content You Love..
Sort Order:  Trending

Am I dumb if I don't understand why I would want to dockerize smoked?
Edit: Oooooh, just read your profile and I see you type in Dvorak, me too buddy! Lol, people with their qwerty dependencies. I blame my schools for pushing qwerty.
Although I also consider it a partial security measure that most of the world doesn't type using my layout. Hypothetically even if they torture a password out of me they still might not be able to enter it if they're unsavvy.

·

why I would want to dockerize smoked?

Consistency. If it works on one persons machine it will work on all (linux) machines. Allows for us to have smoother updates to the witness and if an issue gets fixed everyone can be sure it will act the same on their server.

Plus, it just makes it a bit easy to get up and running since all the dependencies are installed in the Docker image already.

I see you type in Dvorak, me too buddy! Lol, people with their qwerty dependencies.

Just a bunch of RTI, carpel tunnel, inefficiency laden sheeple 😉

Although I also consider it a partial security measure that most of the world doesn't type using my layout. Hypothetically even if they torture a password out of me they still might not be able to enter it if they're unsavvy.

and by unsavvy you mean "un-woke" lol GET WOKE

He's hacking the gibson! haha, Brilliant stuff JR.

·

Hahaha, not the gibson!!!

Awesome. I remember when I first started a witness, it was these types of posts that helped me get one started.

Smoke On!

·

Keep learning mate!

Thanks you for the update. Im sure it will help the less techsavy. You also have my witness vote :)

·

Thanks for the vote! It means a lot to have such a supportive community. If you have any questions for me please fell free to ask.