GridDB^TM Standard Edition Deployment Guide for AWS Marketplace

GridDB Standard Edition is available as AMI on the AWS Marketplace. This manual describes the basic deployment procedure of GridDB on AWS Marketplace.

For details on GridDB Standard Edition, please refer to our GridDB Developers page.

Please visit the GridDB Standard Edition Marketplace and follow the onscreen instructions to create GridDB instance in your VPC. We recommend that you create 3 or more instances when configuring a GridDB cluster.

GridDB node requires the following inbound ports to be open:

Protocol	Port range	Description
TCP	22	For operation over SSH.
TCP	10001,10010,10020,10040	GridDB default ports, to communicate with clients and other nodes.

For details on GridDB ports, please refer to "2.3 Setting the environment-dependent parameters" of the GridDB quick start guide.

You can connect to the EC2 instances via SSH as the centos default OS user once the instances have been deployed and the security group has been configured.

$ ssh -i your_keypair.pem centos@172.17.xx.xx

When you deploy the EC2 instance, the following group and user are created by default in the OS. This OS user is the default operator of GridDB.

Group	User	Home directory
gridstore	gsadm	/var/lib/gridstore

The following environment variables are automatically defined when you login as gsadm.

Environment variables	Value	Meaning
GS_HOME	/var/lib/gridstore	gsadm/GridDB home directory
GS_LOG	/var/lib/gridstore/log	Event log file output directory

[Note]

• These environment variables are used in the operating commands described in the later section.
• As gsadm password is not set by default, please login as the root user and set the password.
  • Some of the functions of the operation tools may be necessary.

To log in as gsadm from centos user, please use the following command.

$ sudo su - gsadm

The following directories and files, as well as the necessary modules and commands are created in the GridDB instance.

/var/lib/gridstore/        # GridDB home directory
     backup/               # Backup directory(unused)
     conf/                 # Directory storing definition files
         gs_cluster.json   # Cluster definition file
         gs_node.json      # Node definition file
         password          # User definition file
     data/                 # Directory storing database files
     log/                  # Directory storing event log files

$ ls /usr/griddb
bin  conf  docs  etc  lib  license  prop  Readme.txt  rpm  web  webapi

When you access and run a GridDB node, the following files are created in the directories to store database files and event log files.

[Database file]

/var/lib/gridstore/        # GridDB home directory
     data/                 # Directory storing database files
         gs_log_n_m.log    # File recording transaction logs (n, m: positive number)
         gs_cp_n_p.dat     # Checkpoint file recording data regularly (n, p: positive number)

[Event log file]

/var/lib/gridstore/              # GridDB home directory
     log/                        # Directory storing event logs
         gridstore-%Y%m%d-n.log  # Event log file

You can change the directories used to store files by editing the relevant parameters in the node definition file.

Please refer to the following documents for more information

• GridDB Manuals

An administrator user is needed for authentication purposes in nodes and clusters. Administrator user information is stored in the User definition file. The default file is shown below.

• /var/lib/gridstore/conf/password

The following users are created by default.

User	Password
admin	admin
system	manager

Administrator user information including the default users can be changed using the following user administration command in the operating commands.

Command	Function
gs_adduser	Add an administrator user
gs_deluser	Delete an administrator user
gs_passwd	Change the password of an administrator user

Change the default users password using the gs_passwd command shown below. The password is encrypted during registration.

$ gs_passwd admin
Password:(Input password)
Retype password:(Input password again)
$ gs_passwd system
Password:(Input password)
Retype password:(Input password again)

When adding a new administrator user (not including the default users), the user name has to start with gs#. One or more ASCII alphanumeric characters and the underscore sign "_" can be used after gs#.

An example on adding a new administrator user is shown below.

$ gs_adduser gs#newuser
Password:(Input password)
Retype password:(Input password again)

[Note]

• Changes to the administrator user information take effect after the node is restarted.
• User information is used for client authentication, so the common user information must be registered in all nodes. Please ensure that these information are available in all nodes by copying the user definition file.

/usr/griddb/              # Installation directory
     conf/                # Directory storing definition files
         gs_cluster.json  # Template for cluster definition file
         gs_node.json     # Template for node definition file

/var/lib/gridstore/       # GridDB home directory
     conf/                # Directory storing definition files
         gs_cluster.json  # (Edited) Cluster definition file
         gs_node.json     # (Edited) Node definition file

{
                             :
                             :
  "cluster":{
    "clusterName":"yourClusterName",
    "replicationNum":2,
    "heartbeatInterval":"5s",
    "loadbalanceCheckInterval":"180s",
    "notificationMember": [
     {
        "cluster": {"address":"172.17.xx.xx", "port":10010},
        "sync": {"address":"172.17.xx.xx", "port":10020},
        "system": {"address":"172.17.xx.xx", "port":10040},
        "transaction": {"address":"172.17.xx.xx", "port":10001}
     },
     {
        "cluster": {"address":"172.17.yy.yy", "port":10010},
        "sync": {"address":"172.17.yy.yy", "port":10020},
        "system": {"address":"172.17.yy.yy", "port":10040},
        "transaction": {"address":"172.17.yy.yy", "port":10001}
     },
     {
        "cluster": {"address":"172.17.zz.zz", "port":10010},
        "sync": {"address":"172.17.zz.zz", "port":10020},
        "system": {"address":"172.17.zz.zz", "port":10040},
        "transaction": {"address":"172.17.zz.zz", "port":10001}
      }
    ]
  },
                             :
                             :
}

Check that the OS version is RHEL 6.8/7.2, or CentOS 6.8/7.2.

$ cat /etc/redhat-release
CentOS Linux release 7.2.1511 (Core)

The following needs to be installed as a Java language development environment.

• Oracle Java 6/7/8

The following needs to be installed as a C language development environment.

• GCC 4.4.7 or higher

This chapter explains the installation procedure of the client library.

Before installing the client library, please copy the client library RPM package to the client instance first.

Package name	File name	Description
griddb-se-java_lib	griddb-se-java_lib-X.X.X-linux.x86_64.rpm	Java library is included.
		(/usr/share/java/gridstore.jar)
griddb-se-c_lib	griddb-se-c_lib-X.X.X-linux.x86_64.rpm	C header file and library are included.
		(/usr/include/gridstore.h and /usr/lib64/libgridstore.so)

Client library RPM packages are installed as follows.

/usr/griddb/rpm/
                griddb-se-c_lib-X.X.X-linux.x86_64.rpm
                griddb-se-java_lib-X.X.X-linux.x86_64.rpm

Install using the rpm command as a root user.

# rpm -ivh griddb-se-c_lib-X.X.X-linux.x86_64.rpm 
Preparing...                          ################################# [100%]
Updating / installing...
   1:griddb-se-c_lib-X.X.X-linux      ################################# [100%]

# rpm -ivh griddb-se-java_lib-X.X.X-linux.x86_64.rpm 
Preparing...                          ################################# [100%]
Updating / installing...
   1:griddb-se-java_lib-X.X.X-linux   ################################# [100%]

When the Java version of the client is used, add the client library to CLASSPATH.

$ export CLASSPATH=${CLASSPATH}:/usr/share/java/gridstore.jar:/usr/share/java/gridstore-conf.jar

When the C version is used instead, add the client library to LD_LIBRARY_PATH.

$ export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/usr/lib64

To connect GridDB instance to the client program in Java on client instance, please specify the connection point and user/password in the client program or Client Properties File.

When using the client for GridDB instance, please specify the "notificationMember" instead of "notificationAddress" and "notificationPort".

For details on the NoSQL specifications, please refer to "Class GridStoreFactory" of the GridDB API Reference.

The installed GridDB sample program is shown below.

/usr/griddb/docs/sample/program:
Sample1.java

This sample program is written for using Client Properties File.

By including both directories which contain the properties file "gs_client.properties" and the configuration library "gridstore-conf.jar" in the classpath, properties of the file are automatically applied to GridStoreFactory. Connection properties can be changed without editing application codes by using the properties file.

Example of gs_client.properties for fixed list connection method

store.notificationMember=172.17.xx.xx:10001,172.17.yy.yy:10001,172.17.zz.zz:10001
store.clusterName=yourClusterName
store.user=admin
store.password=yourpassword

Add the directory path including the client properties file to CLASSPATH.

$ ls /var/lib/gridstore/client
gs_client.properties
$ export CLASSPATH=${CLASSPATH}:/var/lib/gridstore/client

Compile the program and execute it with the following command.

$ javac -d . Sample1.java
$ java gsSample/Sample1

To connect GridDB instance to the client program in C on client instance, please specify the connection point and user/password in the client program.

When using the client for GridDB instance, please specify the "notificationMember" instead of "notificationAddress" and "notificationPort".

For details on the NoSQL specifications, please refer to "gsGetGridStore()" of the GridDB API Reference.

The installed GridDB sample program is shown below.

/usr/griddb/docs/sample/program:
sample1.c

Compile the program and execute it with the following command.

$ gcc -lgridstore -o sample3 sample3.c
$ ./sample1 172.17.xx.xx:10001,172.17.yy.yy:10001,172.17.zz.zz:10001 yourClusterName