中国电信宽带整合安装软件管理员手册.doc

中国电信宽带整合安装软件管理员手册目录 1 引言11.1编写目的11.2背景11.3系统规定11.4文献描述12安装软件资源收集安装适配22.1软件的收集22.2软件安装包的整合适配32.3整合安装包的测试发布33配置文献、编辑工具使用说明43.1基础配置43.1.1配置文献描述53.1.2编辑工具使用说明53.2套餐及软件安装配置63.2.1配置文献格式73.2.2编辑工具使用说明113.3添加天翼live好友配置163.3.1配置文献格式163.3.2编辑工具使用说明173.4上报安装记录及修正渠道信息确认204刻录光盘或使用U盘225新增软件安装流程约束225.1安装包必须支持的参数235.2非静默安装过程约束23内部资料，注意保密，未经批准，请勿翻印 版本：1.0文档信息文档名称中国电信宽带整合安装软件文献编号LFT-001编制人保密级别修改过程版本号修改内容修改人修改日期签收人V1.0创建2023-04-26评审过程版本号日期评审者概述1 引言本文档是按照该项目的业务流程编写。1.1编写目的 指导各省管理员使用中国电信宽带整合安装软件。1.2背景a 系统名称：中国电信宽带整合安装软件；b 目的用户：中国电信宽带安装客户代表；1.3系统规定Windows 2023、Windows Me 、Windows XP、 Windows vista 、Windows7等操作系统计算机解决器速度为500 MHz或更快。内存 256 MB以上（推荐使用512 MB）。 安装需要200MB的硬盘空间，安装后，运营最多需要 50MB 的硬盘空间。1.4文献描述整合安装如下图：doc：目录下为个软件的服务条款；Favorites：收藏夹添加项目；Resources：软件安装资源包，所有安装的软件都存放在该目录下；Config.ini friends.ini setup.ini ：为安装需要的配置文献（见第三章节）；Antivirus.dat kasearch.dll ：为杀毒检测必须的文献；AutoSetup.dll WebService.exe：通行证注册、上报安装记录等等所有与后台接口的实现；setup.exe ：为整合安装软件启动文献。CfgTools.exe ：为配置工具。中国电信宽带整合安装软件使用手册.doc：为给用户和客户代表提供的使用手册。2安装软件资源收集安装适配宽带整合安装软件可以整合各地市的电信软件一并进行安装。但由于整合安装软件无法做到非常的智能，可以兼容所有模式的软件安装辨认，所以很多限制都不能突破。不能做到符合第5章节描述的“新增软件安装流程约束”的软件安装包，需要完整的走完这个适配流程才可以实现自动安装。2.1软件的收集各省整合安装管理员收集所有需要安装的所有软件安装包提交给运营中心，并附上说明文档描述清楚软件名称和简朴的描述（不超过24个中文或者48个英文字符，用来显示在安装界面上），说明哪些软件是必须安装的，哪些软件是可以让用户选择安装的；同时附上本省整合安装管理员的姓名、联系电话、邮件地址、msn或者QQ，以方便及时沟通。软件资源收集模式为各省积极上传。访问软件资源上传下载地址：2.2软件安装包的整合适配运营中心会将各省的信息提交给运营中心，开发方将通过收集到的软件安装包和说明文档来对软件进行适配，适配过程是一个反复安装、卸载和验证的过程，根据软件安装的也许出现的情况进行解决和优化，最终完毕软件安装的适配。通过适配后会完毕一个初步的配置文献供各省参考，各省可以根据这个基础进行修改编辑。假如在软件适配过程中碰到有争议的问题，运营中心会直接联系该省的管理员沟通。2.3整合安装包的测试发布各省的中国电信宽带整合安装软件打包完毕后，需要提交到上海研究院测试部门进行各项测试，各项指标都能达成发布标准后会对版本正式发布。访问软件资源上传下载地址：如下图所示：可选择所属的省进行下载。3配置文献、编辑工具使用说明注：配置文献需要在刻录光盘前配置完毕，由于光盘不可写，一旦刻录就不能修改配置文献。配置文献可以手动直接编辑，但是增长了犯错的几率，所以我们同提供了配置文献编辑工具，可以保证配置文献没有错误。运营配置文献编辑工具 CfgTools.exe启动配置过程。3.1基础配置IE首页设立、省地市代码设立、安装人员工号、帮我把电脑的本地IP-设立为：xxx.xxx.xxx.xxx等功能都在该配置文献，使用配置文献编辑工具编辑上述功能将改变这个配置文献的信息。能否实现IE首页设立依赖于这个配置文献中的HOMEPAGE值是否配置对的，假如配置的是个空值，整合安装软件将默认将全国中心互联星空（.cn）设立为用户的首页；假如LOCALIP是一个空值，整合安装软件将默认将用户的电脑本地IP设立为“192.168.0.254”。此外由于每个省的安装包都需要单独维护，所以省代码默认固化在代码内了，不再从该配置文献读取，这样也减少了犯错的几率。3.1.1配置文献描述配置文献名称setup.ini，配置文献格式如下描述：SETUPHOMEPAGE= （各省自行设立该值，假如没设立默认为.cn）PROVINCEID=13 （省代码）CITYSID=551 (城市代码)AREAID=0551 （用户所在地市的长途区号）WORKERNO=00001 （客户代表工号，第一次安装自动记录，下次不需手工设立）WPASSPORT= （客户代表的通行证号码）USERTAOCAN=3 （用户套餐类型，第一次选择自动记录，下次不需手工设立）UPLOADFLAG=OK (是否上传安装记录，第一安装成功自动上传了安装记录写入该信息)UPLOADELIVEFLAG=OK (是否上传安装记录，第一安装成功自动上传了安装记录写入该信息)COPYFLAG=OK (是否有过拷贝记录，第一安装完毕后自动拷贝文献，自动记录该信息)LOCALIP=192.168.0.254 (将用户的电脑本地IP设立为该IP，为可选功能)3.1.2编辑工具使用说明启动配置工具，选择基础设立选项卡，在界面右下侧的其他设立，如下图所示：可以配置IE主页，省代码、地市长途区号、城市代码、安装人员工号、本机IP配置、装维通行证号。设立IE主页的配置，配置好后在给用户安装过程中会将用户的首页设立成给地址。省代码、长途区号、城市代码无需输入，从左边选择一个省，会列出该省的所有地市，选择一个地市后这三个信息会自动输入。安装人员工号：这个信息根据各省具体情况，可以是客户代表的手机号码。本地机IP地址：这个信息是将用户的电脑配置成这个ip地址，本功能在整合安装软件体现为可选功能；假如没有配置，整合安装默认为：192.168.0.254。装维通行证号：输入客户代表的通行证号码或者别名。假如没有通行证需要输入客户代表的手机号码（中国电信的手机号码）。安转软件时将为客户代表开通通行证。3.2套餐及软件安装配置注：在该配置文献配置的安装包必须是已知的安装包，即在整合安装软件发布时已经对这些安装软件进行了安装适配；或者该软件可满足第5章节 “新增软件安装流程约束”的规范（符合该规范的软件安装包，在编辑配置文献前需要添加到“新增安装软件”目录下）。除此之外的软件安装包无法被整合安装软件辨认，不能被整合安装软件自动安装。此外，假如该软件已经通过适配，并且已经发布版本，从发布时间开始 Resources 文献夹下的所有安装软件的安装包文献名称不能再变化，假如改变 Resources 文献夹下软件安装包的文献名称也许会导致整合安装不能正常安装该软件。3.2.1配置文献格式配置文献名称：config.ini，配置文献格式如下描述：用户套餐套餐1=普通宽带用户套餐2=普通E家用户套餐3=尊享E家+电视版套餐4=尊享E家+电脑版普通宽带用户必选setup1=中国电信天翼Live安装程序.exeversion1=1.124description1=中国电信天翼Livesetup2=中国电信安全专家.exeversion2=2.5description2=中国电信安全专家套餐用户免费使用普通e家用户必选setup1=中国电信天翼Live安装程序.exeversion1=1.124description1=中国电信天翼Livesetup2=中国电信安全专家.exeversion2=2.5description2=中国电信安全专家套餐用户免费使用尊享e家+电视版必选setup1=中国电信天翼Live安装程序.exeversion1=1.124description1=中国电信天翼Livesetup2=中国电信安全专家.exeversion2=2.5description2=中国电信安全专家套餐用户免费使用尊享e家+电脑版必选setup1=中国电信天翼Live安装程序.exeversion1=1.124description1=中国电信天翼Livesetup2=中国电信安全专家.exeversion2=2.5description2=中国电信安全专家套餐用户免费使用普通宽带用户可选setup1=try.exeversion1=3.6description1=棋牌游戏中心setup2=Thunder.exeversion2=5.1description2=迅雷普通e家用户可选setup1=try.exeversion1=3.6description1=棋牌游戏中心setup2=Thunder.exeversion2=5.1description2=迅雷尊享e家+电视版可选setup1=try.exeversion1=3.6description1=棋牌游戏中心setup2=Thunder.exeversion2=5.1description2=迅雷尊享e家+电脑版可选setup1=try.exeversion1=3.6description1=棋牌游戏中心setup2=Thunder.exeversion2=5.1description2=迅雷普通宽带用户新增setup1=(安装包名称包含扩展名 .exe)version1=(安装包版本号)description1=(安装包描述)setuptype1=0普通e家用户新增setup1=(安装包名称包含扩展名 .exe)version1=(安装包版本号)description1=(安装包描述)setuptype1=0尊享e家+电视版新增setup1=(安装包名称包含扩展名 .exe)version1=(安装包版本号)description1=(安装包描述)setuptype1=0尊享e家+电脑版新增setup1=(安装包名称包含扩展名 .exe)version1=(安装包版本号)description1=(安装包描述)setuptype1=0配置文献说明：用户套餐：本地的套餐类型配置。套餐1=普通宽带用户套餐2=普通E家用户套餐3=尊享E家+电视版套餐4=尊享E家+电脑版(最多8个)XXXX必选：必选安装包要安装的软件配置。setup1=(第一个必选安装包的名称（可启动安装的名称）)version1=(第一个必选安装包的版本号)description1=(第一个必选软件名称描述)setup2=(第二个必选安装包的名称（可启动安装的名称）)version2=(第二个必选安装包的版本号)description1=(第一个必选软件名称描述)（最多10个）XXXX可选：可选安装包要安装的软件配置setup1=(第一个必选安装包的名称（可启动安装的名称）)version1=(第一个必选安装包的版本号)description1=(软件名称描述，显示在界面上)setup2=(第二个必选安装包的名称（可启动安装的名称）)version2=(第二个必选安装包的版本号)description2=(软件名称描述，显示在界面上)（可选和新增综合最多10个）XXXX新增：动态增长的软件包安装配置setup1=(第一个必选安装包的名称（可启动安装的名称）)version1=(第一个必选安装包的版本号)description1=(软件名称描述，显示在界面上)setuptype1=(是否支持静默安装，0不支持，1支持)setup2=(第二个必选安装包的名称（可启动安装的名称）)version2=(第二个必选安装包的版本号)description2=(软件名称描述，显示在界面上)setuptype2=(是否支持静默安装，0不支持，1支持)（可选和新增综合最多10个）通过对配置文献的配置可以实现以下功能：1、 可以实现几种可选择的宽带用户，比如 普通E家套餐。2、 可以实现针对选中宽带用户安装必选的软件。3、 可以实现针对选中宽带用户安装可选的软件。4、 可以实现针对选中宽带用户新增长安装软件，形式也为可选。注：软件名称描述不超过24个中文或者不超过48个的英文字符；3.2.2编辑工具使用说明1、添加套餐类型：“套餐设立”目的是为某一类套餐用户设立一种安装软件的组合。例如为尊享用户提供尊享的杀毒软件和视讯客户端如下图所示：在用户套餐选项卡里面，在套餐管理主树上点击鼠标右键，在弹出菜单选择添加新套餐选项，在新添加的套餐名字上面点击鼠标左键编辑套餐名称，如下图所示：输入新套餐名称，如下图所示：2、为套餐添加要安装的软件注：每种用户套餐分别有必选安装软件、可选安装软件、新增安装软件（在整合安装过程中体现形态也为可选）节点。在必选、可选节点添加的安装软件必须是通过整合安装软件安装适配的软件，在新增安装软件节点下只能添加符合第5章节“新增软件安装流程约束”规范的软件。在某个用户套餐下的必选安装软件或者可选安装软件或者“新增安装软件”相应的树上点击鼠标右键，如下图所示：在弹出菜单上选择 添加软件安装项，弹出如下土所示的窗体：可安装的软件必须在“Resources”文献夹内，并且“Resources”和编辑工具“CfgTools.exe”在同一个文献夹内（比如：在“中国电线宽带整合安装”文献夹内）。在满足该条件的基础上才可以在这里显示并且可以选择想要安装的软件。“Resources”文献夹内的所有安装包必须是已经做过安装适配或者符合第5章节“新增软件安装过程约束”规范的软件安装包，在整合安装软件中实现了整合安装适配的软件，或者安装包符合第4节“新增软件安装过程约束”的规范（符合该规范的安装包，不必实现整合安装的适配）。注：未通过整合安装适配的软件，且符合第5节“新增软件安装过程约束”规范的必须添加到“新增安装软件节点内”。选中添加好的软件，在界面的右侧上面输入软件的描述（软件描述不超过48个字符或者24个汉字）、软件版本号。如下图所示：假如是增长“新增安装软件”，选择增长好的软件，右侧的支持静默安装复选框会变的可用，选择了该复选框标示该软件支持静默安装，安装过程会自动选择静默安装模式。如下图所示：配置文献编辑完毕后，点击保存配置来保存编辑的配置信息。3.3添加天翼live好友配置中国电信宽带整合安装软件添加天翼live好友功能，是通过读取该配置文献的信息调用天翼live后台添加好友接口实现，假如要顺利完毕该功能需要对的配置该配置文献。3.3.1配置文献格式配置文献名称fread.ini，配置文献格式如下描述：OPTIONSCOUNT=4FRIEND1GroupName=售后服务Nickname=老杨MailAdds=TelephoneNum=FRIEND2GroupName=售后服务Nickname=老张MailAdds=TelephoneNum=FRIEND3GroupName=客户代表Nickname=老曹MailAdds=TelephoneNum=FRIEND4GroupName=客户代表Nickname=老吴MailAdds=TelephoneNum=3.3.2编辑工具使用说明建议规定将客户代表的通行证加为用户的好友。选择天翼Live添加好友选项卡，然后在 天翼Live好友树上点击右键，如下图所示：选择添加新组（整合安装软件在帮助用户添加天翼Live好友时自动创建好友组）。如下图：修改组名，如下图所示：在新添加的组名上点击鼠标右键选择添加好友，如下图所示：选择一个添加的好友，在界面右上侧为该好友添加右键地址、昵称、联系电话信息。编辑完毕后点击保存配置来保存配置信息。3.4上报安装记录及修正渠道信息确认整合安装软件上报安装记录时，也许由于网络因素导致上报失败。这个情况可以使用配置工具手动确认。在Vista/Win7系统请以管理员权限运营编辑工具，选择上报安装记录确认，如下图：假如在安装过程中上报安装记录失败，该页面的“上报安装记录”按钮为可用，点击按钮“上报安装记录”按钮在此上传记录；假如该按钮为不可用，表达在安装过程中上传安装记录已经成功，如下图所示：注：操作该功能时，编辑工具必须在整合安装包内，由于这个功能和其他文献有关联。整合安装在只用天翼宽带拨号成功后会调用安装员渠道信息修正接口：ActReportFix.exe，调用完毕后将在系统目录下 “system32”下的AutoSetup.ini文献记录上报状态，如下图所示：失败的记录信息 ，或者不记录信息；成功的记录信息。所以在整合安装完毕后建议运营CfgTools.exe来确认是否已经修正安装员渠道信息，假如没有被修正将有可用按钮“修正安装员渠道信息”，手动点击该按钮将再次尝试修正。假如修正成功将出现不可用按钮“已修正安装员渠道信息”，如下图所示：4刻录光盘或使用U盘第2、3章节的准备工作完毕后，各省可开始刻录光盘或发放U盘的工作。集团为各省提供软件的原始版本，各省管理员应修改集团提供的软件配置，配置好本省代码、城市代码，然后为各地市刻录运营光盘或者拷贝到U盘。假如使用U盘，为防止病毒传播，请按照U盘操作规范使用：1、 将格式化好的U盘插入一台安全的电脑上将整合安装软件拷贝到U盘上，并针对具体的装维人员的信息做好配置。2、 拔出U盘将U盘上锁为不可写状态。3、 保证在不能拟定是安全的电脑上使用U盘时为锁定状态。4、 需要更新时解除U盘锁定，插入安全的电脑环境更新版本，拔出U盘，然后在此锁定为不可写状态。5新增软件安装流程约束满足该规范的、并且在整合安装软件发布时没有做过安装适配的软件安装包，编辑config.ini文献时必须添加到“新增软件安装”节点下。5.1安装包必须支持的参数安装包必须支持指定安装目录参数: xxxsetup.exe /D=安装途径。5.2非静默安装过程约束建议软件安装包支持静默安装(支持/S参数)，同时支持指定安装目录参数（/D=安装途径）以迅雷的安装过程的窗口为例（迅雷的实际安装过程的环节要更多），对包含软件的安装流程约束如下：第一步：启动安装：上图的Title是“安装迅雷”，窗口描述关键字是欢迎使用。我们的约束是这样，规定在原有的Title的结尾增长“Auto Setup”(注：中文的“”)，例如：安装迅雷Auto Setup，这条合用于每个过程的窗口（即安装过程中的每个窗口的Title结尾均增长“Auto Setup”）；描述信息的关键字就是 “欢迎使用”；该页有两个按钮：下一步按钮、取消按钮，并且下一步按钮的快捷键是 (N)；同时该窗口的按钮焦点在下一步按钮上。第二步：下一步页面Title约束同第一步，窗口描述关键字为 “许可协议”。该窗口默认选中 批准协议；三个按钮：上一步按钮、下一步按钮、取消按钮；同时上一步按钮和下一步按钮支持快捷键，上一步按钮快捷键为 (B),下一步按钮快捷键为 (N)；同时该窗口的按钮焦点在下一步按钮上。第三步：选择安装途径Title约束同第一步，窗口描述关键字为 “选择目的位置”。该窗口有三个按钮：上一步按钮、下一步按钮、取消按钮；同时上一步按钮和下一步按钮支持快捷键，上一步按钮快捷键为 (B),下一步按钮快捷键为 (N)；同时该窗口的按钮焦点在下一步按钮上。第四步：开始安装Title约束同第一步，窗口描述关键字为 “准备安装”。该窗口有三个按钮：上一步按钮、安装按钮、取消按钮；同时上一步和安装按钮支持快捷键，上一步按钮快捷键为 (B),安装按钮快捷键为 (I)；同时该窗口的按钮焦点在按钮上。第五步：开始安装Title约束同第一步，窗口描述关键字为 “正在安装”，其他没有特殊约束。第六步：完毕安装Title约束同第一步，窗口描述关键字为 “安装向导完毕”，该窗口按钮只有一个，就是完毕按钮，完毕按钮支持快捷键 (F)，在该窗口焦点在完毕按钮上。注在该环节假如有查看更新信息、启动软件的可选项时（建议去掉类似选项），必须设立为默认不选中状态。