test

Service Registry 3.1 管理指南

管理 Java DB 数据库

Registry 使用 Java DB 数据库。Java DB 是商业版的 Apache Software Foundation 开放源代码关系数据库项目。此 Apache 项目称为 Derby。

默认情况下，此数据库位于目录 RegistryDomain-base/3.0/data/registry/soar/ 中。数据库备份放在目录 RegistryDomain-base/3.0/backup/ 中，并且子目录名称中包含备份日期（例如，20060419-004759）。

默认情况下，Java DB 数据库以嵌入模式运行。这意味着它与 Service Registry 在同一 JVM 中运行，并且只能接受来自一个客户机（即 Service Registry）的连接。无法进行远程连接。当 Java DB 以嵌入模式运行时，您只能在数据库未运行时对其执行备份（脱机备份）。有关说明，请参见对数据库执行脱机备份。

如果需要在 Registry 域运行时能够备份数据库（联机备份），则必须在网络服务器模式下运行 Java DB 数据库。有关说明，请参见从嵌入模式切换到网络服务器模式和对数据库执行联机备份。

在网络服务器模式下运行时，Java DB 可以通过常见的客户机/服务器配置接受多个客户机连接。例如，Service Registry 和 SQL 客户机可以同时与 Java DB 进行通信。当 Java DB 以网络服务器模式运行时，它将使用默认值为 1527 的数据库端口。Service Registry 之类的客户机将使用此端口与数据库进行通信。

当 Java DB 以网络服务器模式运行时，Service Registry 将以网络客户机模式运行。

以网络服务器模式运行的数据库必须受密码保护，这样只有经过验证的客户机才能使用此数据库。当数据库以嵌入模式运行时，您也可以使用这种方法保护数据库，但这样做是不必要的。

默认情况下，将在文件 ServiceRegistry-base/install/install.properties 中设置属性，以使 Java DB 在嵌入模式下运行。表 1–3 显示了这些设置。

表 1–3 Java DB 默认属性设置

属性设置 

描述 

registry.install.clientDatabase=false

启用嵌入模式 

registry.install.RequireDatabaseAuthentication=false

不需要数据库验证 

registry.install.DatabaseUserID=APP

将用户 ID 设置为 APP（未使用）

registry.install.DatabasePassword=app123

将密码设置为 app123（未使用）

有关 Java DB 的更多详细信息，请查阅 Java DB Web 站点上的 Java DB 文档。

Procedure需要数据库验证

默认情况下，不需要数据库验证。当数据库以嵌入模式运行时，可能需要验证；当数据库以网络服务器模式运行时，必须验证。

  1. 转至 Service Registry 安装目录：

    cd ServiceRegistry-base/install

  2. 在文本编辑器中打开 install.properties 文件的副本。

  3. 将 registry.install.RequireDatabaseAuthentication 属性的设置从 false 更改为 true。

  4. 编辑 registry.install.DatabaseUserID 属性的设置。

    对于嵌入模式，此值可以为 APP 或为空：

    registry.install.DatabaseUserID=APP
    registry.install.DatabaseUserID=

    对于网络服务器模式，此值必须为 APP。

  5. 编辑 registry.install.DatabasePassword 属性的设置。

    密码必须至少包含 6 个字符。默认值为 app123。

  6. 保存并关闭此文件。

  7. 停止并重新启动 Registry 的 Application Server 域。为此，请执行以下命令（全都在一行）：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.bounce

    其中，props-file 是您在在进行了“以后配置”安装后，以 Root 身份使用自定义属性配置 Service Registry或在进行了“以后配置”安装后，以非 Root 用户身份使用自定义属性配置 Service Registry中编辑的 install.properties 文件副本的路径名。

Procedure对数据库执行脱机备份

如果数据库以嵌入模式运行，则必须执行脱机备份。

  1. 转至 Service Registry 安装目录：

    cd ServiceRegistry-base/install

  2. 执行以下命令（全都在一行）：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.stop

    其中，props-file 是您在在进行了“以后配置”安装后，以 Root 身份使用自定义属性配置 Service Registry或在进行了“以后配置”安装后，以非 Root 用户身份使用自定义属性配置 Service Registry中编辑的 install.properties 文件副本的路径名。

  3. 执行以下命令（全都在一行）：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file backup.db

  4. 通过执行以下命令（全都在一行）重新启动域：

    Ant-base/ant -f build-install.xml Dinstall.properties=props-file appserver.domain.start

Procedure从嵌入模式切换到网络服务器模式

要从嵌入模式（默认值）切换到网络服务器模式，请将 registry.install.clientDatabase 属性的设置从 false 更改为 true，并需要数据库验证。

编辑属性之后，重新创建数据库资源，然后停止并重新启动 Application Server。

  1. 转至 Service Registry 安装目录：

    cd ServiceRegistry-base/install

  2. 在文本编辑器中打开 install.properties 文件的副本。

  3. 将 registry.install.clientDatabase 属性的设置从 false 更改为 true。

  4. 将 registry.install.RequireDatabaseAuthentication 属性的设置从 false 更改为 true。

  5. 如果有必要，请编辑 registry.install.DatabaseUserID 属性的设置。

    对于网络服务器模式，此值必须为 APP。

  6. 编辑 registry.install.DatabasePassword 属性的设置。

    任何长度均有效。默认值为 app123。

  7. 保存并关闭此文件。

  8. 重新创建数据库连接池及其相关资源。为此，请执行以下命令（全都在一行）：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.jdbcResource.update

    其中，props-file 是您在在进行了“以后配置”安装后，以 Root 身份使用自定义属性配置 Service Registry或在进行了“以后配置”安装后，以非 Root 用户身份使用自定义属性配置 Service Registry中编辑的 install.properties 文件副本的路径名。

  9. 停止并重新启动 Registry 的 Application Server 域。为此，请执行以下命令（全都在一行）：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.bounce

  10. 启动 Java DB 数据库。为此，请执行以下命令：

    asadmin start-database --dbhome database-directory

    默认情况下，此命令将数据库及其日志文件放在当前目录中。请使用 --dbhome 选项指定数据库的位置（通常为 RegistryDomain-base/3.0/data/registry/soar）。

接下来的操作

如果数据库以网络服务器模式运行，则可以对数据库执行联机备份。

以后，如果要返回到嵌入模式，请执行相同的步骤，但要进行如下设置：

Procedure对数据库执行联机备份

  1. 转至 Service Registry 安装目录：

    cd ServiceRegistry-base/install

  2. 检验 install.properties 文件副本中的 registry.install.clientDatabase 属性是否设置为 true。

  3. 执行以下命令（全都在一行）：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file backup.db

    其中，props-file 是您在在进行了“以后配置”安装后，以 Root 身份使用自定义属性配置 Service Registry或在进行了“以后配置”安装后，以非 Root 用户身份使用自定义属性配置 Service Registry中编辑的 install.properties 文件副本的路径名。