-
部署
开发完成后,部署人员需要从 Pittypat 中输出完整的 VS 解决方案或者 Maven 工程,并使用 VS 或 Maven IDE 编译和生成相应的文件,随后部署到生产环境中。
-
Java
Java 中部署主要是指在 Tomcat、Jetty 等容器或服务器中部署。主要步骤包括:
-
环境
在 Java 中部署,需要如下的基础环境:
-
Java 环境
Pittypat 所使用的基础 Java 最低版本为 8,JDK 1.8+。
-
Web Server
Tomcat、Jetty 等支持 JSR-356 WebSocket 接口的服务器。
-
数据库
MySQL 最低版本为 5.6,SQL SERVER 最低版本为 2008,ORACLE 最低版本为 11g。
-
-
安装 Java
下载并安装 Java 8+,配置环境变量
JAVA_HOME
。 -
安装 Jetty
下载并解压缩 Jetty 9.3.x+(Windows 中通常为 jetty-distribution-9.3.*.v{YYYYMMDD}.zip),将解压目录配置为环境变量
JETTY_HOME
。从命令行进入
JETTY_HOME
目录,使用如下的命令启动 jetty:java -jar start.jar STOP.PORT={stop port} STOP.KEY={stop key}
从命令行进入
JETTY_HOME
目录,使用如下的命令终止 jetty:java -jar start.jar STOP.PORT={stop port} STOP.KEY={stop key} --stop
其中,
{stop port}
是自定义的端口,{stop key}
是自定义的密钥。在 windows 系统中,可以将以上命令创建为 .bat 文件。比如:start jetty.bat:
cd {JETTY_HOME} java -jar start.jar STOP.PORT={stop port} STOP.KEY={stop key}
stop jetty.bat:
cd {JETTY_HOME} java -jar start.jar STOP.PORT={stop port} STOP.KEY={stop key} --stop
-
安装 Tomcat
下载并安装 Tomcat,建议版本为 8.0.x+。
在 Windows 中建议使用 MSI 安装包执行安装和初始化。
-
安装数据库
MySQL 数据库请使用 MySQL 5.6 或以上版本。建议使用 MySQL MSI 安装包,其中包含了 MySQL Server、Workbench 和 Connector。除了安装 MySQL 服务外,执行 SQL 文件需要 MySQL Workbench 等工具,连接数据库需要 MySQL Connector/Net。
在安装过程中可能需要 Visual C++ Redistributable Packages for Visual Studio 2013 以及 Visual C++ Redistributable for Visual Studio 2015。
在 Windows Server 2008 或 Windows 7 上安装 MySQL 5.6+ 时,应该确保 Windows 系统的 SP1 已经安装,否则 MySQL 服务可能会自动停止或重启,详细请参见:Installing MySQL on Microsoft Windows(英文)。
-
安装 webapp
如果发布包是 .war 文件,则可能需要解压缩,因为可能需要对配置文件(web.xml、pittypat.xml 和 log4j2.xml)进行调整。
当站点没有位于根路径下时,前端需要正确地设置 appPath,详细请参见 $$.web.setAppPath()。后端需要在 web.xml 文件中配置 appPath。
-
执行 SQL
Pittypat 生成的代码总是使用双引号
"
来引用数据库对象标识符,这是因为双引号是 ANSI 标准,大部分数据库都支持这种引用方式。当在不同数据库之间迁移时,能够降低代码的修改量。由于不是所有的数据库默认都会支持双引号的方式,因此在执行 SQL 之前,需要首先确保双引号选项已经打开。比如在 MySQL 数据库中,需要在 MySQL 的配置文件(Windows 系统中可能位于系统盘的 ProgramData 目录下)中将sql-mode
或sql_mode
设置为包含ANSI_QUOTES
。Pittypat 在前端、中间和数据库总是使用 UTF-8(SQL SERVER 不支持该编码,此时中间层会负责自动转换编码),因此在创建数据库和数据库架构时,总是选择使用 UTF-8 编码,并在连接字符串中配置 UTF-8 编码参数。
对于由沃恩提供的基础应用(waln_sas、waln_authority、waln_log等),按如下顺序初始化:
01、waln_sas/1_tables.sql。
02、waln_sas/2_global.sql。
03、waln_authority/1_tables.sql。
04、waln_authority/2_global.sql。
05、waln_log/1_tables.sql。
06、waln_log/2_global.sql。
07、waln_sas 中其他 sql 文件,按前缀数字顺序。
08、waln_authority 中其他 sql 文件,按前缀数字顺序。
09、waln_log 中其他 sql 文件,按前缀数字顺序。
10、waln_files 中的 sql 文件,按前缀数字顺序。
11、waln_calendar 中的 sql 文件,按前缀数字顺序。
12、waln_notifying 中的 sql 文件,按前缀数字顺序。
13、waln_regions 中的 sql 文件,按前缀数字顺序。
14、其他应用,根据开发者设定的 SQL 文件执行顺序执行。
-
配置
请参见 配置。
-
初始化
在首次执行之前,除了需要配置 web.xml 中的 SystemDbUrl 数据库连接字符串,如果使用 waln_authority 等基础应用,还需要配置这些应用的连接字符串。在 MySQL Workbench 中打开 waln_sas 数据库,执行:
SELECT * FROM waln_sas.configattributes where "Type" = 1 and "Name" = 'dataServiceUrl';
为相应的应用修改数据库连接字符串。如果使用了 waln_authority,那么打开浏览器进入系统首页,点击登录,使用用户名
admin
和密码999999
登录系统,配置组织、创建用户帐号、设置用户权限以及调整应用的先后显示顺序。详细请参见联机帮助手册。
-
-
请参见
-