快速入门

# 前言

​ 本快速入门指南主要介绍金蝶Apusic应用服务器V10（简称“AAS-V10”）安装、配置等，提供了启动/停止服务器、部署/卸载应用程序、配置数据源等基本过程，适用于使用金蝶Apusic应用服务器进行开发的开发人员、生产环境的系统管理员、运维人员等。

# 适用对象

​ 本手册主要面向对象为使用金蝶 Apusic 应用服务器进行应用开发的开发人员，以及相关管理人员和运维人员。

# 相关文档

了解更多AAS-V10产品相关的信息，请参阅以下AAS-V10产品手册文档集：

序号手册文档说明
1金蝶Apusic应用服务器V10安装手册详细介绍如何在各操作系统上安装AAS，以及AAS服务启停操作，产品的注册过程
2金蝶Apusic应用服务器V10快速入门简单介绍了如何快速上手使用AAS
3金蝶Apusic应用服务器V10用户手册详细介绍AAS相关功能的使用和操作说明，指导用户对系统进行安装部署、功能操作、参数配置、日常运维及问题自查
4金蝶Apusic应用服务器V10性能调优文档指导分析、定位性能问题，提供调优数据参考
5金蝶Apusic应用服务器V10功能清单简述产品功能项
6金蝶Apusic应用服务器V10版本兼容矩阵介绍产品上下游兼容情况

# 技术支持

金蝶 Apusic 应用服务器产品提供全面的技术支持服务，您可以通过以下方式获得技术支持：

  • 网址：www.apusic.com
  • 电话：400-855-5800
  • 邮箱：support@apusic.com
  • 金蝶云社区：https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN

您在取得技术支持时，请提供如下信息：

  1. 您的姓名
  2. 公司信息与联系方式
  3. 操作系统及其版本
  4. 产品版本号
  5. 出现异常及错误的日志、截图等详细信息

# 基础介绍

金蝶Apusic应用服务器为复杂应用提供了一个简便、快速的开发和运行平台，对于分布式的企业级应用，提供了易扩展、可伸缩和高安全性等特性。

默认自带了一个本地实例server,可以创建远程节点，一个节点相当于一个AAS，实例运行在节点上。

V10支持资源的统一管理，如应用资源、数据库资源等，可以用作统一升级操作。

# 术语

  1. Apusic 应用服务器

服务器是应用服务器的物理部署单元。直观的来说，是应用服务器在一台用户机器上的一个物理安装。

  1. 域（domain）

域是指作为一个单元来管理的并相互关联的一组服务器资源。一个域可以包含一个或多个独立服务器，还可包含服务器集群，它们共享一套公用配置，并使用扩展标记语言 XML 定义，配置文件名为 domain.xml，存放在 DOMAIN_HOME/config/ 目录中。域是一个完整的管理单元，当向域里部署应用时，该应用只能部署到域之内的服务器上。如果域中包含集群，那么集群中的所有服务器都必须属于同一个域。

通过域，部署在不同物理位置上的服务器实例，可以共享一套公用配置，同时，可以在一个节点上统一管理多个服务器实例，这使得应用服务器的部署和管理变得简单和灵活。

  1. 服务器实例（instance）

一个服务器实例是 Java 平台上（Java 虚拟机或 JVM 机器）的单个虚拟机，它运行在服务器的单个节点上。服务器实例构成了应用部署的基础。实例是构建集群、负载均衡和服务器会话持久性中的重要构件。每个实例只属于一个域并且有自己的目录结构、配置和部署的应用。每个实例包含了一个到节点的引用。

  1. 节点（node）

每个节点对应一台装有应用服务器软件的主机，应用服务器实例所在的主机上必须存在一个对应的节点。节点配置信息包含主机名称，以及应用服务器安装在主机上的位置。

  1. 服务器集群（cluster）

服务器集群是多个服务器实例的一个逻辑实体的集合，它们共享相同的应用程序、资源以及配置信息。不管服务器实例是在同一台主机或不同的主机上，应用服务器都可以在管理控制中心上将集群中的所有实例作为一个单元进行管理。

# 默认管理值

名称 默认值
域名 mydomain
asadmin命令行实用程序 APUSIC_HOME/bin
配置文件 DOMAIN_HOME/config
日志文件 DOMAIN_HOME/logs

# 默认模块端口

功能模块 端口
管控端口 6848
HTTP 端口 6888
HTTP SSL端口 6887
IIOP SSL端口 6838
IIOP MUTUALAUTH端口 6839
JMS 端口 6876
IIOP端口 6837
JMX 端口 6886
OSGI SHELL 端口 6866
JAVA DEBUGGER端口 8000

# 快速安装与启停

# 安装前准备

需要服务器上提前安装并设置好java运行环境，由于远程访问需开启安全管理，jdk需要是1.8.0_201及以上的版本。

# 许可证授权

AAS需要有对应的许可证才能正常使用，通常情况下，金蝶天燕会根据用户购买的产品版本配套对应的许可证。

许可证位置为${APUSIC_HOME}/license.xml。

如果在使用过程中出现许可证过期或无效等问题，建议优先联系对接的天燕服务人员，重新申请对应许可证。重新申请对应许可证时，需要将产品的特征码(auth code)提供到天燕对接人员。

如果是节点出现授权问题，可查看日志，日志会打印出对应的特征码(auth code)，拷贝特征码(auth code)提供至天燕对接人员重新申请对应许可证。

# 开始安装

根据获取的安装包打包形式进行安装，常用的打包形式为.zip或.tar.gz。

Windows下安装：直接解压安装包，如 AAS-V10.0.zip 。 Linux下安装：执行命令，如unzip AAS-V10.0.zip，解压安装包完成安装。

# 启动默认域

在 ${APUSIC_HOME}/bin路径下执行 asadmin start-domain 。 如果存在多个域，则需要输入域的名称，如 asadmin start-domain mydomain 。

注：首次启动需要设置默认管理员的密码，登录管控平台时需要使用设置的密码登录。

# 停止默认域

在 ${APUSIC_HOME}/bin下执行 asadmin stop-domain 。 如果存在多个域，则需要输入域的名称，如 asadmin stop-domain mydomain 。

# 卸载

1、删除安装目录：

删除安装目录${APUSIC_HOME}/下所有文件即可完成卸载操作。

2、执行卸载脚本：

如果是图形安装，可执行uninstall脚本，完成卸载。

注：卸载之前需要停止运行AAS。

# 管控基础使用介绍

# 访问

安装并启动后，浏览器访问：https://ip:6848

# 基础角色

​ AAS V10.0管控功能升级，将集群管理控制台、安全管理控制台、通用管理控制台合并。 支持三员分立功能，默认三种角色以及用户： 1）系统管理员(sysadmin): admin。主要负责用户创建及管理、日常系统维护设置，资源以及集群管理等工作。 2）安全保密员（security）: secure。主要负责系统的日常安全保密管理工作。 3）审计员（auditor）: audit。主要负责对系统管理员、安全管理员的操作行为进行审计跟踪分析和监督检查。

# 基础功能

支持部署并管理应用程序。

支持创建并管理数据源。

支持服务器集群统一配置管理、负载均衡器的管理、缓存集群的管理、负载均衡器集群的管理。

支持用户管理，资源以及常用普通配置管理。

# 应用部署与访问

# 部署应用

1、管控上部署应用程序：指定应用部署目标，可以同时部署到多个实例和集群上。

2、命令方式部署：asadmin deploy war-dir ，可以通过--target指定目标 war-dir 为应用文件所在路径 3、将应用程序拷贝到${DOMAIN_HOME}/autodeploy目录下即可进行部署

# 访问应用

​ 在部署了应用程序之后，可以通过浏览器访问应用程序，操作步骤如下： 1、在应用程序列表中的操作列中点击【访问】； 2、在弹出页面中，选择【链接】栏目中任一URL地址均可访问应用。 ​ 注：1）如果部署的文件是文件夹或ear文件，【操作】中没有【访问】按钮，需要在浏览器手动输入访问地址 2）如果部署的应用程序要对接资源，需要先新增资源信息，否则部署应用程序或访问时会出错

# 取消部署应用

​ 系统支持3种方式取消部署应用 1、命令行方式取消部署：在${APUSIC_HOME}/bin路径下执行asadmin undeploy war-name 2、删除应用文件取消部署：删除autodeploy， autodeploy\.autodeploystatus以及applications目录下的应用文件以及部署标识 3、管控上取消部署：可以取消某个实例上的应用部署或者取消应用在所有目录上的部署

# 数据源管理

​ 金蝶Apusic应用服务器数据源遵循JDBC规范，支持多种数据库，不仅支持Oracle、MySQL、DB2、Derby、Sybase、SQL Server、PostgreSQL等主流数据库，还支持达梦、神州通用、人大金仓、高斯、亚信等国产数据库。 ​ 金蝶Apusic应用服务器中JDBC连接池功能用于创建数据库连接，JDBC资源功能将JDBC连接池配置成应用程序可调用的资源。在这里我们以mysql数据库为例，演示数据源的创建管理。

新建JDBC连接池：支持数据库驱动的上传以及复制功能

新建JDBC资源：设置JDBC资源的JNDI名称，绑定某个JDBC连接池

# 主要参数配置

​ 金蝶Apusic应用服务器管控提供常见参数的统一配置，如JVM参数、线程池设置、JDBC连接池、http连接池设置、日志相关参数等设置，可以对集群、服务实例等做统一的配置，配置路径为：【配置管理】->【server-config】（或集群名称）。

编辑页面 (opens new window)

← 安装手册→