Dd-13: V0.1.6 (06/22/16)

This development dispatch covers work completed since the Decred v0.1.5 release from June 7th, 2016. Since then, developers have merged 16 pull requests of code into 3 software repositories (for changes, see below). v0.1.6 includes a new tool, dcrinstall, to automate the install, upgrade, and setup process for the Decred software.

dcrinstall: https://github.com/decred/decred-release/releases/tag/v0.1.6
Binaries: https://github.com/decred/decred-binaries/releases/tag/v0.1.6

dcrd

• Fixed an issue with memory alignment on 32-bit architectures (269-2bbfd5f)
• Fixed an issue that interferes with the new dcrinstall package when checking if .dcrd exists (270-fa72e21)
• Added a simnet option to the config file (272-e6beeb6)
• Updated versioning (271-9279321)

Credits: @ay-p, @ceejep, @jcv, @jolan, @jrick, marcopeereboom, T909

dcrwallet

• Moved prompting of passphrases and seed to a prompt package so other tools can call the same prompts (268-b3bd20e)
• Modified the wallet package to import the database driver directly (269-f2a12cf)
• Added a non-internal prompt package (273-dfb6bcd)
• Fixed a build error for the test harness (274-697443a)
• Updated documentation (275-7bdd976) and versioning (271-1ca9472)

Credits: @ay-p, @ceejep, @jcv, @jolan, @jrick

dcrticketbuyer

• Updated the default directory to be OS-specific (10-4297aa0)
• Updated configuration (13-01a9cd6), documentation (14-e5d08c1, 15-7c3b826), and versioning (12-3505d11)

Credits: @ceejep, @chappjc, @jcv, @jolan, @raedah

Developer Notes
dcrinstall

dcrinstall is a tool to automate the install, upgrade, and setup process for the Decred software. In install mode dcrinstall downloads the latest released binaries of dcrd, dcrwallet, dcrctl, and dcrticketbuyer for your operating system and platform, installs them, sets up the config files, and creates a wallet for you. In upgrade mode, dcrinstall replaces your binaries with the latest copies but makes no changes to your configs.

Upgrading an existing installation

The following steps are required to upgrade a system with Decred that was not installed by dcrinstall. If you already have Decred installed you will need to follow these instructions the first time.

The dcrinstall tool expects the following directory layout. In order to upgrade you must copy your current configuration files into the correct location and ensure everything still works. You may also want to copy you executables to the directory dcrinstall expects as well.

If dcrinstall detects all configuration files it'll operate in upgrade mode. Upgrade mode only overwrites the binaries in %HOMEPATH%\decred (or ~/decred on a UNIX type OS).

The dcrinstall tool records all actions in %HOMEPATH%\decred\dcrinstall.log (or ~/decred/dcrinstall.log on a UNIX type OS).

Windows configuration files:

Code:

%LOCALAPPDATA%\Dcrctl\dcrctl.conf
%LOCALAPPDATA%\Dcrd\dcrd.conf
%LOCALAPPDATA%\Dcrticketbuyer\ticketbuyer.conf
%LOCALAPPDATA%\Dcrwallet\dcrwallet.conf

Binaries directory:

Code:

%HOMEPATH%\decred\

OSX configuration files:

Code:

~/Library/Application Support/Dcrctl/dcrctl.conf
~/Library/Application Support/Dcrd/dcrd.conf
~/Library/Application Support/Dcrticketbuyer/ticketbuyer.conf
~/Library/Application Support/Dcrwallet/dcrwallet.conf

Binaries directory:

Code:

~/decred

UNIX configuration files:

Code:

~/.dcrctl/dcrctl.conf
~/.dcrd/dcrd.conf
~/.dcrticketbuyer/ticketbuyer.conf
~/.dcrwallet/dcrwallet.conf

Binaries directory:

Code:

~/decred

Run the software

Now that you have the files where dcrinstall can find them you can download and run dcrinstall. For Windows open a cmd.exe window then:

Code:

cd %HOMEPATH%\Download
dcrinstall.exe

For OSX and UNIX you will also need to make the file executable before runnning it:

Code:

cd Downloads/
chmod u+x dcrinstall
./dcrinstall

and your installation will be upgraded to the latest released version.

Clean install

If you are doing a clean install (no existing Decred configuration files) you can just run dcrinstall and it will setup and configure all the binaries. For Windows open a cmd.exe window and:

Code:

cd %HOMEPATH%\Download
dcrinstall.exe

For OSX and UNIX:

Code:

cd Downloads/
./dcrinstall

You will be asked to provide a passphrase for you wallet and given the opportunity to use and existing wallet seed if you have one.

Log file

dcrinstall saves a log file with information on everything it did which you may examine if you need more information. On Windows the file is located at:

Code:

%HOMEPATH%\decred\dcrinstaller.log

On OSX and UNIX the file is located at:

Code:

~/decred/dcrinstaller.log

Running Decred programs

On Windows open cmd.exe

Code:

%HOMEPATH%\decred\dcrd.exe

One OSX and UNIX like systems:

Code:

cd decred/
./dcrd

Alternatively you can add the directory to your path. For Windows see http://www.computerhope.com/issues/ch000549.htm For OSX and UNIX refer to the documentation for your shell.

Public keys

The file cmd/dcrinstall/pubkey.go contains the decred public key which is used to check the signed manifest in the release. You can compare the contents of this file to what you get from a keyserver to confirm that dcrinstaller is using the proper key.

Important

dcrinstall can only install Decred releases v0.1.6 or later (although as described above it can be used to upgrade from an older version). dcrinstall has been tested on Windows 10, Windows 7, OSX 10.11, Bitrig current, OpenBSD, Fedora, Ubuntu, and Raspbian. Due to an issue with the go cross-compiler, binaries are not available for linux-arm64. Users running Linux on arm64 should either build from source or contact the Decred developers for a binary for that platform.