help_outline

部署

print
  1. 部署

    开发完成后,部署人员需要从 Pittypat 中输出完整的 VS 解决方案或者 Maven 工程,并使用 VS 或 Maven IDE 编译和生成相应的文件,随后部署到生产环境中。

    1. Java

      Java 中部署主要是指在 Tomcat、Jetty 等容器或服务器中部署。主要步骤包括:

      1. 环境

        在 Java 中部署,需要如下的基础环境:

        1. Java 环境

          Pittypat 所使用的基础 Java 最低版本为 8,JDK 1.8+

        2. Web Server

          Tomcat、Jetty 等支持 JSR-356 WebSocket 接口的服务器。

        3. 数据库

          MySQL 最低版本为 5.6,SQL SERVER 最低版本为 2008,ORACLE 最低版本为 11g。

      2. 安装 Java

        下载并安装 Java 8+,配置环境变量 JAVA_HOME

      3. 安装 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
        
      4. 安装 Tomcat

        下载并安装 Tomcat,建议版本为 8.0.x+。

        在 Windows 中建议使用 MSI 安装包执行安装和初始化。

      5. 安装数据库

        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(英文)。

      6. 安装 webapp

        如果发布包是 .war 文件,则可能需要解压缩,因为可能需要对配置文件(web.xml、pittypat.xml 和 log4j2.xml)进行调整。

        当站点没有位于根路径下时,前端需要正确地设置 appPath,详细请参见 $$.web.setAppPath()。后端需要在 web.xml 文件中配置 appPath。

      7. 执行 SQL

        Pittypat 生成的代码总是使用双引号 " 来引用数据库对象标识符,这是因为双引号是 ANSI 标准,大部分数据库都支持这种引用方式。当在不同数据库之间迁移时,能够降低代码的修改量。由于不是所有的数据库默认都会支持双引号的方式,因此在执行 SQL 之前,需要首先确保双引号选项已经打开。比如在 MySQL 数据库中,需要在 MySQL 的配置文件(Windows 系统中可能位于系统盘的 ProgramData 目录下)中将 sql-modesql_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 文件执行顺序执行。

      8. 配置

        请参见 配置

      9. 初始化

        在首次执行之前,除了需要配置 web.xml 中的 SystemDbUrl 数据库连接字符串,如果使用 waln_authority 等基础应用,还需要配置这些应用的连接字符串。在 MySQL Workbench 中打开 waln_sas 数据库,执行:SELECT * FROM waln_sas.configattributes where "Type" = 1 and "Name" = 'dataServiceUrl'; 为相应的应用修改数据库连接字符串。

        如果使用了 waln_authority,那么打开浏览器进入系统首页,点击登录,使用用户名 admin 和密码 999999 登录系统,配置组织、创建用户帐号、设置用户权限以及调整应用的先后显示顺序。详细请参见联机帮助手册。

    2. 请参见