# 移动分离部署服务 — 安装部署文档

# 一、简述

移动分离部署服务是为了解决客户需要将移动端 M3 或微协同进行服务单独分离部署需求而提供的独立服务。

移动分离部署服务总共有两个部分组成：

1、主服务 Seeyon-Mobile-Gateway 服务，此服务提供访问代理和请求转发服务。

2、静态服务 Seeyon-Static-Resource 服务，此服务提供静态资源部署和访问服务，静态资源服务是可选服务，如客户有静态资源分离部署需求可使用此服务，如果不需要静态资源分离部署可以不使用此服务。此服务不可独立运行，需依赖主服务。

注意：

1、静态服务目前只支持部署微协同的 H5 静态资源，具体部署方式参考步骤【五、部署静态资源】。

2、微协同使用分离部署后，只能通过微信、企业微信、钉钉、飞书等移动端访问，PC端是不支持访问的。因为分离部署会拦截PC端的 .do 请求。

# 二、网络拓扑图说明

# 三、安装包说明

SeeyonMobileCloud.zip 是整个工程的安装包。直接解压到指定目录即可。解压后的目录中包含主服务 Seeyon-Mobile-Gateway 服务与静态服务 Seeyon-Static-Resource 服务两个文件夹。静态服务 Seeyon-Static-Resource 服务是可选服务，根据用户的需求选择是否需要部署。

解压后目录结构如下：

注意：不可手动修改 init-config.json 初始化配置文件

# 四、安装部署

切记安装部署目录中请勿使用空格和中文字符

# 1、主服务安装部署

a. 直接解压 SeeyonMobileCloud.zip 压缩包到指定目录，或将 SeeyonMobileCloud.zip 压缩包中的 Seeyon-Mobile-Gateway 文件夹及文件夹中的所有文件解压到任意目录即可。

b. 将 JAVA 运行环境 JDK 拷贝到与 Seeyon-Mobile-Gateway 文件夹同级目录

注意：请使用 JDK 1.8 及以上版本，最低版本不能低于 JDK 1.8，推荐使用 JDK 1.8 版本。并且 Windows 与 Linux 系统需要区分 JDK ，32位系统与64位系统也需要区分JDK，请勿混用！

如下所示：

JDK 获取方法：

1.可以将 A8 安装目录下的 jdk 目录完整拷贝，一般在 A8 安装目录与 ApacheJetspeed 目录同级。（推荐，无需额外配置）

2.可以通过 JDK 官网下载获取。JDK 官网下载地址：https://www.oracle.com/hk/java/technologies/javase-downloads.html （不推荐容易配置错误）

c. 运行 Seeyon-Mobile-Gateway/config 目录下的 Config 配置脚本，启动配置工具。（Windows 环境请运行 .cmd 文件；Linux 环境请运行 .sh 文件）

d. 按照提示完成配置即可。

注意：Linux 运行 .sh 脚本需要将 .sh 脚本文件授权可运行权限。详细服务配置请参考【六、服务配置】

# 2、静态服务安装部署（可选服务）

静态服务是可选服务，主要提供静态资源分离部署的能力。如：微协同的 H5 静态资源其中包括：Html, JS, CSS, 图片等资源文件。根据客户自身需求进行部署。

静态服务可独立部署（指：可以与主服务分别部署在不同的服务器上），但不可独立运行，需要与主服务配合使用（指：主服务未部署或未启动状态下，只部署了静态服务是不可以单独直接使用的）。

a. 直接解压** SeeyonMobileCloud.zip** 压缩包到指定目录，或将 SeeyonMobileCloud.zip 压缩包中的 Seeyon-Static-Resource 文件夹及文件夹中的所有文件解压到任意目录即可。

b. 将 JAVA 运行环境 JDK 拷贝到与 Seeyon-Static-Resource 文件夹同级目录如下所示：

JDK 获取方法：

1.可以将 A8 安装目录下的 jdk 目录完整拷贝，一般在 A8 安装目录与 ApacheJetspeed 目录同级。（推荐，无需额外配置）

2.可以通过 JDK 官网下载获取。JDK 官网下载地址：https://www.oracle.com/hk/java/technologies/javase-downloads.html （不推荐容易配置错误）

c. 运行 Seeyon-Static-Resource/config 目录下的 Config 配置脚本，启动配置工具。（Windows 环境请运行 .cmd 文件；Linux 环境请运行 .sh 文件）

d. 按照提示完成配置即可。

说明：

1、Linux 运行 .sh 脚本需要将 .sh 脚本文件授权可运行权限。部署静态资源请参考【五、部署静态资源】；详细服务配置请参考【六、服务配置】；

2、首次配置会自动进行初始化，配置完成保存后初始化生效；

3、初始化生效后 init-config.json 文件将自动删除，并生成新的 config 加密文件，config 加密文件不可手动修改，不可删除；

4、不可手动修改 init-config.json 文件，否则可能导致初始化失败或无法正常保存配置；

5、config 加密文件只在当前服务器 OS 系统中生效，拷贝到其他环境或从其他环境拷贝到当前环境是无法读取的。如需要迁移服务器请在新服务器中重新安装部署。

# 五、部署静态资源

注意：只有微协同静态资源分离部署的时候才需要使用静态资源服务，也只有使用微协同的用户对微协同有分离部署需求的才需要使用静态资源服务，且静态资源服务目前只支持部署微协同静态资源。

1.确认静态服务 Seeyon-Static-Resours 服务的 html 目录下是否有 seeyon 目录，如果没有请新建 seeyon 目录

2.进入 A8(A6,G6) 安装目录 \ApacheJetspeed\webapps\seeyon 目录

目录结构参考如下：

3.将 H5 目录以及目录中的所有文件拷贝到静态服务 Seeyon-Static-Resours 服务的 html 下的 seeyon 目录中。

4.将 m3 目录以及目录中的所有文件拷贝到静态服务 Seeyon-Static-Resours 服务的 html 下的 seeyon 目录中。

5.将 skin 目录以及目录中的所有文件拷贝到静态服务 Seeyon-Static-Resours 服务的 html 下的 seeyon 目录中。

6.将 apps_res 目录以及目录中的所有文件拷贝到静态服务 Seeyon-Static-Resours 服务的 html 下的 seeyon 目录中。

7.将 common 目录以及目录中的所有文件拷贝到静态服务 Seeyon-Static-Resours 服务的 html 下的 seeyon 目录中。

目录结构参考如下：

# 六、服务配置

分别运行主服务 Seeyon-Mobile-Gateway 和静态服务 Seeyon-Static-Resource 的 config 目录下的 Config.cmd（Windows）或 Config.sh（Linux）脚本启动配置工具

注意：Linux 运行 .sh 脚本需要将 .sh 脚本文件授权可运行权限。

1.设置分离服务主服务端口：

端口范围只能为 0 至 65535 的整数，建议使用 8000 以上的端口。8000 以下的端口多为系统保留端口和其他服务端口。并且保证设置的端口未被占用或其他服务使用。

2.设置 A8(A6, G6) 服务地址：

地址格式必须为：http(s)😕/{IP地址或域名}:{端口}，如：http://127.0.0.1:80 或 http://test.a8.co m:80。端口必须填写。并且请确保分离服务能正常访问 A8(A6, G6) 服务的地址。如果 A8(A6, G6) 服务与分离服务在同一个内网环境，建议使用内网的访问 IP 地址或域名，可以提高服务性能。如果 A8(A6, G6) 服务是集群部署，请配置集群服务的地址和端口。