FuseESB Enterprise 系统配置

Fuse ESB Enterprise 使用Felix 实现的OSGi Configuration Admin service来管理OSGi Services;Fuse ESB

Enterprise默认采用键值对方式配置在InstallDir/etc目录下面的.cfg文件中。

1. 系统配置

     etc/system.properties，etc/config.properties

2. JAAS安全

     (1) 配置文件

     InstallDir/etc/users.properties

     (2) JAAS控制台命令

     以jaas:*开头，具体命令那个用法可通过jaas:realms --help 命令查看。

     A. 查看容器中现有的Realm：

     FuseESB:karaf@root> jaas:realms
     Index Realm                Module Class                                                                   
                1 karaf                org.apache.karaf.jaas.modules.properties.PropertiesLoginModule

     B. 修改Standalone Container User Data

     FuseESB:karaf@root> jaas:manage --index 1

     FuseESB:karaf@root> jaas:manage --realm karaf

     C. 添加一个新的用户至JAAS Realm:

     karaf@root> jaas:useradd jdoe secret  #添加用户jdoe，密码secret

     karaf@root> jaas:roleadd jdoe admin   #给用户jdoe添加角色admin

     karaf@root> jaas:pending  # 查看将要添加的内容

     karaf@root> jaas:update  # 让添加的内容生效

     karaf@root> jaas:cancel  # 取消将要添加的内容

3. JMX配置

     配置文件：org.apache.karaf.management.cfg

     针对Standalone容器，默认的JMX用户名和密码是smx/smx ; 针对Fabric容器，默认的JMX用户名和密码是

     admin/admin.

4. JBI组件Thread Pool配置

     (1) 组件配置文件：将下面模式匹配

     etc/org.apache.servicemix.components.ComponentName .cfg

     (2) 可参考：org.apache.servicemix.jbi.cfg，org.apache.servicemix.nmr.cfg

3.  热部署配置

      Fuse ESB Enterprise 默认热部署安装目录下的deploy 文件夹中的组件，也可以通过/etc/org.apache.felix

      .fileinstall- deploy.cfg 配置文件配置其他的热部署目录。

4.  使用config控制台命令

      (1) 列出当前Fuse ESB 内核中所有已经加载的配置：config:list

      (2) 修改一个配置,按照下面顺序执行：

            1. config:edit PID

            2. 显示该PID可用的配置选项：config:proplist

            3. 编辑一个属性：config:propset property value

            4. 将编辑的结果写入配置文件：config:update

            5. 取消本次的编辑结果：config:cancel

5.  日志配置

      Fuse Enterprise ESB默认使用OPS4J Pax Logging 系统，支持一下日志API;

      Apache Log4j, Apache Common Logging,SLF4J, Java Util Logging.

      (1) 配置文件：org.ops4j.pax.logging.cfg，org.apache.karaf.log.cfg，system.properties

      A. org.ops4j.pax.logging.cfg

      使用标准的Log4j设置root logger 级别为INFO,并且定义了两个Appender,一个用于Console,一个用于日志文件。

      默认启用日志文件，要启用控制台日志输出，可在该文件中添加：

      log4j.appender.stdout.append=true

      B. org.apache.karaf.log.cfg

      配置ESB控制台命令输出的形式。

      C. system.properties

      配置在OSGi容器启动时间内当日志服务不可用时的日志级别，默认为ERROR.

      org.ops4j.pax.logging.DefaultServiceLog.level=ERROR

      (2) 为每个Bundle记录日志，可做如下配置：

      Root Loger增加sift属性，如：

      # Root logger
      log4j.rootLogger=INFO, out, sift, osgi:VmLogAppender

      重启容器后，每个Bundle的日志位于：

      data/log/BundleName.log

      (3) 日志命令：

      显示最近的日志：log:display

      显示最近的异常日志：log:display-exception

      获取当前的日志级别：log:get

      设置日志的级别：log:set

      继续显示日志：log:tail

      清空日志：log:clear

       (4) Logging per Application

      需要使用Mapped Diagnostic Context (MDC) logging，这样可以给每个应用程序设置一个Log File.

      但是当前支持MDC的只有log4j和sl4j.MDC日志的原理就是让日志信息与每个特定的应用上下文关联，即通过

      兼职对的集合进行，那么就需要给每个应用程序定义一个key,在程序运行期间，可以使用该key去记录每个应

      用程序对应的日志文件中。

      第一步：给应用程序添加静态的方法调用：

      // Java
      org.slf4j.MDC.put("app.name","MyFooApp");

      或

      // Java
      org.apache.log4j.MDC.put("app.name","MyFooApp");

      第二步：编辑etc/org.ops4j.pax.logging.cfg文件，添加sift Appender:

      # Sift appender
      ...
      log4j.appender.sift.key=app.name
      log4j.appender.sift.appender.file=${karaf.data}/log/$\\{app.name\\}.log

      ......

6.  链接Fuse Maven Repository的Maven配置

<profiles>
	<profile>
		<id>my-profile</id>
		<activation>
			<activeByDefault>true</activeByDefault>
		</activation>
		<repositories>
			<repository>
				<id>fusesource</id>
				<url>http://repo.fusesource.com/nexus/content/groups/public/</url>
				<snapshots>
					<enabled>false</enabled>
				</snapshots>
				<releases>
					<enabled>true</enabled>
				</releases>
			</repository>
			<repository>
				<id>fusesource.snapshot</id>
				<url>http://repo.fusesource.com/nexus/content/groups/public-snapshots/
				</url>
				<snapshots>
					<enabled>true</enabled>
				</snapshots>
				<releases>
					<enabled>false</enabled>
				</releases>
			</repository>
			<repository>
				<id>apache-public</id>
				<url>https://repository.apache.org/content/groups/public/</url>
				<snapshots>
					<enabled>true</enabled>
				</snapshots>
				<releases>
					<enabled>true</enabled>
				</releases>
			</repository>
		</repositories>
	</profile>
</profiles>