明源云交付中心一、准备工作
1、申请外网端口，用于部署接口
ERP接口管家是明源云产品访问ERP服务器或数据库的入口。
因为明源ERP产品通常部署在客户内网，明源云产品无法直接访问，所以必须通过一个外网可访问的接口程序作为桥梁，来访问ERP服务器或数据库的入口。 这套接口程序仍然部署在企业的内网环境，只是映射一个外网可访问的端口，如果客户已经使用云客/云服务产品，可以跳过此步骤。
2、确认安装步骤
请确认二开项目组发出的更新包已更新到ERP环境；（此更新包非必需环节，如果没有请跳过此步骤）
如何知道本次是否存在ERP更新包，可以登录移动交付中心（http://jfplatform.fdccloud.com/）确认，如果存在如下红色备注字样则需要更新ERP。
erp更新包包含内容：
1. 数据库更新（按照sql编码顺序依次执行）；
2. 程序更新（更新到工作流站点）；
当以上全部更新完后，开始接口管家的部署
二、获取安装部署工具
登陆移动交付中心（http://jfplatform.fdccloud.com/login/index）点击“下载安装包”获取，明源云产品接口安装程序工具
附服务器硬件要求
注：硬件需人工确认，安装程序不做检测，未达标的可能会有性能风险，取决于客户的用户量和数据量。
三、环境检测
下载的安装包为zip格式，只用解压一次，解压后为exe文件，注意右键以管理员身份运行，会自动生成桌面快捷运行图标，点击“接口管家安装工具（必须）”开始部署
如上图所示，安装程序运行后，第一步进行安装环境检测，点击【显示详细信息】按钮，可显示具体检查的信息，点击【运行检查】按钮，可开始检查，必须检查全部通过，才能点击【下一步】按钮
检查选项不通过对应的解决方案：
1、 明源云产品接口更新服务器是否存在
接口服务器上访问http://erpapi.fdccloud.com/站点，如打不开，请联系IT检查网络情况
2、 IIS安装情况
需安装IIS6.0以上
3、.Net Framework环境
需安装.net framework 3.5 sp1，注意低于或高于这个版本都不行，在360软件管家中搜索.net下载安装下图的包即可
4、“ISAPI和CGI”限制项
上图中红框部分，需要是允许
5、是否已经安装过明源云产品接口站点
如果之前已经安装过云产品，工具会提示已经安装（非首次部署都会有这个提示），点击“是”继续安装部署 ，工具会自动走修复模式
注：卸载不要轻易使用，如一定要卸载请先备份站点目录
四、配置站点
企业ID：点击【通过企业代码获取企业ID】按钮，在弹出的对话框中输入企业代码，会自动生成企业ID。
注：企业代码在租户开通时通过邮件发给了登记的项目经理。如下图2所示，红框中企业代码一栏。
网站名称：如无特殊需求，默认即可【默认为：MysoftCloud】。
安装目录：如无特殊需求，默认即可【默认为：D:\MysoftCloud】，可根据客户具体情况点击后面“
”调整安装目录。
内网IP/端口：本处填写安装接口管家程序的本机IP和IIS提供服务的端口。【默认为交付中心提交的"接口地址"对应的本机ip和端口】
（请检查端口是否被占用，端口不是erp的端口是接口管家端口，且是非占用端口）
例如：localhost 9001 （ localhost代表本机IP，注意地址不要带“http://”）
外网IP/端口：本处填写通过外网来访问接口的地址和外网端口。【默认为交付中心提交的"接口地址"】
并获取内外网ip和端口（获取的是实施在交付中心提交任务是填写的“接口地址”见图1）
例如：120.129.1.2 9001 （请确保外网端口已开放，注意地址不要带“http://”，如果申请外网为https模式，必须在ip前面带上“https://”）
举例：假设客户内网部署接口管家的机器为 192.168.1.9，客户外网地址为 120.129.1.2，端口9001是空闲的，并且可以被外网访问。
那么我们将会把接口管家站点部署到192.168.1.9上，并设置端口9001为站点的端口。最终云端访问接口管家站点将会通过 120.129.1.2:9001 这个地址来访问。
图1：
图2：
五、执行安装
点击【下一步】到执行安装
点击【执行】按钮，系统会自动依次安装
到操作6、启动接口管家配置工具时，会弹出配置工具。下面以云助手举例：
1.若接口站点和ERP站点在一台服务器上，且服务器上只有一个erp站点会自动读取各配置，否则可通过【自动配置】按钮，直接选择ERP主站点地址，系统会自动读取各配置，
请务必人工检查一次后保存。
2.若不在一台服务器上则根据提示，按需手动填写数据源，数据库名称，用户名，密码，ERP主站点地址，工作流系统站点地址，报表服务地址等信息。
填写完，人工检查读取信息无误后点击【确定并保存】，工具会自动检测填写信息，检测可以正常访问会关闭配置工具，否则提示具体报错信息；
若部署工具状态执行全部成功，弹出安装完毕提示框，注意根据提示登录云助手后台做组织架构初始化和应用授权方可使用云助手app，点击【确认】按钮关闭即可。
注：云助手后台追结构初始化&应该授权文档：http://jfplatform.fdccloud.com/article/view?id=10
若报错可尝试点击【重新执行】按钮或联系云助手运营处理。
配置填写说明如下：
数据库配置信息（必填）
示例：
数据源：10.5.11.14\SQL2008R2;
数据库名称：dotnet_erp305_lianying_jscf_branch1
用户名：sa
密码：95938
说明:
在ERP站点bin\License.xml中查找regname后的部分例如‘dotnet_erp307sp2_lianying_zjld_trunk’，在注册表（运行regedit）中查找该字段后，会显示如下图所示信息，ServerName为数据源，DBNname为数据库名称，UserName为用户名，SaPassword为加密后的密码，未加密的密码可联系IT管理员获取
若客户ERP存在多个数据库，则使用高级模式填写多个数据库信息
ERP站点配置信息
ERP主站点地址：（必填）
在IIS中找到ERP站点，右侧浏览网站中的地址，如下图所示，例如:10.5.105.20:8000
如有内网和外网两个访问地址，请填写内网地址（10.5.105.20:8080），如果是本机则可填localhost:8000
工作流系统站点地址：（不使用移动审批不用填，使用移动审批则必填）
ERP305SP1之前，工作流和ERP是同一站点，地址和ERP站点相同，
305SP1以后，独立站点，可在IIS中查找对应站点，例如:10.5.105.20:8002
如有内网和外网两个访问地址，请填写内网地址
说明：
根据左侧站点列表，如果有单独带wf或workflow字样的站点，则其为工作流独立站点，右侧浏览网站中的地址，就是工作流站点地址，如果没有则填ERP主站点即可
或登录ERP，在系统设置-系统初始化-运行设置中查找工作流站点地址
报表服务地址和报表服务键值：（不使用移动报表不用填，使用移动报表则必填）
IIS中浏览ERP站点文件，主目录下web.config文件中搜索MyRptServices字段value=后面的地址为报表服务站点地址。
例如:http://10.5.105.20:8002/MyRptServices.asmx，
搜索MyRptAppKey字段value=后面的部分为报表服务键值。
例如:myrpt
Web.config文件实例如下：
注：
在客户的服务器上必须能够访问这个地址 http://www.fdccloud.com
这个地址是移动微助手云端后台的地址，接口管家运行的过程中需要与该地址通信。
如果该地址无法在接口管家的服务器上访问，那么就意味着接口管家无法正常运行。
验证方法：在接口管家所在的服务器上，打开浏览器，在地址栏里输入以上地址。
如果能够访问，即没问题。不能访问，就需要让客户IT开放该地址的访问。
访问验证如下图：（建议使用谷歌浏览器打开）
七、更新移动审批服务（如果工作流站点在部署的本机会自动执行，否则需要自己复制安装包到工作流站点服务器以管理员身份运行执行工具“移动审批框架推送工具（非必须）”）
选中需要部署的工作流站点注意不是erp站点【可以根据端口搜索】，选中后点击“执行更新”，执行成功后再去接口管家服务器运行安装部署工具。
八、云助手后台数据初始化&应用授权
1、云助手后台登录
云助手后台地址：https://www.fdccloud.com/
登录方式：企业代码+admin+管理员密码
注：云助手后台登录信息在租户开通时通过邮件发出，请注意查收发件人为【明源云】，主题为【【重要】xxx客户-云助手企业平台管理账号】的邮件
2、做组织架构初始化&应用授权
注：云助手后台追结构初始化&应该授权文档：http://jfplatform.fdccloud.com/article/view?id=10
3、使用云助手App
登录方式：企业代码+ERP帐号+ERP账号对应密码
下载云助手App：各手机应用商城搜索“明源云助手”下载安装，扫码安装，二维码如下。
九、常见问题
当出现错误后，可点击蓝色字体，查看具体的报错信息
【启用网站并测试失败】：此问题是由于外网端口不可用导致
附端口的验证方法：
1、开通防火墙端口（入口和出口）。具体过程如下：
http://jingyan.baidu.com/article/f96699bbadafca894f3c1b7a.html
2、向客户IT申请开通外网端口，IT会在交换机上做好映射。
3、 在服务器上创建站点，站点下随意创建个index.html页面。
4、 绑定端口，然后外网访问地址，只要页面可以正常访问即可。如客户IT将9001绑定到120.129.1.2上，那么访问：http://120.129.1.2:9001/index.html
作者： 张丽 日期： 2019-11-07