Apache-Ignite-1.8.0-中文开发手册

15.Web控制台

15.1.Web控制台

Ignite Web控制台是一个交互式的，可配置的向导、管理和监控工具，可以：

• 为Ignite集群创建和下载各种配置；
• 从各种RDBMS模式中自动化构造Ignite的SQL元数据；
• 在内存缓存中执行SQL查询；
• 查看查询的执行计划，内存模式以及流化图表。

Web控制台部署和Logo
为了简化本向导，使用了一个已经部署的Web控制台实例，这个实例部署在GridGain的基础设施上，并且将GridGain的logo嵌入作为主界面的一部分，在本文档的所有截图中，也会看到这个logo，注意可以将Web控制台部署到任意主机，也可以使用其他的logo。

Ignite的Web控制台，可以部署为一个WEB应用，它可以配置所有的集群属性，可以从持久化存储集成的数据库中导入模式，它可以接入特定的数据库以及生成所有必要的OR映射配置文件（XML和纯Java）以及Java领域模型POJOs。Web控制台还提供集群监控的功能（需要一个单独的GridGain插件），可以显示各种缓存和节点的指标，比如CPU和堆使用量等等。

15.2.演示模式

15.2.1.摘要

可以使用Web控制台的演示模式来研究和评估它有关配置和管理集群的各种功能，这个模式中，可以检查预定义的集群、缓存以及领域模型，它还启动了一个内置的H2数据库实例，可以执行各种SQL查询以及查看数据报表，还可以监控各种缓存和节点的指标，比如集群的CPU和堆使用量等。

15.2.2.启动演示模式

要开启演示模式，需要点击控制台顶部菜单的Start demo按钮。

• 下载然后解压Ignite的Web代理；
  
• 打开命令行终端，假定当前在ignite-web-agent目录，运行如下的命令：

./ignite-web-agent.sh

启动Web代理之后，回到浏览器中就可以：
配置集群和缓存
点击控制台侧边栏上的Clusters和Caches，可以查看和设定Ignite的配置参数，点击Summary可以下载这些配置的XML和Java格式文件，这个页面还可以下载一个可用的基于Maven的工程。

导入领域模型
演示模式中，已连接的Web代理中已经启动了H2数据库实例，如下方法可以验证：

• 打开控制台的Domain model界面；
• 点击Import from database，可以看到一个描述Demo的模态窗口；
• 点击Next会看到一个可用模式的列表；
• 点击Next会看到一个可用表的列表；
• 点击Next会看到导入的选项；

• 选择之后点击Save。
  
  执行SQL查询
  该模式中，会启动一个客户端和三个服务端节点，会创建一些缓存并且注入了数据，如下方法可以验证：

• 点击Web控制台顶层菜单的Queries选项卡；

• 会打开预配置SQL Demo查询的笔记本；
• 在demo数据库中，可以执行SQL查询，其中有表：Country, Department, Employee, Parking, Car；

比如输入如下的SQL：

SELECT p.name, count(*) AS cnt FROM "ParkingCache".Parking p`
`INNER JOIN "CarCache".Car c ON (p.id) = (c.parkingId)`
`GROUP BY P.NAME

• 点击Execute按钮，会获得表中的若干数据；
• 点击charts按钮，可以看到自动生成的图表。

15.3.本地部署

15.3.1.先决条件

为了在本地部署Ignite的Web控制台，需要先安装：

• MongoDB（3.2.0以上版本），具体可以参照文档；
• NodeJS（6.5.X以上版本），可以从https://nodejs.org/en/download/current针对具体的OS找到相对应的安装文件。

开始之前需要下载依赖：

• 后台：

cd $IGNITE_HOME/modules/web-console/backend
npm install --no-optional

• 前台：

cd $IGNITE_HOME/modules/web-console/frontend
npm install --no-optional

15.3.2.构建Ignite Web代理

要从源代码构建Ignite的Web代理，需要在$IGNITE_HOME文件夹中执行如下的命令：

mvn clean package -pl :ignite-web-agent -am -P web-console -DskipTests=true

构建过程完成后，会在$IGNITE_HOME/modules/web-console/web-agent/taget中找到ignite-web-agent-x.x.x.zip。

15.3.3.在开发模式中运行Ignite的Web控制台

要在开发模式中运行Ignite的Web控制台，可以按照如下步骤操作：

• 配置MongoDB以服务的模式运行，或者在终端中执行mongod命令来启动MongoDB；
• 将ignite-web-agent-x.x.x.zip复制到$IGNITE_HOME/modules/web-console/backend/agent_dists文件夹；
• 在一个新的终端中切换到$IGNITE_HOME/modules/web-console/backend，如果需要，运行npm install --no-optional(如果依赖改变)，然后运行npm start启动后台；
• 在一个新的终端中切换到$IGNITE_HOME/modules/web-console/frontend，如果需要，运行npm install --no-optional(如果依赖改变)，然后以开发模式启动web，npm run dev；
• 在浏览器中打开：http://localhost:9000。

15.4.Web代理

Ignite的Web代理是一个独立的Java应用，他可以在Ignite集群和Ignite的Web控制台之间建立连接，它在集群节点间通过REST接口进行通信，通过WebSocket连接到Web控制台。
Web代理有两个主要的功能：

• 在Web控制台和Ignite集群间执行SQL查询的代理；
• 在Web控制台和为了Ignite的CacheTypeMetadata配置进行的RDBMS元数据收集的代理；

15.4.1.使用

Ignite的Web代理的压缩包自带了ignite-web-agent.{sh|bat}脚本，用于代理的启动。

先决条件
1.为了与Web代理通信，一个Ignite节点需要开启REST服务模式（将ignite-rest-http文件夹从lib/optional/移动到lib/）;
2.配置Web代理的serverURI属性，指向Ignite节点的REST服务URL。

15.4.2.配置

配置文件
Web代理默认会试图从default.properties文件中加载配置参数。
可用的条目名包括：tokens,server-uri,node-uri,driver-folder。
default.properties：

tokens=1a2b3c4d5f,2j1s134d12
serverURI=https://console.example.com:3001

命令行参数
在终端中执行ignite-web-agent.{sh|bat} -h或者ignite-web-agent.{sh|bat} --help命令，可以获得帮助信息。
他描述的可用参数如下：

• -h, --help - 输出帮助信息；
• -c, --config - 配置文件的路径；
• -d, --driver-folder - JDBC驱动所在文件夹的路径, 默认值为./jdbc-drivers；
• -n, --node-uri - 连接到Ignite REST服务的URI, 默认值为：http://localhost:8080;
• -s, --server-uri - 连接到Ignite Web控制台的URI, 默认值为:http://localhost:3001;
• -t, --tokens - 用户的安全令牌。

15.4.3.代理配置

通过将JVM_OPTS环境变量中的系统参数传递给代理的方式，可以配置代理。
每个属性的详细描述，可以看这个文档。
HTTP
http.proxyHost：代理服务器的主机名或者地址；
http.proxyPort：代理服务器的端口号；
如果代理需要认证，需要传递下面的系统参数：
http.proxyUsername：用户名；
http.proxyPassword：密码；

JVM_OPTS="-Dhttp.proxyHost=<proxy-hostname> -Dhttp.proxyPort=<proxy-port> -Dhttp.proxyUsername=<proxy-username> -Dhttp.proxyPassword=<proxy-password>" ./ignite-web-agent.sh

set JVM_OPTS=-Dhttp.proxyHost=<proxy-hostname> -Dhttp.proxyPort=<proxy-port> -Dhttp.proxyUsername=<proxy-username> -Dhttp.proxyPassword=<proxy-password>
./ignite-web-agent.bat

HTTPS
https.proxyHost：代理服务器的主机名或者地址；
https.proxyPort：代理服务器的端口号；
如果代理需要认证，需要传递下面的系统参数：
https.proxyUsername：用户名；
https.proxyPassword：密码；

JVM_OPTS="-Dhttps.proxyHost=<proxy-hostname> -Dhttps.proxyPort=<proxy-port> -Dhttps.proxyUsername=<proxy-username> -Dhttps.proxyPassword=<proxy-password>" ./ignite-web-agent.sh

set JVM_OPTS=-Dhttps.proxyHost=<proxy-hostname> -Dhttps.proxyPort=<proxy-port> -Dhttps.proxyUsername=<proxy-username> -Dhttps.proxyPassword=<proxy-password>
./ignite-web-agent.bat

SOCKS
socksProxyHost：代理服务器的主机名或者地址；
socksProxyPort：代理服务器的端口号；
如果代理需要认证，需要传递下面的系统参数：
java.net.socks.username：用户名；
java.net.socks.password：密码；

JVM_OPTS="-DsocksProxyHost=<proxy-hostname> -DsocksProxyPort=<proxy-port> -Djava.net.socks.username=<proxy-username> -Djava.net.socks.password=<proxy-password>" ./ignite-web-agent.sh

set JVM_OPTS= -DsocksProxyHost=<proxy-hostname> -DsocksProxyPort=<proxy-port> -Djava.net.socks.username=<proxy-username> -Djava.net.socks.password=<proxy-password>
./ignite-web-agent.bat