NXT for Linux Instructions (Ubuntu)

[barbarosinciler]

Here is the guide to install NXT client on linux 64-bit platform. I've chosen the ubuntu distro because it's the most common one. You can use this instructions on your linux vps as well. 32-bit instructions are similar, only you need to download and install the x32 version of java-jre.

1 - Setting up Java JRE

1.1 - First, we need the latest java jre in your system. To do that:
type the following command to a terminal to delete the existing java in your system:

Code: [Select]

sudo apt-get purge openjdk-\*
1.2 - then create a directory to hold jre files with this command:

Code: [Select]

sudo mkdir -p /usr/local/java
1.3 - then go to this folder, download the latest (1.7.0-45 for today) jre and extract the tarball:

Code: [Select]

cd /usr/local/java
sudo wget http://ghaffarian.net/downloads/Java/JRE/jre-7u45-linux-x64.tar.gz
sudo tar xvzf jre-7u45-linux-x64.tar.gz
1.4 - now you need to add the PATH variables to our system:
open a nano editor with this command:

Code: [Select]

sudo nano /etc/profileScroll down to the end of the file using your arrow keys and add the following lines (copy/paste) below to the end of your /etc/profile file:

Code: [Select]

JAVA_HOME=/usr/local/java/jre1.7.0_40
PATH=$PATH:$HOME/bin:$JAVA_HOME/bin
export JAVA_HOME
export PATHsave the file and exit with ctrl+x and yes

1.5 - now you need to inform your Ubuntu Linux system where your Java JRE is located, and make it default with these commands. execute each of them one by one:

Code: [Select]

sudo update-alternatives --install "/usr/bin/java" "java" "/usr/local/java/jre1.7.0_45/bin/java" 1
sudo update-alternatives --install "/usr/bin/javaws" "javaws" "/usr/local/java/jre1.7.0_45/bin/javaws" 1
sudo update-alternatives --set java /usr/local/java/jre1.7.0_45/bin/java
sudo update-alternatives --set javaws /usr/local/java/jre1.7.0_45/bin/javaws
now you should have succesfully installed the latest jre to your system.

2 - Installing and running NXT Client

2.1 - you should download the latest nxt client. you can check them from this post: https://nextcoin.org/index.php/topic,100.msg730.html#msg730
cd your home folder and download the latest client:

Code: [Select]

cd ~
wget https://dl.dropboxusercontent.com/u/67242472/nxt.zip
2.2 - then unzip it:

Code: [Select]

unzip nxt.zip
cd nxt
2.3 - now it's time to start the client. start it with following command:

Code: [Select]

java -jar start.jar
you can open http://localhost:7875 or http://localhost:7674 from a browser for GUI. If you've installed the client to a vps, you should change the "localhost" with your vps ip.

3 - (OPTIONAL) Setting up client to run when computer starts

3.1 - To automate the starting process of client, you need a startup script. to make it type the following commands to terminal:

Code: [Select]

cd ~
sudo nano ~/startup.shnow copy and paste the following lines to your script:

Code: [Select]

#!/bin/bash
cd ~/nxt/
java -jar start.jar
3.2 - you should add this script to your startup with crontabs. type

Code: [Select]

crontab -eand select nano as editor, add this line at the end of file:

Code: [Select]

@reboot ~/startup.sh
Donations: 17449290204457266561

[hob]

1.1 - First, we need the latest java jre in your system. To do that:
type the following command to a terminal to delete the existing java in your system:

Code: [Select]

sudo apt-get purge openjdk-\*

Not a good idea to purge all JREs, some packages or other software may have dependencies on it. You don't need to uninstall any JRE if done properly. Furthermore, if you already have Java 7 / OpenJDK 1.7 installed you don't need to change anything.

1.2 - then create a directory to hold jre files with this command:

Code: [Select]

sudo mkdir -p /usr/local/java

Unnecessary, there are openjdk-7-jre packages, see http://packages.ubuntu.com/search?keywords=openjdk-7-jre, there's also no need to edit environment variables if installed properly. Simply install it with

Code: [Select]

sudo apt-get install openjdk-7-jre

1.3 - then go to this folder, download the latest (1.7.0-45 for today) jre and extract the tarball:

Code: [Select]

cd /usr/local/java
sudo wget http://ghaffarian.net/downloads/Java/JRE/jre-7u45-linux-x64.tar.gz
sudo tar xvzf jre-7u45-linux-x64.tar.gz

Why trust some arbitrary stuff from some unknown location to be installed in the system?

1.5 - now you need to inform your Ubuntu Linux system where your Java JRE is located, and make it default with these commands. execute each of them one by one:

Code: [Select]

sudo update-alternatives --install "/usr/bin/java" "java" "/usr/local/java/jre1.7.0_45/bin/java" 1
sudo update-alternatives --install "/usr/bin/javaws" "javaws" "/usr/local/java/jre1.7.0_45/bin/javaws" 1
sudo update-alternatives --set java /usr/local/java/jre1.7.0_45/bin/java
sudo update-alternatives --set javaws /usr/local/java/jre1.7.0_45/bin/javaws

Code: [Select]

sudo update-alternatives --config javaand pick the one with java-7

[hob]

You can use this instructions on your linux vps as well.

If you've installed the client to a vps, you should change the "localhost" with your vps ip.

https://nextcoin.org/index.php/topic,4.0.html explicitly says
Do NOT run Nxt on a VPS.  Only run Nxt locally.  Even if you connect to your VPS securely via SSH, you are still not safe because all VPSs have backdoors.

[Jean-Luc]

If you use Ubuntu, the easiest way to install Oracle Java is to use the webupd8 repository:
http://www.webupd8.org/2012/01/install-oracle-java-jdk-7-in-ubuntu-via.html

Code: [Select]

sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java7-installer
sudo apt-get install oracle-java7-set-default
Then you will also get updates to it automatically, as with all other ubuntu packages.

It is ok to run Nxt on a VPS, as long as you never unlock your account there. But you can (and you should, if you are a large stakeholder) hallmark the node, so that it contributes to the stability of the network.
https://bitcointalk.org/index.php?topic=345619.msg3864274#msg3864274

Again, if you are using a VPS, you have a public IP. Do everyone a favor and announce that IP, by editing nxt/webapps/root/WEB-INF/web.xml and putting it there:

Code: [Select]

<init-param>
<param-name>myAddress</param-name>
<param-value>PUT.YOUR.IP.HERE</param-value>
</init-param>

Depending on how much memory the VPS has, add a -Xmx command line parameter to increase the memory available to java. Use about 75% of your total memory (unless you run other things on that server too). If you have 2GB ram, you can run:

Code: [Select]

nohup java -Xmx1536M -jar start.jar &
(I use nohup so that it continues running even after I logout from the VPS).

If you encounter performance problems, out of open files errors, see the discussion here for tcp parameters and open files limits to adjust:
https://bitcointalk.org/index.php?topic=345619.msg3875822#msg3875822

Finally, the original post apparently suggests running Nxt as root. This is never a good idea. Create a unix user nxt, and use this account for running Nxt (and nothing else).

[JohnyCrypt]

Depending on how much memory the VPS has, add a -Xmx command line parameter to increase the memory available to java. Use about 75% of your total memory (unless you run other things on that server too). If you have 2GB ram, you can run:

Code: [Select]

nohup java -Xmx1536M -jar start.jar &
(I use nohup so that it continues running even after I logout from the VPS).

Thanks for this part. I was wondering if allocating more memory was making any difference (running with -Xms1024m -Xmx2048m with 8GB).

[opticalc]

OP, thanks much for this guide.  Can you update it with the suggestions in the thread please?  We'd like to get it translated to the other language boards.  Let me know when you think its ready.

[JohnyCrypt]

Any spaces or syntax problems with the ip value? I've never seen that come up when I put my IP in. Are you putting in your public facing IP?

If you can post your web.xml myAddress section it would help.

[ferment]

Also for those that run into this error:

Code: [Select]

java.io.IOException: Too many open files

You can update your open file limits following this guide:
http://docs.basho.com/riak/latest/ops/tuning/open-files-limit/#Linux

This one was a pain to get right as most search results left on the change to sshd_config.

[crackerhead]

I am unable to install with these instructions, I2013-12-10 19:51:09.430:INFO:oejs.ServerConnector:main: Started  get to the last step, and when I try to run the java client, I get stuck here:
ServerConnector@62ad2701{SSL-http/1.1}{0.0.0.0:7875}

I try to run the GUI from my browser, but it doesn't connect to anything. I am not too worried about having access to my NXT right now, but I just want to make sure that my NXT will be in my wallet when I finally do get access to it.

Basically I have some NXT being transferred from DGEX, and I just want to make sure that I don't need to login to my NXT wallet in order for the transaction to go through, thanks for the help!

[JohnyCrypt]

I am unable to install with these instructions, I2013-12-10 19:51:09.430:INFO:oejs.ServerConnector:main: Started  get to the last step, and when I try to run the java client, I get stuck here:
ServerConnector@62ad2701{SSL-http/1.1}{0.0.0.0:7875}

That's my last notification at startup as well. Make sure you're going to https://localhost:7875 or if this machine is not local, go to https://<insertyouriphere>:7875

Don't forget it's https, not http for port 7875. Also check your firewall and make sure it's allowing outbound 7875 for web and 7874 for P2P communication.

[crackerhead]

Im getting closer, I was able to get to https://localhost:7875, but get these kind or errors at terminal:

   at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:607)
   at org.eclipse.jetty.util.thread.QueuedThreadPool$3.run(QueuedThreadPool.java:536)
   at java.lang.Thread.run(Thread.java:744)
2013-12-11 10:26:20.385:WARN:oejs.HttpChannel:qtp1332782448-36: Could not send response error 500: java.lang.IllegalStateException: s=DISPATCHED i=false a=null

And get this familiar javascript output, I have seen other people with this issue, I will look around the forums for some more help, THANKS!!

java.lang.NullPointerException

[crackerhead]

Im getting closer, I was able to get to https://localhost:7875, but get these kind or errors at terminal:

   at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:607)
   at org.eclipse.jetty.util.thread.QueuedThreadPool$3.run(QueuedThreadPool.java:536)
   at java.lang.Thread.run(Thread.java:744)
2013-12-11 10:26:20.385:WARN:oejs.HttpChannel:qtp1332782448-36: Could not send response error 500: java.lang.IllegalStateException: s=DISPATCHED i=false a=null

And get this familiar javascript output, I have seen other people with this issue, I will look around the forums for some more help, THANKS!!
java.lang.NullPointerException

I restarted computer and reinstalled nxt files, now it works, THANKS AGAIN!!!!

[JohnyCrypt]

Im getting closer, I was able to get to https://localhost:7875, but get these kind or errors at terminal:

   at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:607)
   at org.eclipse.jetty.util.thread.QueuedThreadPool$3.run(QueuedThreadPool.java:536)
   at java.lang.Thread.run(Thread.java:744)
2013-12-11 10:26:20.385:WARN:oejs.HttpChannel:qtp1332782448-36: Could not send response error 500: java.lang.IllegalStateException: s=DISPATCHED i=false a=null

And get this familiar javascript output, I have seen other people with this issue, I will look around the forums for some more help, THANKS!!
java.lang.NullPointerException

I restarted computer and reinstalled nxt files, now it works, THANKS AGAIN!!!!

Awesome, glad it worked!

[ben]

i have problems getting 0.3.18 working....

0.3.16 working fine in linux



0.3.18....after first start i try CTRL-C (but not working!!!)
On first CTRL-C it should write new blockchain.nrs format!
But i doesn't....

any help? i am back to 0.3.16 now!

[JohnyCrypt]

i have problems getting 0.3.18 working....

0.3.16 working fine in linux



0.3.18....after first start i try CTRL-C (but not working!!!)
On first CTRL-C it should write new blockchain.nrs format!
But i doesn't....

any help? i am back to 0.3.16 now!

I'm not having any issues with stopping the client. The ctrl-c works fine for me. The only thing I can think of is I put the full path to to my blockchain.nrs file (which isn't in the nxt directory). Not sure if that helps or not.