hsoa master 主站点安装、部署教程

## 简介
hsoa master 采用 .Net Core开发，理论上支持Windows、Linux部署。但项目组未做Linux下的部署测试，本文以Windows Server 2019部署为例。
本文适合稍有服务器知识的技术人员参考阅读，不适合没有技术背景者使用。
## 前置
操作系统：Windows Server 2019
数据库：Sql Server 2019 （理论上支持Sql Server 2008及上以版本的数据库）

## 安装部署
### 安装IIS
Windows Server 安装IIS有很多教程，本文不再一一赘述，请自行在互联网上查找。此处附上作者查找到的教程： https://jingyan.baidu.com/article/3ea514893e716612e71bba5f.html

### 安装Sql Server 数据库
Sql Server 有很多安装教程，本文不再一一赘述，请自行在互联网上查找。此处附上作者查找到的教程：https://www.cnblogs.com/sgxw/p/13386511.html

### 安装 .Net Core 3.1
1. 打开.Net 下载页： https://dotnet.microsoft.com/en-us/download/dotnet  找到.Net Core 3.1 点击进去。
2. 在.Net Core 3.1 下载页，找到3.1.0版本的Asp.Net Core Runtime 依次找到Windows Installers 版本的Hosting Bundle 和x64 版本，本文对应的URL分别是：
https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-3.1.0-windows-hosting-bundle-installer
和
https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-aspnetcore-3.1.0-windows-x64-installer
。
3. 下载之后，在服务器上双击安装，采用默认部署安装即可。

### 还原数据库文件bak
Sql Server 还原bak文件有很多教程，本文不再一一赘述，请自行在互联网上查找。此处附上作者查找到的教程：
https://jingyan.baidu.com/article/ff42efa9d6d8e5c19f22026f.html
### 配置IIS站点
1. 创建文件夹C:\website\hsoa_master 并将安装包中的文件解压至该文件夹下，解压后的文件结构如下：

![](/media/202202/1_20220215123554934888.png)

2. 打开“Internet Information Services (IIS)管理器”（下称IIS）添加一个应用程序池。名称：根据需要自己命名（本文以hsmaster为例）；.Net CLR版本：选择无托管代码；托管管道模式：选择集成；

3. 用记事本打开 appsettings.json文件（即C:\website\hsoa_master\appsettings.json）将其中的数据库连接字符串修改为你实际的连接字符串

4. 在IIS上添加站点，应用程序池选择上面刚刚新建的hsmaster，配置如下图所示，本文以端口8080为例：

![](/media/202202/2_20220215123315251727.png)

5. 用服务器上的浏览器打开 URL : http://127.0.0.1:8080/api/SaaSSystemBaseInfo/GetSaaSSystemBaseInfo?SystemId=hsoa&CorpIdentity=yixinjie&Secretkey=
如果能看到类似“SystemId、CorpIdentity或者Secretkey不可为空！”的字样，说明 IIS Web站点配置成功。
6. 将上述的127.0.0.1替换成服务器的IP，即：
http://192.168.1.224:8080/api/SaaSSystemBaseInfo/GetSaaSSystemBaseInfo?SystemId=hsoa&CorpIdentity=yixinjie&Secretkey=
在其它电脑的浏览器上打开，如果不能访问，则说明被服务器防火墙屏蔽了，需要配置服务器端防火墙，此处不再赘述。
7. 至此Web站点配置完毕。
8. 还需要配置Sql Server数据库中Companies表和SaaSSystemBaseInfo表中的数据以允许OA站点获得正确的数据库连接字符串。在示例数据库中需要修改SaaSSystemBaseInfo表中ConnectionString和DBParams列的数据。