Getting Started From a Downloaded Zip File¶
- Download the latest release of H2O as a .zip file from the H2O downloads page.
- From your terminal change your working directory to the same directory where your .zip file is saved.
- From your terminal, unzip the .zip file. For example:
- At the prompt enter the following commands.
cd h2o-188.8.131.520 #change working directory to the downloaded file java -Xmx1g -jar h2o.jar #run the basic java command to start h2o
- Wait a few moments and output similar to the following will appear in your terminal window:
Irenes-MacBook-Pro:target Irene$ java -Xmx3g -jar h2o.jar 09:54:05.400 main INFO WATER: ----- H2O started ----- 09:54:05.402 main INFO WATER: Build git branch: master 09:54:05.402 main INFO WATER: Build git hash: e44ee2cec508140fc6312e3d6874df8069eac669 09:54:05.402 main INFO WATER: Build git describe: nn-2-3032-ge44ee2c-dirty 09:54:05.402 main INFO WATER: Build project version: 184.108.40.206999 09:54:05.402 main INFO WATER: Built by: 'Irene' 09:54:05.402 main INFO WATER: Built on: 'Tue Feb 4 09:45:26 PST 2014' 09:54:05.402 main INFO WATER: Java availableProcessors: 8 09:54:05.403 main INFO WATER: Java heap totalMemory: 0.24 gb 09:54:05.403 main INFO WATER: Java heap maxMemory: 2.67 gb 09:54:05.404 main INFO WATER: Java version: Java 1.7.0_51 (from Oracle Corporation) 09:54:05.404 main INFO WATER: OS version: Mac OS X 10.9.1 (x86_64) 09:54:05.404 main INFO WATER: ICE root: '/tmp/h2o-Irene' 09:54:05.407 main INFO WATER: Possible IP Address: en0 (en0), fe80:0:0:0:6203:8ff:fe91:950a%4 09:54:05.407 main INFO WATER: Possible IP Address: en0 (en0), 192.168.0.4 09:54:05.408 main INFO WATER: Possible IP Address: lo0 (lo0), fe80:0:0:0:0:0:0:1%1 09:54:05.408 main INFO WATER: Possible IP Address: lo0 (lo0), 0:0:0:0:0:0:0:1 09:54:05.408 main INFO WATER: Possible IP Address: lo0 (lo0), 127.0.0.1 09:54:05.431 main INFO WATER: Internal communication uses port: 54322 Listening for HTTP and REST traffic on http: //192.168.0.4:54321/ 09:54:05.471 main INFO WATER: H2O cloud name: 'Irene' 09:54:05.472 main INFO WATER: (v220.127.116.11999) 'Irene' on /192.168.0.4:54321, discovery address /18.104.22.168:58682 09:54:05.472 main INFO WATER: If you have trouble connecting, try SSH tunneling from your local machine (e.g., via port 55555): 1. Open a terminal and run 'ssh -L 55555:localhost:54321 Irene@192.168.0.4' 2. Point your browser to http://localhost:55555 09:54:05.475 main INFO WATER: Cloud of size 1 formed [/192.168.0.4:54321] 09:54:05.475 main INFO WATER: Log dir: '/tmp/h2o-Irene/h2ologs'
- Point your web-browser to:
The user interface will appear in your browser, and now H2O is ready to go.
On Windows systems, Internet Explorer is frequently blocked due to security settings. If you cannot reach http://localhost:54321 try a different web browser such as Firefox or Chrome.
First time users may need to download and install Java in order to run H2O. The program is available free on the web, and can be quickly installed. Even though you will use Java to run H2O, no programming is necessary.
In the Java command entered the term -Xmx1g was used. Xmx is the amount of memory given to H2O. If your data set is large, give H2O more memory (for example, -Xmx4g gives H2O four gigabytes of memory). For best performance, Xmx should be 4x the size of your data, but never more than the total amount of memory on your computer.
Java 1.8 for developers is not supported at this time. Users running H2O, but not modifying and supplementing code, or recompiling the existing code can use Java 1.8