Beangle Sas Server

Beangle Sas Server 是在Apache Tomcat®基础上增加了一些简单的内容，简化和便利war的运行。

  • 支持轻量级的war包运行(如果内部WEB/lib的包都是maven仓库上可以下载的，这部分包可以省去,不用放在war中)
  • 支持快速创建多个server,而不用复制tomcat

1. 快速安装

1

wget http://beangle.github.io/sas/netinstall.sh; chmod +x ./netinstall.sh;./netinstall.sh

使用0.8.0以上的sas还需要使用root用户执行

# yum install tomcat-native

2. sas目录结构

Beangle Sas Server有特别的目录结构:

|-- bin
|   |-- sas.sh
|   |-- start.sh(启动服务)
|   `-- stop.sh(停止服务)
|-- conf(配置文件)
|-- engines(不同版本的tomcat，无需维护)
|-- servers(这里的内容为server运行产生，无需维护)
|-- logs 产生的日志
`-- webapps(放置war包,尤其是SNAPSHOT版本的)

新的war包放置在webapps.在conf中配置一个server.xml。Beangle SAS server没有采用[Engine]/[Hostname]/Context.xml的方式配置应用，而是新建立一个格式的文件，支持同时管理多个tomcat节点。

3. sas 示例

现有两台web服务器(web1,web2)，一台负载均衡服务器(proxy)的构成系统的拓扑结构。两台web分别各自部署2个应用，其中web1上部署app1,app2,web2上部署app3,app4。 另外有一个应用app_index同时部署在web1,web2上做高可用。

三台服务器

  • proxy(192.168.10.1)
  • web1(192.168.10.2)
  • web2(192.168.10.3)

五个应用，及其要求。

  • app1 部署在web1 (tomcat9/oracle/with jsp)
  • app2 部署在web1 (tomcat9/oracle/)
  • app3 部署在web2 (tomcat10/postgresql/no jsp)
  • app4 部署在web2 (tomcat10/postgresql/no jsp)
  • app_index 部署在web1,web2 (tomcat10/postgresql/no jsp)

例如：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

<?xml version='1.0' encoding='utf-8'?>
<Sas version="0.8.1">
  <!--从这里下载webapp的各类依赖性，如果涉及到没有开源的包，可以改为自己的伺服-->
  <Repository remote="maven.aliyun.com/nexus/content/groups/public"/>
  <Hosts>
    <Host name="web1" ip="192.168.10.1"/>
    <Host name="web2" ip="192.168.10.2"/>
  </Hosts>
  <Engines>
    <Engine name="tomcat9" type="tomcat" version="9.0.35" jspSupport="true">
      <Jar uri="gav://com.oracle:ojdbc6:11.2.0.1.0"/>
    </Engine>
    <Engine name="tomcat10" type="tomcat" version="10.0.20">
      <Jar gav="gav://org.postgresql:postgresql:42.2.6"/>
    </Engine>
  </Engines>

  <Farms>
    <Farm name="farm1" engine="tomcat9" maxHeapSize="2000">
      <Http acceptCount="200"  maxThreads="800"/>
      <ProxyOptions>
        balance roundrobin
        http-response set-header X-XSS-Protection 1;\ mode=block
        http-response set-header X-Frame-Options DENY
        http-response set-header X-Content-Type-Options nosniff
      </ProxyOptions>
      <Server name="server1"  http="8080" host="web1" />
    </Farm>

    <Farm name="farm2" engine="tomcat10" maxHeapSize="2000">
      <Server name="server1" http="8081" host="web2"/>
    </Farm>

    <Farm name="farm3" engine="tomcat10" hosts="," maxHeapSize="500">
      <ProxyOptions>
        balance roundrobin
        cookie SERVERID insert indirect nocache
      </ProxyOptions>
      <Server name="server1"  http="9080" host="web1" proxyOptions="check cookie s1"/>
      <Server name="server2"  http="9081" host="web1" proxyOptions="check cookie s2"/>
      <Server name="server3"  http="9080" host="web2" proxyOptions="check cookie s3"/>
      <Server name="server4"  http="9081" host="web2" proxyOptions="check cookie s4"/>
    </Farm>
  </Farms>

  <Webapps>
    <!--gav 是group-artifact-version的缩写，表示该组件在maven仓库的信息-->
    <!--maven仓库上没有的war包，可以省去该属性，转而写成docBase="${sas.home}/webapps/app1.war"-->
    <Webapp name="app1"  uri="gav://org.group:group-app1:0.x.x" runAt="group1" path="/app1" />
    <Webapp name="app2"  uri="gav://org.group:group-app2:0.x.x" runAt="group1" path="/app2"/>
    <Webapp name="app3"  uri="gav://org.group:group-app3:0.x.x" runAt="farm2" path="/app3"/>
    <Webapp name="app4"  uri="gav://org.group:group-app4:0.x.x" runAt="farm2" path="/app4"/>

    <Webapp name="app_index" uri="gav://org.group:group-app_index:0.x.x"/>
  </Webapps>

  <!--配置代理-->
  <Proxy engine="haproxy" hostname="your.domain.name">
    <!--启用https-->
    <Https/>
  </Proxy>
</Sas>

3. sas 日常使用

sas安装完成后，只需要更改server.xml文件即可。

3.1 解析war

在日常war包版本号更新后，需要完成war包下载，以及解析轻量级war包的依赖，然后再运行。通常这个操作依赖于网络带宽，长时间停止服务可能影响生产环境。 可以先解析war包，然后再重启服务。

$ bin/sas.sh resolve

解析过程中sas会下载war包，如果发现war有声明的依赖项，也会下载。下载目录为maven的本地仓库 ~/.m2/repository。除此之外还会下载jar/war对应的sha1摘要信息。 一旦发现sha1信息和jar包不符，将会删除jar和sha1。

3.2 生成代理配置

不论是采用haproxy抑或是enginx,都可以在server.xml中声明后，采用如下命令生成:

$ bin/sas.sh proxy

该命令会在conf目录下生成haproxy.cfg或者enginx.conf文件。

注意:该文件需要使用root账户拷贝到haproxy的对应目录下，然后重启haproxy方能生效。

3.3 查看状态和起停服务

查看sas接管的服务可以通过

$ bin/sas.sh status

查看哪些服务是启动的，以及版本号。

如果启动单个服务采用bin/start.sh {farm_name}.{server_name}的形式,取前面的farm3上的server1为例，启动命令如下：

$ bin/start.sh farm3.server1

启动farm3所有服务

$ bin/start.sh farm3

停止单个服务

$ bin/stop.sh farm3.server1

重启所有服务

$ bin/stop.sh all
$ bin/start.sh all

3.4 查看日志

查看日志farm3.server1

$ tail -f logs/farm3.server1/console.out

每次启动启动farm3.server1,都会创建一个新的console.out。历史日志在logs/archive下可以找到。

3.5 更新tomcat

当tomcat有了新版本时，可以通过修改server.xml中的其引擎version属性,之后重启应用直接更新

1
2

<Engine name="tomcat80" type="tomcat" version="9.0.30">
</Engine>

4 更新sas

0.3.x 支持tomcat 8.0到8.5之间的版本，0.4.x之后支持tomcat9.0以上系列的版本.0.8.1之后的版本支持tomcat 10 发现新版本的sas后，需要执行更新命令：

$ bin/sas.sh update new_version

然后更改conf/server.xml中的<Sas version="old_version">节点中的version,将其改为new_version