1. tomcat安装

1.1 版本要求

  • apache-tomcat-9.0.xx
  • apache-tomcat-8.0.xx
  • apache-tomcat-8.5.xx

说明：要apache-tomcat-8及以上版本。

1.2 安装方法

  • 解压平台软件包

    1. 将平台软件包解压到某个目录下即可（如D:\publish），目录下会有两个子目录，分别为web和server目录：<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/225456/1622721673201-c21cfe5d-e55c-4283-9004-149ebdf5edc1.png#align=left&display=inline&height=97&margin=%5Bobject%20Object%5D&name=image.png&originHeight=129&originWidth=1123&size=10116&status=done&style=none&width=842)

  • 修改平台配置文件

    修改【平台软件解压目录】下\web\WEB-INF\classes\application.yml 文件，配置平台软件【server】目录所在磁盘路径：

    ```json

platform: server: home: D:\publish\server


- 解压tomcat软件包

      将tomcat软件包解压到某个目录。

- 修改tomcat配置文件

修改 TOMCAT_HOME/con/server.xml配置文件，如在文件中加入以下参数：
```xml
<Context path="/" docBase="D:\publish\web"  reloadable="false"/>

参数说明：

  • docBase： 应用程序的路径或者是WAR文件存放的路径 ，这里配置到 平台软件包目录“D:\publish\web”
  • path ：表示此web应用程序的url的前缀，这样请求的url为http://localhost:8080/path/****
  • reloadable ：如果这个属性设为true，tomcat服务器在运行状态下会监视在WEB-INF/classes和WEB-INF/lib目录下class文件的改动，如果监测到有class文件被更新的，服务器会自动重新加载Web应用，但这样用加重服务器运行负荷，建议在Web应用的生产运行阶段将reloadable设为false。
  • 修改后TOMCAT_HOME/conf/server.xml 文件内容：

image.png

1.3 JVM配置

  • 内存相关参数
    -Xms的值配置为512m
    -Xmx的值配置为4096m-10240m
    -XX:PermSize的值配置为192m
    -XX:MaxPermSize的值配置为1024m
  • 配置文档路径
    windows配置文件：{CATALINA_HOME}\bin\catalina.bat
    linux配置文件：{CATALINA_HOME}\bin\catalina.sh

  • windows示例：

    set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx8192m -XX:PermSize=64m -XX:MaxPermSize=1024m

  • linux示例：

    JAVA_OPTS=’-Xms128m -Xmx8192m -XX:PermSize=64m -XX:MaxPermSize=1024m’

1.4 启动tomcat


平台开始启动，控制台日志如下，说明启动成功：

image.png

1.5 首次启动配置

平台启动成功后，打开浏览器（推荐Chrome），在地址栏输入：http://localhost:8080//install/init （具体网址视安装环境而定），进入平台初始配置界面： 首先对系统进行数据源配置，详细操作过程参考上一节【单机部署及配置（Jar包方式）】中的【2.3 首次启动初始配置】相关说明。

1.6 安装问题解决办法

  1. 启动过程中，报无法装载打包租户异常，导致dev没有加载成功 ``` [main 2021-06-04 08:44:57.385][ERROR]PackedTenantLoaderX.java(105) 装载打包租户 file:/D:/publish/server/lib/PACK-CPLT.jar!/1549c4d9e50a4878 错误: com.mw.cp.CheetahException: java.io.IOException: 系统找不到指定的路径。
     at com.mw.cp.impl.PackedTenantDeployer.getPackedFile(PackedTenantDeployer.java:412)
 at com.mw.cp.impl.PackedTenantDeployer.beforeTenantConstruct(PackedTenantDeployer.java:102)
 at com.mw.cp.impl.PackedPlatformTenant.construct(PackedPlatformTenant.java:52)
 at com.mw.cp.impl.PackedPlatformTenant.<init>(PackedPlatformTenant.java:39)
 at com.mw.cp.impl.PackedTenantLoaderX.load(PackedTenantLoaderX.java:97)
 at com.mw.cp.impl.PlatformManagerImpl.Start.loadPackedTenant(Start.java:239)
 at com.mw.cp.impl.PlatformManagerImpl.Start.loadTenants(Start.java:63)
 at com.mw.cp.impl.PlatformManagerImpl.Start.doStart(Start.java:49)
 at com.mw.cp.impl.PlatformManagerImpl.Start$StartExecution.invoke(Start.java:267)

……… at org.apache.catalina.core.StandardServer.startInternal(StandardServer.java:930) at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:183) at org.apache.catalina.startup.Catalina.start(Catalina.java:772) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) at java.lang.reflect.Method.invoke(Method.java:498) at org.apache.catalina.startup.Bootstrap.start(Bootstrap.java:342) at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:473) Caused by: java.io.IOException: 系统找不到指定的路径。 at java.io.WinNTFileSystem.createFileExclusively(Native Method) at java.io.File.createNewFile(File.java:1012) at com.mw.cp.impl.PackedTenantDeployer.getPackedFile(PackedTenantDeployer.java:399) … 165 more

```

  • 解决办法:
    • 在tomcat 目录下手动创建temp目录即可