This section describes step-by-step instructions for installing NCache Java Client on UNIX.

 

Installation

 

In installation, you can make use of the .tar.gz file to install NCache Java Client on your UNIX machine. You can specify some customized parameters such as install directory, a user under which NCache Java Client service will run, network IP to be used by NCache Java Client etc. If you don’t customize any parameters, NCache Java Client is installed according to default values. It is installed in the /opt/ncache/ directory and NCache service runs under a default user called “NCache”.

 

In order to install NCache Java Client on your machine, you need to have “root” privileges.

 

In order to install NCache Java Client on you UNIX system, please follow these steps:

 

 

 

[root@servername]# cd [NCache_Java_Client_setup_path]

 

 

[root@servername]# tar –zxvf NCache.Java.Client.tar.gz

 

 

[root@servername]# tar –zxvf NCache.Java.Client.tar.gz

 

  The extracted files can be found in the directory named ncache-enterprise-4.4-sp1-javaclient.

 

 

[root@servername]# cd ncache-enterprise-4.4-sp1-javaclient

 

 

[root@servername]# ./install –f John –l Smith –e john@alachisoft.com -u Jenny –k EVAL-KEY –j JAVA_HOME_PATH –I 20.200.20.202

 

EVAL-KEY is emailed to you when you register at Alachisoft website. And, please specify JDK/JRE 1.6 or later.

 

NCache Java Client is now successfully installed on your UNIX machine!

 

After successful installation, you will get the following output message:

 

Starting NCache service

 

jvmargument: -Xmx816000m -Dcom.sun.management.jmxremote -Dcom.sun.management.jmx

 

remote.port=1501 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.man agement.jmxremote.ssl=false -Xdebug -Xrunjdwp:server=y,transport=dt_socket,address=4000, suspend=n -Djava.library.path=/opt/NCache/lib/resources/sigar/ -server

 

CacheServer.BindToClientServerIP =20.200.20.202

CacheServer.BindToClusterIP=20.200.20.202

CacheManagementServer.Port=8250

CacheServer.Port=9800

 

Checking service status ...

NCache service started.

 

 

Flag		Purpose
-f	--firstname	First name of the user to which NCache Java Client is licensed.
-l	--lastname	Last name of the user to which NCache Java Client is licensed.
-e	--email	Email address of the user  to which NCache Java Client is licensed.
-j	--javahome	It points to the directory where Java Runtime Environment (JRE) or Java Development Kit (JDK) is installed on your system. If no or invalid path is specified, it will search for the Java location itself. Recommended Java version is 1.6. It will first look for version 1.6; if it is not found, it will search for any greater version available.
-i	--ipaddress	IP address to be used by NCache Java Client, if no IP is specified it will use the first network interface card it finds.
-p	--installpath	Location  where NCache Java Client will be installed, by default it will be installed on current location.
-k	--evalkey	You receive this via email from Alachisoft when you downloaded NCache Java Client. If not, then visit Alachisoft Download Center to register and obtain one. It is mandatory for you to specify this.

 

Verify NCache Java Client Installation

 

After installation you can verify NCache Java Client installation by any of the following ways:

 

 

[root@servername]# chkconfig

 

This command lists system services. If the NCache Java Client service NCached is also listed as follows you can be sure that NCache Java Client has been successfully installed.

 

NCached        0:off   1:off   2:on    3:on    4:on    5:on    6:off

 

OR

 

Set  NCHOME to the location where you have installed NCache Java Client through the command:

 

[root@servername] export NCHOME=/opt/ncache

 

Then run the following commands:

 

[root@servername] cd /opt/ncache/bin

[root@servername] ./NCached status

 

If your installation was successful, you should be able to see the following output:

 

NCache Java Client Server Status: Running

CacheServer.BindToClientServerIP =20.200.20.202

CacheServer.BindToClusterIP=20.200.20.202

CacheManagementServer.Port=8250

CacheServer.Port=9800

 

 

[root@servername]# cd ~/NCache_install_dir/ncache/config

 

After locating the file server.properties, open it in editor. In case of successful installation, you should be able to see your system IP used by property values as follows:

 

CacheServer.BindToClusterIP=20.200.20.202

CacheServer.BindToClientServerIP=20.200.20.202

 

What has been Installed?

 

NCache Java Client is installed in the directory you mentioned at the time of installation. In custom .tar.gz installation, this directory will either be the default directory that is /opt/ncache/, or it will be the directory you mentioned at the time of installation using –p parameter.

After installation, you will find the following files in this directory:

 

 

 

 

 

addclientnode     addnode     addtestdata     clearcache     verifylicense     removecache

createcache     createclientcache     dumpcache     getcachecount     ncached     listcaches

removeclientnode     removenode     startcache     stopcache     stresstesttool     removeclientcache

 

 

 

 

 

 

See Also

What is NCache Java Client? | Getting Startedl | Post Installation License Management for UNIX | Post Installation Client/Server Configuration UNIX | Uninstall NCache Java Client from UNIX

---

Send comments on this topic.