Pivotal Gemfire gfsh shell的使用（2）

gblf

　　Pivotal Gemfire gfsh shell的使用（2）

　　Gfsh的shell变量的使用
    你可以在脚本中嵌入gfsh的shell变量。
　　你也可以使用set variable命令去修改shell行为或者定义自己的shll变量。可以使用下面的命令查看一些列gfsh的shell变量和他们当前的值。
　　echo --string=$*
　　
　　要获得当前存在的变量的值，可以使用下面的命令：
　　echo --string=${VARIABLE}
　　例如：
　　echo --string=${SYS_CLASSPATH}
　　
　　系统变量：
　　SYS_CLASSPATH
　　Gfsh 虚拟机的CLASSPATH（只读）
　　SYS_GEMFIRE_DIR
　　Gfsh安装的生产目录（只读）
　　SYS_HOST_NAME
　　Gfsh启动的主机名（登陆机器的用户名）（只读）
　　SYS_JAVA_VERSION
　　Java使用的版本（只读）
　　SYS_OS
　　操作系统的名字（只读）
　　SYS_OS_LINE_SEPARATOR
　　当写gfsh脚本的时候，可以使用的航分隔符变量（只读）
　　SYS_USER
　　用户的名字
　　SYS_USER_HOME
　　用户工作的目录
　　Gfsh环境变量
　　APP_COLLECTION_LIMIT
　　
　　APP_FETCH_SIZE
　　查询是要使用的大小，值：0-2147483647，默认值1000
　　APP_LAST_EXIT_STATUS
　　最后命令退出的状态，0表示成功，1表示错误，2表示死机（只读）
　　APP_LOGGING_ENABLED
　　Gfsh日志记录是否被激活，默认情况下：false。你可以通过设置gfsh.log-level，java系统属性到一个支持的java记录级别（只读）
　　APP_LOG_FILE
　　当前gfsh记录文件的名字和路径（只读）
　　APP_NAME
　　当前应用的名字（gfsh）
　　APP_PWD
　　Gfsh启动的工作目录
　　APP_QUERY_RESULTS_DISPLAY_MODE
　　为返回结果切换显示模式。值为：table和catalog，，默认值是table
　　APP_QUIET_EXECUTION
　　执行是否应用于安静模式。值：false，true。默认值是：false
　　APP_RESULT_VIEWER
　　仅仅在unix使用，这个变量的设置可以使用少量的unix变量为外部查看输出。
　　
　　使用gfsh去管理远处的在http和https上的集群
　　你可以通过http和https去连接远处的集群，并且使用gfsh命令来管理gfsh。
　　
　　使用http协议去连接一个远处的Gemfire集群：
　　1.启动gfsh
　　2.当启动远程主机的远程集群的时候，当启动JMX管理者（locator和server）的时候你可以选择指定--http-bind-address和 --http-service-port作为Gemfire的属性。这些属性可以保证在使用http协议通过url连接远程Gemfire集群的功能。例如：
　　gfsh>start server --name=server1 --J=-Dgemfire.jmx-manager=true \
　　--J=-Dgemfire.jmx-manager-start=true -J=-Dgemfire.http-service-port=8080 \
　　--J=-Dgemfire.http-service-bind-address=my.remote.cluster
　　     这条命令必须在主机上直接执行，最终将作为远程服务器的HTTP服务GemFire主机远程管理。（你不能启动远程的GemFire服务器）
　　3.在你的本地机器上，运行gfsh的connect命令去连接远程的系统，包括--use-http和--url参数，例如：
　　gfsh>connect --use-http=true --url="http://my.remote.cluster:8080/gemfire v1"
　　Successfully connected to: GemFire Manager's HTTP service @ http://
　　my.remote.cluster:8080/gemfire/v1
　　
　　根据上面的操作，gfsh已经连接到了远程的系统，大多数的gfsh命令现在已经可以通过本地主机在远程系统中运行。但是也有例外，下面的命令在本地被执行。
　　· alter disk-store
　　· compact offline-disk-store
　　· describe offline-disk-store
　　· help
　　· hint
　　· sh (for executing OS commands)
　　· sleep
　　· start jconsole (however, you can connect JConsole to a remote cluster when gfsh is connected
　　to the cluster via JMX)
　　· start jvisualvm
　　· start locator
　　· start server
　　· start vsd
　　· status locator*
　　· status server*
　　· stop locator*
　　· stop server*
　　· run (for executing gfsh scripts)
　　· validate disk-store
　　· version
　　当gfsh通过JMX或者http（s）连接到远程集群的时候，你可以停止或者获得远程locators和servers的状态。如果你在命令中使用--pid或者--dir的参数，那么stop/status命令就只能在本地执行。
　　为远程连接配置SSL，指定gemfire.properties文件中或者gfsecurity-properties，server启动Gemfire配置参数。
　　· http-service-ssl-enabled
　　· http-service-ssl-require-authentication
　　· http-service-ssl-protocols
　　· http-service-ssl-ciphers
　　· http-service-ssl-keystore
　　· http-service-ssl-keystore-password
　　· http-service-ssl-keystore-type
　　· http-service-ssl-truststore
　　· http-service-ssl-truststore-password
　　详细看ssl的配置信息，在383页。
　　上面的参数也适用于所有配置在JMX管理员上的http服务，也包括以下几种：
　　· Developer REST API service
　　· Pulse monitoring tool
　　
　　Shell的基本特征和命令行的使用
　　Gfsh为shell环境提供有益的特征，包括命令自动完成，保护命令历史，多行命令划界，通过命令和主题，上下文先关的帮助是有用的。
　　下面来描写这些特征。
　　在空的提示下按tab键，可以看到一系列有用的gfsh命令。
　　
　　
　　通过使用hint命令在一个特定的主题下获得信息。
　　这个hint命令显示特定主题的一行描述信息和相关命令，例如，用hint data返回特定主题data的描述信息，以及data的所有可能的的行为。
　　
　　Hint server可以显示在Pivotal Gemfire中servers的描述信息，以及一系列管理和监视这些servers的命令。
　　
　　要获得一系列hint的主题，使用hint
　　
　　使用help命令来获得命令的详细信息，help后面跟特定的命令，返回的是特定命令的描述信息，已经特定命令的格式，以及参数的详细描述。
　　（太简单，略）
　　
　　使用tab键来自动补齐一条命令，或者触发可能使用的命令
　　在输入一部分命令之后使用tab键可以触发自动完成命令，或者一系列可能使用的命令。例如，在hint命令之后输入tab键，那么久会显示出可以跟在hint命令之后的所有变量。
　　假如在已经输入hint d之后按下tab键，将会显示以d开头的变量值。
　　
　　自动补齐也支持变量参数和命令参数，例如，输入start之后按下tab键，那么就会显示出所有可以启动的程序。
　　
　　假如在输入start locator之后按下tab键，那么就会显示出--name（该命令必须要跟的参数）
　　所列出的可用命令取决于当前是否连接到一个分布式系统。
　　
　　使用向上箭头键可以访问以前使用的命令。
　　   
　　假如命令有多好需要使用\来划界
　　当输入一个较长的命令是，每一行的结尾可以使用\来连接下一行的命令。
　　
　　使用单引号或者双引号包含着字符串。
　　     gfsh>start locator --name='locator 1'
　　     start locator --name=locator1 --port=9009 --mcast-port=0\
　　--J='-Dgemfire.remote-locators=10.117.33.214[9009],10.117.33.220[9009]'
　　当你在操作系统的shell下的一行中执行多个shell命令的时候，要用双引号扩这gfsh命令，在双引号内用单引号括着含有逗号或者空格的字符传。
　　$ gfsh -e "start locator --name='locator 1'" -e "start server --name=server1"