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
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
(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
(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
If the initialization is finished, initialized is displayed in the State column.
(4) Create caches
Execute the eztool createcache command to create a cache for storing keys and values.
eztool createcache cache-name
Command execution example
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)
(5) Verify that caches have been created
Execute the eztool listcache command to display a list of caches.
eztool listcache
Command execution example
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.
(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
(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
If the EADS servers have been opened, running is displayed in the State column.