Skip to content

Latest commit

 

History

History
201 lines (130 loc) · 9.75 KB

INSTALL.md

File metadata and controls

201 lines (130 loc) · 9.75 KB
Raw

安装核心功能

安装前请加钉钉交流群：11779932(加入验证：F2etest)，下载钉钉：https://www.dingtalk.com/

  1. 安装nodejs

    安装请访问官网：https://nodejs.org/，如果已安装好，请略过。

  2. 下载f2etest代码

     git clone https://github.com/alibaba/f2etest.git

    clone后，会发现以下几个目录：

    1. f2etest-web: f2etest的WEB站点，用来提供f2etest服务，用户最终就是访问这个站点使用f2etest
    2. f2etest-guacamole: 这是我们定制过的开源版本，方便f2etest进行调用
    3. f2etest-client: f2etest的执行机客户端站点，主要提供API给f2etest-web使用，用来同步用户账号
    4. hostsShare-client: 安装在f2etest远程环境中的客户端，用来修改f2etest-web上的hosts绑定
    5. f2etest-local: 用来在本机安装代理服务器，并将f2etest所有访问反向代理到本地，以共享本机的hosts绑定，本组件已发布至npm，无需安装，详细使用请至系统内查看帮助
    6. f2etest-chrome: chrome浏览器下的客户端，无需打开f2etest网站，即可访问f2etest中的所有APP，本组件已发布至chrome官方市场，无需安装，详细使用请至系统内查看帮助

    下面分别针对前4个组件，会有针对性的安装教程。

    我们建议将1，2组件安装在同一台Linux服务器上，操作系统为CentOs。

  3. 安装f2etest-guacamole

    f2etest-guacamole是定制版本的guacamole，安装方法请查看：Install Guacamole

  4. 安装mysql

    安装mysql: https://www.mysql.com/，如果已安装好，请略过安装步骤。

    新建库：f2etest

    初始化表结构：f2etest-web/f2etest.sql

  5. 配置f2etest-web

    初始化f2etest-web

     cd f2etest-web
 npm install

    修改conf/site.json：

    1. port: 站点监听端口号
    2. name: 站点名称，修改为自己站点名称
    3. about: 站点介绍，显示在网页title后面，修改为自己的站点介绍
    4. icon: 站点icon，默认不需要修改
    5. dbHost: 数据库连接信息，修改为mysql服务器IP地址
    6. dbUser: 同上
    7. dbPass: 同上
    8. dbTable: 同上
    9. clientApiKey: f2etest远程桌面客户端的ApiKey，正确的ApiKey才能访问远程的API，用来创建当前用户的账号，请更改为随机值，并保持和f2etest-client中的值一致
    10. guacamoleApi: guacamole的API，请修改为上面第3步安装完成的API
    11. footer: 根据需要修改
    12. statNav: 如果需要自行扩展统计页面，根据需要修改

    修改conf/server.json：

    这里的id必需要与f2etest-guacamole中的名字保持一致

    2003系统不支持remoteApp，2008以上Server系统支持

    修改conf/app.json：

    这里的server必需为server.json中已配置的id。program为可选参数，如果不填则直接连接桌面。

    修改lib/sso.js：

    由于f2etest系统要求必需是登录用户才能访问，因此必需要对接SSO系统才能工作。

    请参考现有的sso.js文件进行修改，对接到您公司内部SSO系统。

    启动f2etest-web服务：

     node app.js

    启动成功后，可以发现WEB服务默认工作在：3000端口号

    然后安装nginx做反向代理，将80端口反向到3000端口，以将3000端口号隐藏起来。

    nginx反向配置如下：

     location / {
     proxy_pass       http://127.0.0.1:3000;
     proxy_set_header Host      $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
     proxy_buffering off;
 }

    小建议：

    1. 建议使用pm2或forever等组件实现系统开机自动运行。
    2. 安装快捷方式到Windows桌面 (Win7)功能，需要让f2etest-web支持HTTPS协议，否则此功能无法正常使用

  6. 安装windows server机群

    • 1号机：Server 2003: IE6
    • 2号机：Server 2003: IE7
    • 3号机：Server 2008: IE8
    • 4号机：Server 2008: IE9
    • 5号机：Server 2008: IE10
    • 6号机：Server 2008: IE11

    将来如果出现新的浏览器，可以即时增加新的服务器，用来部署新浏览器或软件。

    如果在现有运行一段时间的系统中部署新服务器，请访问以下URL来同步所有账号：http://f2etest.xxx.com/syncAllRemoteUsers

    由于Server 2008可安装的最低IE版本是8，因此IE6和IE7只能安装在Server 2003系统中。

    安装软件及配置：

    1. 远程桌面会话主机：授权模式请选择按用户，会话请选择5分钟自动结束，空闲会话不允许超过6小时，颜色限制最大24位色
    2. 远程桌面授权：必需要进行正确激活并安装授权，安装时请选择企业授权，并按用户授权
    3. IIS：用来部署f2etest-client，由于我们的脚本使用asp编写，因此请安装asp相关支持组件
    4. 设置当前主机每天凌晨自动重启：防止开机久了，系统出现不稳定
    5. 用户组配置：请将Authenticated Users添加到Remote Desktop Users，允许普通用户可以登录远程
    6. 配置Remote App：如果是2008操作系统，需要将被远程的程序添加到Remote App，否则无法远程，添加快捷方式时请选择：允许任何命令行参数
    7. 安装周边软件：输入法，Flash等

    提示及注意事项：

    1. chrome必需要安装standalone版本：https://www.google.com/chrome/browser/desktop/index.html?system=true&standalone=1
    2. 使用频率比较低的浏览器，建议硬件配置可以适当降低
    3. 2008如果默认安装的是IE10浏览器，可以从安装补丁上卸载，从而降级到IE8，但是没办法降级到IE6或IE7
    4. 建议在任务计划程序中添加每周磁盘碎片整理，以保持最高工作性能

    IE浏览器安全级别低解决方案(此步骤非常重要，如果不操作，会出现cookie无法写入)：

    1. 以桌面模式连接一个User用户
    2. 按照需要自由配置IE
    3. 打开regedit，导出HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\为c:\ie.reg
    4. 切换为administrator用户
    5. 用文本软件打开c:\ie.reg，替换HKEY_CURRENT_USER为HKEY_Users\Default
    6. 打开regedit，注册表编辑器中选择节点：HKEY_USERS，文件菜单->加载配置单元，选择C:\Users\Default\NTUser.dat，项名称输入：Default
    7. 双击c:\ie.reg导入注册表
    8. 在注册表编辑器中选择刚才加载的配置单元：Default，文件菜单->卸载配置单元，并确认上载

    如何在每台服务器全局添加可信的根证书：

    1. 命令行打开mmc
    2. 菜单->添加/删除管理单元, 并选择：证书
    3. 下一步选择：计算机帐户，再点击下一步
    4. 在受信任的根证书颁发机构的证书栏目中添加CA即可

  7. 部署f2etest-client\f2etest-browsers

    请将f2etest-client\f2etest-browsers复制到c:\f2etest-browsers\。

    确保如下路径：c:\f2etest-browsers\www\

    然后做如下操作：

    1. 将curl的路径添加到系统变量的PATH路径中，以供APP快捷方式调用
    2. 添加IIS站点：c:\f2etest-browsers\www\, 站点必需设置为administrator权限，否则无法工作，并且www目录设置为仅管理员有权限，防止任何人都可以创建账号
    3. 修改setuser.asp中的apiKey，保持和f2etest-web中一致。

    每台Server服务器上都需要部署f2etest-client\f2etest-browsers，实现以下两个功能：

    1. 提供API给f2etest-web调用，用来初始化用户账号
    2. 远程桌面连接时，需要打开指定的浏览器或软件，并统计相应软件的使用次数

    请根据需要选择合适的bat模板，模板中需要修改3处地方：

    1. f2etestDomain: 修改为内部部署的f2etest域名
    2. appid: 修改为f2etest-web中配置的相同应用id
    3. 打开应用： 替换为应用的程序路径

    2008中必需要安装Remote App，并且要在Remote App的设置中：允许任何命令行参数。

    如何确定f2etest-client安装成功？

    请确保在服务器上访问以下URL(key改为配置好的key)，返回值是ok：http:/127.0.0.1/setuser.asp?username=test&password=hello123&key=xxx

  8. 安装hostsShare-client

    hostsShare-client基于node-webkit开发，默认已经提供了一个编译版本在build目录中，可以直接部署使用。

    本应用使用频率较高，建议选择CPU比较空闲的机器上部署。

    hostsShare-client的bat可直接复制f2etest-client/app/中的：禁用代理.bat

部署WebDriver云

  1. 开启WebDriver功能：conf/site.json中的wdEnabled为true，此时重启f2etest-web，可以在上方菜单栏上看到：WebDriver云
  2. 初始化执行机节点：详细安装请查看f2etest-client/f2etest-webdriver/节点部署教程.md

经过上面的安装过程，我们的WebDriver云即已经部署完成，可以对外服务了。

f2etest v1.0.0系列如何升级到v2.0.0 v3.0.0

  1. 导入f2etest-web/f2etest.sql中的wd_开头的表初始化代码
  2. 更新f2etest-web到v2.0.0版本
  3. 按照上面的部署教程进行部署