1. 环境准备

OPGview程序运行需要Node.js环境，默认情况下使用自带Node V10绿色环境，客户无需额外安装Node.js环境。
若客户服务器环境自带Node环境，也可使用客户Node环境，此时需修改启动文件中Node环境变量路径。
浏览器：支持主流 Chrome、Firefox和 IE11+等浏览器。

2. 授权准备

本软件需要获取授权方可使用。因为授权文件依赖软件部署服务器硬件配置，请客户确定OPGview软件部署服务器（软硬件配置不再变更）后，再联系麦杰公司申请和制作OPGview授权。
麦杰公司将会向客户发送机器码获取工具和机器码获取指导书，在客户获取机器码后，如图机器码为：126CP-2EF7G-R4GJ4-65Y51，会根据机器码生成对应授权文件。

客户需将麦杰公司给予的授权文件license.xml通过配置管理界面上传至资源文件，或者手工放置到opgview/user目录。
请注意：软件授权仅支持申请服务器上使用，复制或修改文件均无法正常使用。

3.部署文件

Windows环境下，将OPGview程序软件包复制到客户指定目录，执行文件解压后，文件目录结构如下图所示：

目录	文件	功能
OPGview	run.bat	软件服务启动文件
OPGview	stop.bat	软件服务停止文件
OPGview	logs.bat	软运行日志打印文件
OPGview	package.json	项目所需要的各种模块，以及项目的配置信息
OPGview	Package-lock.json	项目所需要的各种模块，以及项目的配置信息
OPGview\user	opgview.db	项目本地库
OPGview\user	license.xml	软件授权文件
OPGview\user	config-server.js	项目配置文件，包括服务端口、数据库连接、中英文切换等配置文件
OPGview\user	config-web.js	项目前端配置文件
OPGview\user	errDescript.js	自定义故障报警配置文件
OPGview\user\diagram	*.zxml	组态图形文件
OPGview\user\diagram\imglib	.jpg,.gif等	组态图形文件显示时外调图形/图片
OPGview\user\diagram_otherReference	*.json	变量定义文件
OPGview	Instructions.md	项目说明文档
OPGview	config.js	项目默认配置文件
OPGview	app.js	移动端代码文件
OPGview\logs	logs	项目运行日志
OPGview\locales	cn.json, en.json	服务中英文配置
OPGview\node_modules	*	项目Node.js 运行所需依赖
OPGview\node-v10.14.1-win-x64	*	项目Node.js 运行所需Node环境
OPGview\public\images	*	登陆页面、回放页面所需图片
OPGview\public\audio	*.ogg	报警声音文件
OPGview\views	index.hbs	PC 实时首页
OPGview\views	replayer.hbs	PC 回放首页
OPGview\views	login.hbs	登陆页面
OPGview\views\mobile	view.hbs	手机端首页
OPGview\routes	*.js	项目Node.js 文件
OPGview\bin	www	服务启动文件

Linux环境下，将OPGview程序软件包复制到目的目录，执行文件解压后，文件目录结构如下图所示：

目录	文件	功能
OPGview	run.sh	软件服务启动文件
OPGview	stop.sh	软件服务停止文件
OPGview	logs.sh	软件运行日志打印文件
OPGview	package.json	项目所需要的各种模块，以及项目的配置信息
OPGview	Package-lock.json	项目所需要的各种模块，以及项目的配置信息
OPGview\user	opgview.db	项目本地库
OPGview\user	license.xml	软件授权文件
OPGview\user	config-server.js	项目配置文件，包括服务端口、数据库连接、中英文切换等配置文件
OPGview\user	config-web.js	项目前端配置文件
OPGview\user	errDescript.js	自定义故障报警配置文件
OPGview\user\diagram	*.zxml	组态图形文件
OPGview\user\diagram\imglib	.jpg,.gif等	组态图形文件显示时外调图形/图片
OPGview\user\diagram_otherReference	*.json	变量定义文件
OPGview	Instructions.md	项目说明文档
OPGview	config.js	项目默认配置文件
OPGview	app.js	移动端代码文件
OPGview\logs	logs	项目运行日志
OPGview\locales	cn.json, en.json	服务中英文配置
OPGview\node_modules	*	项目Node.js 运行所需依赖
OPGview\node-v10.14.1-win-x64	*	项目Node.js 运行所需Node环境
OPGview\public\images	*	登陆页面、回放页面所需图片
OPGview\public\audio	*.ogg	报警声音文件
OPGview\views	index.hbs	PC 实时首页
OPGview\views	replayer.hbs	PC 回放首页
OPGview\views	login.hbs	登陆页面
OPGview\views\mobile	view.hbs	手机端首页
OPGview\routes	*.js	项目Node.js 文件
OPGview\bin	www	服务启动文件

4. 软件启动

Windows系统下以管理员身份双击OPGview\logs.bat，启动软件运行日志打印服务，随后双击OPGview\run.bat，即可启动成功，通过logs.bat窗口可查看服务运行过程日志打印等情况。

如果想关闭程序，可关闭OPGview\logs.bat运行窗口，同时执行OPGview\stop.bat，即可停止程序。

Linux系统下root身份执行./logs.sh，随后执行./run.sh，即可启动程序并可查看服务运行过程中日志打印等情况。
如果想关闭程序，可关闭./logs.sh运行界面，同时执行./stop.sh，即可停止程序。

5. 系统登陆

OPGview程序默认服务端口8088，默认用户admin，密码 123456（建议用户登录后修改缺省密码，以确保信息安全）。
服务器本地登陆，地址栏输入 /http://127.0.0.1:8088/opgview，/ 跳转至程序登录界面。若在其他机器登陆，请输入服务器相应IP和端口。

**OPGview服务和openPlant实时数据库连接成功后方可正常工作。**OPGview服务默认连接本地127.0.0.1:8200数据库。目前支持配置双数据库连接，系统主动连接通信正常的数据库，用户也可自动切换数据库连接。

若默认数据库连接不存在，初次启动或者成功登录后，图形监控界面默认为配置管理界面，用户需要进行openPlant配置、前端首页等配置方可正常使用。如需修改默认服务端口8088等，请参考[基础配置]执行图形首页、自定义端口修改和数据库信息切换等配置项管理。

数据库连接配置完成后，重新登录系统。默认用户admin，密码 123456（建议用户初次登录后立即修改缺省密码，以确保系统信息安全）。

数据库连接配置完成后，请刷新浏览器，重新登录系统：

若默认数据库连接存在，则界面如下图所示。用户需要进行openPlant配置、前端首页和服务端口等基本配置，请参考[基础配置]执行图形首页、自定义端口修改和数据库信息切换等配置项管理。

6. 外部引用

访问指定页面，请填入具体参数访问对应的页面，方式如/http://127.0.0.1/ /:8088/opgview/ //direct?user=admin&password=e10adc3949ba59abbe56e057f20f883e&filePath=padlock.zxml&showToolbar=false&view=view/
其他页面的对应关系如下：trend->趋势,dataView->数据一览，alarmView->报警一览，user_management->用户管理，system_log->系统日志，operate_log->操作日志，dataManage->数据管理，replayer->图形回放，report->数据历史。