[XPM] Primecoin High Performance Linux Compilation Guide

Tested with the following Linux distributions:
 - Ubuntu 13.04
 - CentOS 6.4

Step 1. Installing the required dependencies

Using apt-get with latest Ubuntu 13.04:
Code:
sudo apt-get install -y build-essential m4 libssl-dev libdb++-dev libboost-all-dev libminiupnpc-dev

The 'sudo' command requires you to type the password for the current user. If you don't have sudo working, you need to manually switch to root with 'su' before running those commands.

Warning: If you have installed a specific version such as libdb5.3++-dev before, then don't install the meta-package libdb++-dev which may pull a different version.

Alternative for CentOS users:
Code:
su -c 'yum install gcc-c++ m4 openssl-devel db4-devel boost-devel'

Step 2. Compiling GMP

Latest version supports all the new CPUs.

Code:
cd
rm -rf gmp-5.1.2.tar.bz2 gmp-5.1.2
wget http://mirrors.kernel.org/gnu/gmp/gmp-5.1.2.tar.bz2
tar xjvf gmp-5.1.2.tar.bz2
cd gmp-5.1.2
./configure --enable-cxx
make
sudo make install

The configure script will attempt to automatically detect the host CPU and enable the best optimizations for it.

Step 2b. Compiling OpenSSL (for CentOS users)

This step is only required if you're using CentOS. Red Hat has removed support for elliptic curve cryptography from the OpenSSL it supplies.

Code:
cd
rm -rf openssl-1.0.1e.tar.gz openssl-1.0.1e
wget ftp://ftp.pca.dfn.de/pub/tools/net/openssl/source/openssl-1.0.1e.tar.gz
tar xzvf openssl-1.0.1e.tar.gz
cd openssl-1.0.1e
./config shared --prefix=/usr/local --libdir=lib
make
sudo make install

Step 2c. Compiling miniupnpc (for CentOS users)

Code:
cd
rm -rf miniupnpc-1.6.20120509.tar.gz
wget http://miniupnp.tuxfamily.org/files/download.php?file=miniupnpc-1.6.20120509.tar.gz
tar xzvf miniupnpc-1.6.20120509.tar.gz
cd miniupnpc-1.6.20120509
make
sudo INSTALLPREFIX=/usr/local make install

Step 3. Compiling primecoind

Code:
cd
rm -rf primecoin-0.1.1-hp5.tar.bz2 primecoin-0.1.1-hp5
wget http://sourceforge.net/projects/primecoin-hp/files/0.1.1-hp5/primecoin-0.1.1-hp5.tar.bz2/download -O primecoin-0.1.1-hp5.tar.bz2
tar xjvf primecoin-0.1.1-hp5.tar.bz2
cd primecoin-0.1.1-hp5/src
sed -i -e 's/$(OPENSSL_INCLUDE_PATH))/$(OPENSSL_INCLUDE_PATH) \/usr\/local\/include)/' makefile.unix
sed -i -e 's/$(OPENSSL_LIB_PATH))/$(OPENSSL_LIB_PATH) \/usr\/local\/lib)/' makefile.unix
sed -i -e 's/$(LDHARDENING) $(LDFLAGS)/$(LDHARDENING) -Wl,-rpath,\/usr\/local\/lib $(LDFLAGS)/' makefile.unix
make -f makefile.unix
strip primecoind
sudo cp -f primecoind /usr/local/bin/

The last line will install the primecoind binary to /usr/local/bin.

CentOS users: Use the following 'make' command instead:
Code:
make -f makefile.unix BOOST_LIB_SUFFIX=-mt

Step 4. Configuration

Create a configuration file:

Code:
cd
mkdir -p .primecoin
echo 'server=1
gen=1
rpcallowip=127.0.0.1
rpcuser=primecoinrpc
rpcpassword=SOME_SECURE_PASSWORD
sievesize=1000000' > .primecoin/primecoin.conf
sed -i -e "s/SOME_SECURE_PASSWORD/`< /dev/urandom tr -cd '[:alnum:]' | head -c32`/" .primecoin/primecoin.conf

You may optinally customize the configuration file. The last line puts a random password in the configuration file automatically, so you don't need to change anything if you're only sending RPC commands from localhost.

Type these commands to create an auto-restart script:

Code:
cd
echo '#!/bin/bash
killall --older-than 10s -q run-primecoind primecoind
function background_loop
        while :; do
                primecoind >/dev/null 2>&1
                sleep 1
        done
background_loop &' > run-primecoind
chmod +x run-primecoind

CentOS users may want to remove the 'killall' command from this script because the version that comes with CentOS does not support the --older-than option.

And for convenience, create a stopping script:

Code:
cd
echo '#!/bin/bash
killall -q run-primecoind
primecoind stop' > stop-primecoind
chmod +x stop-primecoind

Step 5. Starting mining

Simply type the following to start mining:
Code:
./run-primecoind

It will take a while for it to sync up with the network. The script will continue running in the background, automatically restarting primecoind if it crashes.

Step 6. Monitoring the progress

Checking that the primecoind process is runnning:
Code:
ps xuf |grep primecoind

RPC commands can be sent to the daemon like this:
Code:
primecoind getprimespersec
primecoind listtransactions
primecoind getinfo
primecoind getmininginfo
primecoind getdifficulty

Any combination of these can be used with the 'watch' command like this:
Code:
watch 'primecoind getinfo && primecoind listtransactions'

Press Ctrl + C to terminate the watch command.

You can also look at the output in debug.log:
Code:
grep primemeter ~/.primecoin/debug.log

If you want to see those in real-time, try this:
Code:
tail -f ~/.primecoin/debug.log |grep primemeter

Step 7. Stopping mining

Run the stop script:
Code:
./stop-primecoind


DONATE XPM:  AKNvVLAJYCAtk5WFbe8XBWxN7WrxYScZ9q