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

21.Web控制台

21.1.入门

21.1.1.摘要

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

• 创建和下载Ignite集群使用的各种配置；
• 从任何RDBMS模式中自动化构建Ignite的SQL元数据；
• 提供管理和监控的功能，可以在内存缓存上执行SQL查询，比如查看执行计划，内存模式以及流式图表等。

21.1.2.演示模式

如果要为了进行评估，可以使用Web控制台的演示模式，要开启这个模式，需要点击Start demo按钮，转到顶级菜单，然后等待一个弹出式页面出现，他会提供额外的步骤。
从数据库中导入领域模型
这个模式中，在连接到Ignite的Web代理时，会启动一个内存内的H2数据库。
做法：

• 打开Web控制台的Domain model界面；
• 点击Import from database，可以看到一个带有demo描述的模型窗口；
• 点击Next按钮，可以看到可用的模式列表；
• 点击Next按钮，可以看到可用的表列表；
• 点击Next按钮，可以看到导入选项；
• 选择一部分然后点击Save。

SQL演示
做法：
这个模式中服务端和一个客户端节点会启动，一个缓存也会创建并且注入数据：

• 在Ignite Web控制台的顶级菜单中点击SQL；
• 会打开配置好查询的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按钮，可以获得自动生成的图表。

21.2.本地部署

21.2.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

21.2.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。

21.2.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。

21.3.Web代理

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

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

21.3.1.使用

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

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

21.3.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 - 用户的安全令牌。