部署环境概述

1.操作系统

本手册是针对基于银河麒麟V10 SP3 ARM64架构安装活字格服务器的说明文档。以下是本手册适用环境，内存和硬盘为最小配置要求，实际需求以应用服务器承载的具体功能及非功能指标为准。

运行环境	软硬件类型	名称	用途
服务器环境	操作系统	银河麒麟V10 SP3	提供系统环境
	CPU	ARM64	提供硬件环境
	内存	8GB
	硬盘	100G

2.Dotnet

dotnet-sdk-6.0.424-linux-arm64.tar.gz

微软官方下载地址

3.活字格服务器 V10 ARM

从葡萄城官方客服处获取：

huozige-installer-linux-arm.tar

安装 dotnet 6

1.解压 dotnet6 安装包

# 安装目录以 /home/hzg-server/dotnet 为例
# 创建dotnet目录
mkdir -p /home/hzg-server/dotnet
# 把安装包移动到dotnet目录
mv ./dotnet-sdk-6.0.424-linux-arm64.tar.gz/home/hzg-server/dotnet
# 解压即安装
tar xfdotnet-sdk-6.0.424-linux-arm64.tar.gz

2.配置环境变量（可选）

vim /etc/profile
# 在profile内容最下方添加以下内容：
export DOTNET_ROOT=/home/hzg-server/dotnet
export PATH=$PATH:/home/hzg-server/dotnet
# 保存后退出，执行 source 命令让环境变量生效
source /etc/profile
# 查看dotnet命令是否生效
dotnet --version

配置成功后如下图所示：

安装活字格服务器

1.解压活字格服务器包

# 安装目录以 /home/hzg-server/huozige为例
# 创建huozige目录
mkdir -p /home/hzg-server/huozige
# 把安装包移动到huozige目录
mv ./huozige-installer-linux-arm.tar /home/hzg-server/huozige
# 解压活字格服务器安装包
tar xf huozige-installer-linux-arm.tar
# 解压完成后，查看解压结果
ls -l

2.执行活字格服务器安装脚本

# 进入活字格目录
cd/home/hzg-server/huozige
# 执行安装脚本
bashinstallForguncy_cn.sh
# 遇到提示（红字）：This OS is ARM64 based, Will skip .Net6 installation... 后输入 dotnet 执行文件的目录
# 注意，这里输入的是 dotnet 执行文件路径，执行文件如下图1
/home/hzg/dotnet/dotnet
# 输入完成后回车，等待安装完成。效果如下图2

图1

图2

安装influxdb2（基于活字格 v10.0.100.0）

1.下载完整的 influxdb 源

按活字格服务器需求，要正常运行日志模块，需要依赖以下三个包：

1. influxdb2-2.7.1-linux-arm64.tar.gz
2. influxdb2-client-2.7.1_linux_arm64.tar.gz
3. telegraf-1.28.2_linux_arm64.tar.gz

超链接为活字格官方提供的下载地址，点击即可下载到本地

2.解压到待拷贝目录

# 更改包名
mv influxdb2-2.7.1-linux-arm64.tar.gz influxdb.tar.gz
mv influxdb2-client-2.7.1_linux_arm64.tar.gz influxcli.tar.gz
mv telegraf-1.28.2_linux_arm64.tar.gz telegraf.tar.gz
# 创建临时目录
mkdir -p /tmp/Forguncy/InfluxDB
# 解压
tar -C /tmp/Forguncy/InfluxDB -zxvf /tmp/influxdb.tar.gz
tar -C /tmp/Forguncy/InfluxDB -zxvf /tmp/influxcli.tar.gz
tar -C /tmp/Forguncy/InfluxDB -zxvf /tmp/telegraf.tar.gz

3.将可执行文件拷贝至活字格服务器

# 拷贝 influxdb 主程序
mv /tmp/Forguncy/InfluxDB/influxdb2_linux_arm64/influxd /opt/ForguncyServer/WebSite/influxDbServerBin/influxd
# 清理临时文件夹 influxdb 主程序
rm -rf /tmp/Forguncy/InfluxDB/influxdb2_linux_arm64
# 拷贝 influxdb 客户端程序
mv /tmp/Forguncy/InfluxDB/influx /opt/ForguncyServer/WebSite/influxDbServerBin//influx
# 清理临时文件夹对应文件
rm /tmp/Forguncy/InfluxDB/README.md
rm /tmp/Forguncy/InfluxDB/LICENSE
# 拷贝 telegraf 主程序
mv /tmp/Forguncy/InfluxDB/telegraf-1.28.2/usr/bin/telegraf /opt/ForguncyServer/WebSite/influxDbServerBin//telegraf
# 清理临时文件夹 telegraf 程序
rm -rf /tmp/Forguncy/InfluxDB/telegraf-1.28.2

更新文件权限

chown root:root /opt/ForguncyServer/WebSite/influxDbServerBin/filebeat.yml
chown root:root /opt/ForguncyServer/WebSite/influxDbServerBin/metricbeat.yml
chmod 600 /opt/ForguncyServer/WebSite/influxDbServerBin/filebeat.yml
chmod 600 /opt/ForguncyServer/WebSite/influxDbServerBin/metricbeat.yml
chmod -R 755 /opt/ForguncyServer/WebSite/influxDbServerBin/influxd
chmod -R 755 /opt/ForguncyServer/WebSite/influxDbServerBin/influx
chmod -R 755 /opt/ForguncyServer/WebSite/influxDbServerBin/telegraf
# 重启活字格服务器后生效
systemctl restart ForguncyServerService

清理安装包（可选）

rm /tmp/influxdb.tar.gz
rm /tmp/influxcli.tar.gz
rm /tmp/telegraf.tar.gz
rm -rf /tmp/Forguncy/InfluxDB

本地防火墙放行端口

1.查看本地防火墙运行状态

systemctl status firewalld

2.添加22345端口权限

firewall-cmd --add-port=22345/tcp --permanent

3.重启防火墙进程

# 重启防火墙使修改生效
systemctl restart firewalld
# 查看是否生效（出现下图红框内容即为生效）
systemctl status firewalld

登录活字格服务器

1.查看活字格服务器运行状态

service ForguncyServerService status

2.访问活字格服务器地址

# 浏览器地址栏输入（IP为科研项目生产环境服务器地址）：
http://10.27.15.10:22345/UserService/AdminPortal/login

3.登录活字格服务器

# 默认用户名：Administrator
# 默认密码：123456

给服务器安装字体（可选）

将应用发布到Linux系统后，如果Linux系统中没有安装字体，那么导出应用中的页面/表格/数据透视表等到Excel/PD F中时，会出现乱码。

1.查看服务器字体目录

cd/usr/share/fonts
ls -l

下图是银河麒麟V10版本所有自带的字体

创建中文字体目录

mkdir /usr/share/fonts/truetype/cn -p
mkdir/opt/ForguncyServer/Fonts-p

安装字体包

#用 ftp 上传字体文件至：/opt/ForguncyServer/Fonts/
# 复制到/usr/share/fonts/truetype/cn
cp -r /opt/ForguncyServer/Fonts/* /usr/share/fonts/truetype/cn
# 修改访问权限
chmod 755 /usr/share/fonts/truetype/cn -R
# 刷新字体库
fc-cache -f -v
#如果未找到fc-cache，请安装fontconfig
yum install fontconfig

怎样获取字体包

方法一：可以从 Windows 中拷贝出来打包上传。

方法二：到网络上搜索下载，注意版权问题。

服务器激活

离线激活服务器

由于生产环境与公网隔离，因此需要采用离线激活的方式来激活活字格服务器。激活的具体操作步骤如下：

1. 登录到活字格管理控制台。输入用户账户管理的用户名和密码，进入活字格管理控制台。

默认用户名为：Administrator，密码：123456。

1. 选择“帮助支持->许可列表”，进入“许可列表”页面。
2. 单击“基本服务器许可”下的“增加许可”。在弹出的“注册服务器激活码”窗口中输入激活码并单击“注册”。

1. 连接激活服务器失败时，会弹出对话框，提示您连接失败，单击“离线激活”。

1. 在弹出的离线激活对话框中，将文本框中的生成码发给葡萄城活字格售后服务，或发送给项目承包商联系人，也可以通过扫码右侧的二维码来提取生成码。
2. 葡萄城活字格售后服务会使用生成码来生成激活码，请将售后服务提供的激活码输入到第二个文本框也就是激活码的文本框中。
3. 单击“离线激活”按钮，就会离线激活成功。

1. 增加许可后，在许可信息的列表中可以看到增加的产品授权码、过期日期、模块授权及用户授权。

激活表格报表插件

科研管理项目中使用了葡萄城官方的付费插件【表格报表组件】，这个组件需要激活后才能争取部署。激活方式如下：

1. 获取激活插件

由采购方到葡萄城市场，登录联系人账号后，可下载激活后的表格报表插件

1. 更新设计器插件

将激活插件安装到开发环境的设计器中，即可将激活的插件发布到服务器。

附录

说明：本手册默认以 root 用户执行，非 root 用户请自行添加 sudo.

参考文档：安装活字格服务端到 Linux 系统

常见问题

忘记 Administrator 密码的处理办法：

方法一：简单版本（全库初始化）：

进入 /opt/ForguncyServer/Forguncy.UserService2/App_Data/v5 目录，

把 sqlite 文件：UserServiceDB.sqlite3 替换成刚安装的初始化状态的库就行

方法二：复杂版本（只修改Administrator密码）：

(1) 进入 /opt/ForguncyServer/Forguncy.UserService2/App_Data/v5 目录，

(2) 下载 UserServiceDB.sqlite3 到本地，用数据库预览软件（如 Beekeeper Studio 等）打开

(3) 打开 webpages_Membership 表，修改对应用户的密码即可

(4) 把修改过的 UserServiceDB.sqlite3 文件上传到原路径，覆盖文件，不用重启服务，可立即生效

写在最后

非常感谢葡萄城的活字格技术顾问在我们项目的实施期间提供了及时、专业的技术支持，为项目顺利交付提供了极大的帮助，同时在葡萄城社区（GCDN）中我们也获得了非常多的帮助，最后希望越来越多的朋友们加入葡萄城活字格低代码大家庭，一起沟通和交流有关于活字格产品的相关信息。