【新手常见问题】之 —— 安装问题排查

常见安装问题文档

• 360卫士拦截安装
• Windows Server 2012 R2 无法安装Wyn产品
  

       由于宿主机环境的多样性, 在安装 Wyn 的过程中可能会出现一些 "异常问题", 以往在windows 中安装软件如果碰到问题, 可能只能找产品技术团队进行反馈排查, 本帖主要想在总结了现有常见问题的基础上做一些方法归纳, 让大家起码可以了解出现问题时的排查思路以及对应解决方法, 如对本贴内容有所建议,也欢迎跟帖指正。

       顺便提一下基于目前软件业界内的发展趋势,虚拟化技术逐渐成为抹平软件环境差异的公认解决方案, 如果技术层面可以允许的话, 使用docker镜像安装似乎是一种更为稳妥的部署方式。

       在讲到问题处理思路之前, 先做一个问题归纳分类, 主要问题分为安装失败,以及安装后运行失败两个阶段。在分析排查问题时,个人觉得很重要的一个点就是要能正确评估当前问题发生所处的阶段。为了方便搜索查看本贴内容，先行对内容做个总结梗概，可根据自身情况查看。
       一.  安装失败问题
             1. dotnet 环境排查
             2. visual c++ 环境排查
       二.  安装启动失败问题
             1. wyn 服务排查
             2. 占用端口排查
       三.  网络问题排查
       四.  日志



一.  安装失败


      一般安装失败都是由于系统环境导致的, 主要排查 是否正确安装了 dotnet 环境 以及 visual c++ 环境。
      1. 判断 dotnet 环境是否安装成功
         Windows 下 cmd 内运行  dotnet --info 如果有显示对应dotnet 版本号则说明 dotnet 安装成功. 否则也未必没有安装成功, 因为有可能 windows 已经安装好 dotnet 环境, 只是没有将 dotnet 执行文件路径写入到 环境变量中。 可以排查自己 是否存在 C:\Program Files\dotnet , 并在该目录下执行 dotnet.exe --info 查看是否安装成功. 如果运行无误我们就可以将 C:\Program Files\dotnet 该路径添加到系统环境变量的 Path 变量中, 若是不能成功执行该命令, 可以手动安装 dotnet 环境包.
                  
         Linux 下同理执行 dotnet --info 即可判断自己的 dotnet 环境是否安装正确. 不过 linux 中不会出现上一条环境变量的问题, 可以直接根据 dotnet --info 的结果来判断。
         
         dotnet 环境安装问题都可以通过自行安装 ASP.NET运行时环境来解决。
          ASP.NET Core 安装地址
      2. 判断 visual c++ 安装是否正确
         鉴于目前碰到的 visual c++ 环境问题都是出在 Windows Server 2012 R2 服务器上 ,所以visual c++ 的环境问题排查可参考
         Windows Server 2012 R2 无法安装Wyn产品


二.  安装成功启动失败   


         一般来说, wyn 安装成功后会启动两个服务, WynService 和 WynDataBase(安装指定新建内置数据库), 这两个服务都可以在系统管理器上观测到. 安装成功启动失败的问题绝大部分都可以通过这两个服务来解决。

• WynService服务问题
• WynDataBase服务问题
  

       当服务都正常启动,网页却依旧无法访问,此时就需要排查端口占用问题了. 在 cmd 中 运行 netstat -ano|findstr 51980 查看wyn启动端口是否被占用, 查到使用该端口的进程pid之后可以在任务管理器上查询进程详情, 或者 cmd 中使用 tasklist |findstr 进程pid 查看占用情况,如果有占用情况可以考虑杀掉原有进程或者更改 wyn自身的端口配置。
修改wyn门户端口



可以看到正常 wyn 运行时, 占用进程是 一个dotnet 进程.


三. 额外情况

       在软件安装-> 软件运行 之后其实还存在一个阶段,即网络传输阶段, 这个阶段的问题解决不容易但是排查还是很简单的。当我们在 浏览器访问 http://serverip:51908 获取不到页面内容时未必是后台服务问题,有可能只是客户端和服务端之间网络通信问题, 这种情况可以直接再服务端调用 对应 http 请求看是否能正确返回。 windows 服务器环境 可以直接浏览器访问 http://localhost:51980 , linux 服务器可以调用 curl -XGET "http://localhost:51980", 如果服务器端能正常访问,客户端浏览器无法访问, 那就需要排查客户端和服务端之前的网络通信或者防火墙配置了。


四. 日志


     日志是解决所有安装使用问题的最强大的工具, 也是最终解决手段. Wyn 的日志文件位置如下:

• Windows : Wyn安装路径\logs (默认路径 C:\Program Files\Wyn\logs)
• linux : /opt/Wyn/logs
  
  

   可以看到wyn对不同功能区的日志做了划分,一般的程序启动日志位于 system 文件夹下, 程序运行时功能的主要日志位于 server 文件夹下。


日志级别调整 (也可以通过 wyn后台管理->运维管理->节点管理->全局设置->日志级别来调整)
导出系统日志 (将服务器端上述日志文件cp出来也行)

   日志里记录了最完备的系统运行情况,但同样的使用日志来定位问题原因也具备一定的技术门槛,在上述排查方式都无法追踪到问题时,建议最好还是联系官方技术支持。