10.2.2 Starting the EADS servers (creating caches on disk)

This subsection is applicable when you will be using disk caches or two-way caches.

This subsection explains how to start the EADS servers and then create disk caches or two-way caches.

Organization of this subsection

(1) Create cache property files
(2) Start the EADS servers
(3) Verify that initialization is finished
(4) Create caches
(5) Verify that caches have been created
(6) Open the cluster
(7) Verify that the EADS servers have been opened

(1) Create cache property files

Create cache property files for specifying cache information, such as the cache types and cache storage locations.

The file name of a cache property file is eads_cache.cache-name.properties.

For details about the cache property parameters, see 7.7 Designing the cache operation-dependent parameters.

Important note

The settings for the parameters shown below must be identical in the cache property files for all the EADS servers that make up the cluster. If any settings are different, caches cannot be created.

The following shows an example of a cache property file for creating a disk cache with the number of EADS servers set to 5 and the number of redundant copies of data plus the original set to 3:

eads.cache.type=Disk
eads.cache.disk.info.dir=store
eads.cache.disk.1.dir=/hdd/cache_server01_range01
eads.cache.disk.2.dir=/hdd/cache_server01_range05
eads.cache.disk.3.dir=/hdd/cache_server01_range04
eads.cache.disk.filesize=128
eads.cache.disk.filenum=8
eads.cache.disk.blocksize=1

To Page Top

(2) Start the EADS servers

Log in to the host on which you plan to start an EADS server, and then execute the ezstart command to start the EADS server. You must execute this command for each EADS server.

ezstart

To Page Top

(3) Verify that initialization is finished

After an EADS server starts up successfully, it changes to initialized status.

Execute the eztool status command to verify that the initialization of all EADS servers is finished.

eztool status

Command execution example

[Figure]

If the initialization is finished, initialized is displayed in the State column.

To Page Top

(4) Create caches

Execute the eztool createcache command to create a cache for storing keys and values.

eztool createcache cache-name

Command execution example

[Figure]

When a cache is created, cache files are created in the following directories:

Cache data file

directory-specified-in-the-eads.cache.disk.n.dir-parameter-in-the-cache-properties/cache-name
Cache index file and cache information file

directory-specified-in-the-eads.cache.disk.info.dir-parameter-in-the-cache-properties/cache-name (the default is management-directory/store/cache-name)

To Page Top

(5) Verify that caches have been created

Execute the eztool listcache command to display a list of caches.

eztool listcache

Command execution example

[Figure]

Check the cache names in the CacheName column and the cache types in the CacheType column to verify that the caches have been created as intended.

To Page Top

(6) Open the cluster

As is the case with closed status, in initialized status, the EADS servers do not accept requests from the EADS client. Execute the eztool open command to open the cluster.

eztool open

Command execution example

[Figure]

To Page Top

(7) Verify that the EADS servers have been opened

Execute the eztool status command to verify that all EADS servers have been opened.

eztool status

Command execution example

[Figure]

If the EADS servers have been opened, running is displayed in the State column.

To Page Top