NCache 4.6 - Online Documentation

Java Client Installation: Getting Started

This section provides you information about installing NCache Java Client in UNIX environment. It provides the system and software requirements, along with information about the administrative privileges you need in order to install NCache Java Client.
On the UNIX platform you can install NCache Java Client only in Command Line Mode through Custom Installation (.tar.gz) installation mode. In custom installation, you can specify customized parameters for installing NCache Java Client. Without customization, NCache Java Client is installed according to default values and in the /opt/ncache/ directory. To view the complete installation steps, please see Installation Steps for UNIX.
Installation Types
When you install NCache Java Client Enterprise, you are only given the remote client installation option. This option installs the remote client libraries and client cache on all your web/app servers so you can access the cache across the network. Please note that you need remote client libraries to access the cache across the network.
Installer Account Privileges
Installing NCache Java Client on your system requires special user privileges.
  • In order to install NCache Java Client on your machine, you need to have “root” privileges.
  • You can specify a user at the time of installation and NCache Java Client service process runs under this user’s identity. You can also set a password for the specified user, though it is optional. In case you don’t specify a user, a default user “NCache” is created.
Installation Requirements
  • System Requirements
  • UNIX OS as Clients: NCache Java Client is officially supported on RedHat Enterprise Linux Server (v 6.4), Fedora (v 18), CentOS (6.3) and Ubuntu Server (12.10).
  • Adequate RAM in Cache Clients: Each NCache Java Client server uses around 40-50MB memory as a JVM process and will not use further memory until unless you are using client cache. If you are using client cache then it puts 15-20% overhead on whatever you cache. Please keep this in mind when deciding how much memory to have in your cache clients. The total memory you need depends on how much data you plan to store in the client cache. If you’re storing JSP Servlet Sessions, then figure out your average session size and maximum number of sessions you will ever have in the cache. You can do the same for application data caching.
  • Dual-CPU, Multi-core: NCache Java Client is a highly multi-threaded application and takes full advantage of extra cores and CPUs. The most common configuration for NCache Java Client is a dual-CPU machine where each CPU is either dual-core or quad-core.
  • Disk:  NCache Java Client does not make heavy use of the disk space so you don’t need any extraordinary disk space in your cache server machines.
  • Software Requirements
 JRE/JDK 1.5 or above
Where to Install NCache Java Client
Any web/app server that is not hosting the cache server but instead accesses it remotely across the network is considered an NCache Java Client Remote Client. You need to install the Remote Client portion of NCache on these machines.
See Also