安装到现有 Oracle 数据库

该任务主题描述了将 AppScan® 源数据库模式和数据安装到现有 Oracle 数据库的过程。为了创建 Oracle 模式，AppScan 源 安装程序必须在安装了 Oracle 数据库的机器上，或者在安装了完整 Oracle 客户机的机器上运行（此安装程序必须能够访问 Oracle sqlplus 和 sqlldr 实用程序）。

关于此任务

注： macOS 上不支持 AppScan 源 服务器组件（如 AppScan 源数据库）。

过程

  1. 按照 AppScanEnterprise Server 随附的安装指示信息对其进行安装。请参阅AppScanEnterprise Server 概述 以了解有关此服务器的更多信息。
  2. 找到 HCL® AppScan 源 产品 zip 文件（在 AppScan 源 介质包中，或从 作为 FlexNet Operations 中 AppScan 源 eAssembly 的一部分下载的电子映像中）。
  3. 将该映像解压缩到本地驱动器。在得到的目录中：

    关于启动安装向导的详细信息可以在 启动安装向导 内的主题中找到。

  4. 在“组件选择”安装面板中，选择服务器组件选择，然后确保选择 AppScanSource Database。单击下一步以前进到下一安装面板。
  5. 在“服务器连接”面板中，选择以下某个选项：
    • 我将连接到 AppScan Server 实例：选择该选项将使您能够测试远程 AppScanEnterprise Server 以确保其可供连接到 AppScan 源。要测试服务器连接，请填写以下字段：
      • AppScan Enterprise Server：以现有 URL 格式指定远程 AppScanEnterprise Server 实例的主机名。
      • 产品管理员：指定您的 AppScanEnterprise Server 管理员用户标识。
      • 密码：为您的 AppScanEnterprise Server 管理员用户标识指定密码。

      输入了服务器设置后，单击测试连接以确保服务器将可供连接到 AppScan 源。

    • 让我在不指定服务器的情况下继续：选择该选项可在不指定服务器的情况下继续操作。
    重要：
    • 如果您要连接到的 Enterprise Server 支持 NIST 800-131a 合规性，那么您无法测试与服务器的连接。在此情况下，请继续操作，无需指定服务器。在 AppScan 源 和 Enterprise Server 的安装完成后，请遵循向 AppScanEnterprise Server 注册 AppScan 源数据库中的指示信息，以确保应用了强制使用 TLSv1.2 选项。
    • 如果 AppScanEnterprise Server 已通过通用访问卡 (CAC) 认证进行了设置，选择继续而不指定服务器，然后使用 appscanserverdbmgr_cac 实用程序来进行所有服务器连接设置和测试。

    单击下一步以前进到下一安装面板。

  6. 在“安装目标指定”页面中，指定安装目录。缺省目录为（按操作系统）：
    • 64 位版本的 Microsoft Windows。
      <SYSTEMDRIVE>:\Program Files (x86)\ibm\appscansource
    • Linux：如果您是 root 用户，那么安装向导会将软件安装在 /opt/ibm/appscansource 中。如果您不是 root 用户，那么可以安装 AppScan Source for Development Eclipse 插件，它在缺省情况下安装到 <home_directory>/AppScan_Source。
    重要：
    • 安装目录名只能包含英语字符。不允许文件夹名包含非英语字符。
    • 如果您是在 Windows 上进行安装，那么必须拥有管理员特权才能安装 AppScan 源 组件。
    • 如果您是在Linux上进行安装，那么必须拥有 root 用户特权才能安装 AppScan 源 服务器组件。

    单击下一步以前进到下一安装面板。

  7. 如果在“服务器组件选择”页面中选择了安装 HCL AppScan 源数据库组件，那么将显示数据库选择面板。在该页面中，选择将数据库安装到现有 Oracle <版本> 服务器中单选按钮，然后单击下一步以前进到下一安装面板。
  8. 如果在“服务器组件选择”页面中选择了安装 HCL AppScan 源数据库 组件，并且在数据库选择页面中选择了将数据库安装到现有 Oracle <版本> 服务器中，那么将显示“Oracle 数据库服务器”面板。在此页面中，指定：
    • Oracle 主目录：指定 Oracle 安装的位置。
    • Oracle TNS 位置：这是 tnsnames.ora 文件所在的位置。缺省情况下，位置是 <oracle_home>\network\admin（其中 <oracle_home>e 是 Oracle 安装的位置）。
    • Oracle 服务名称/SID：确定连接字符串或者别名，例如 //<hostname>:<port>/<OracleServiceName>。如果指定 TNS 别名，那么需要进行 AppScanEnterprise Server 配置。有关详细信息，请参阅 Oracle TNS 别名配置。
    • 系统用户名：指定将用于执行安装的 Oracle 用户。该用户名必须有权创建其他用户。默认值为 system
    • 系统密码：指定系统用户名的密码。
    • 测试连接：单击此按钮可验证提供的数据库设置和凭证是否正确。
    • AppScan 用户名：指定要创建的 AppScan 源数据库 用户。缺省值为 ounce。
    • AppScan 密码：指定 AppScan 用户名的密码。缺省值为 ounce。
    • 直接数据装入复选框：如果选中，将通过“Oracle 直接装入”方式来装入初始 AppScan 源 数据。缺省情况下，已选中该复选框。
    • Sysdba 用户：如果选中直接数据装入复选框，请指定具有 sysdba 特权的用户。缺省值为 sysdba。
    • Sysdba 密码：指定 Sysdba 用户的密码。
    • SqlPlus 的路径：指定磁盘上 sqlplus 可执行文件的路径。这将用于在安装期间运行 sql 脚本。缺省值为 sqlplus。如果 sqlplus 可执行文件存在于系统路径上，那么无需绝对路径。
    • Sqlldr 的路径：指定磁盘上 sqlldr 可执行文件的路径。这将用于在安装期间装入数据。缺省值为 sqlldr。如果 sqlldr 可执行文件存在于系统路径上，那么无需绝对路径。
    重要： 通过这些设置完成安装后，新的模式和 AppScan 源数据库用户将自动安装到 Oracle 数据库。无需手动创建 AppScan 源数据库用户。
    注：
    • 完成包括将 AppScan 源数据库 模式和数据安装到现有 Oracle 数据库的安装之后，请查看 <data_dir>\logs\core_exceptions.log（其中 <data_dir> 是 AppScan 源 程序数据的位置，如安装和用户数据文件位置） 以验证没有发生安装错误。
    • 如果将 AppScanEnterprise Server 连接到 Oracle 数据库，那么创建数据库时必须将字符集设置为 UTF-8（包括 AL32UTF8）（通常，这不是缺省字符集）。
    • AppScan 源 的安装需要但不会安装 Oracle Instant Client (OCI) 库。有关更多信息，请参阅 安装 Oracle 客户机 (OCI) 库。
    • 如果将 TNS 别名指定为 Oracle 连接字符串，那么可能在 core_exceptions.log文件中看到该错误：Unable to process the database transaction. Error: ORA-12154 （此消息可能伴有来自 Oracle 数据库的错误文档）。要解决该错误，请完成以下任务之一：
      • 将 Oracle tnsnames.ora 文件复制到 <install_dir>\bin（其中 <install_dir>是 AppScan 源 的安装位置）。
      • 打开 <data_dir>\config\ounce.ozsettings（其中 <data_dir> 是 AppScan 源 程序数据的位置，如安装和用户数据文件位置）。在该文件中，找到 tns_admin 设置并将其值更改为指向包含 Oracle tnsnames.ora 文件的目录。保存对文件的更改。

    单击下一步以前进到下一安装面板。

  9. 在语言包选择面板中，选择要安装的语言包。安装语言包时，如果 AppScan 源 用户界面在正运行此语言环境的操作系统上运行，那么该用户界面将以此语言来显示。

    缺省情况下，将选择英语（且不能取消选择）。如果安装向导显示的是非英语的本地语言（换言之，在安装向导欢迎面板中选择了非英语语言），那么在此面板中也将选择该语言（但是，可以取消选择该语言）。

    选择了要安装的语言包后，请单击下一步以前进到下一安装面板。

    注： 如果不安装特定语言包，那么在安装后将无法添加该语言。
  10. 复审并接受许可协议中的条款，然后单击下一步以继续。
  11. 复审安装选项的摘要，然后继续。如果要更改所作的选择，请单击上一步以返回到先前的页面。如果对您的安装选择感到满意，请单击安装。安装程序将文件复制到硬盘驱动器。

    仅适用于 Linux 服务器安装：复制文件后，您必须确定守护程序用户。选择创建用户“ounce”以创建缺省用户 ounce，或选择以现有用户运行来以现有用户运行。（安装将验证该用户是否存在。请注意，所选用户必须具有有效 shell。）

    在安装期间，任何时候单击取消都将导致卸载所有组件。

  12. 在 HCL AppScan Enterprise Server“配置”面板中，指定将允许 solidDB® 数据库连接到 AppScanEnterprise Server 的设置。缺省情况下，此安装面板使用缺省设置预填充一些条目，这些条目假定数据库和服务器安装在同一台机器上。要通过 AppScanEnterprise Server 配置 AppScan 源数据库，选择现在配置 AppScan Enterprise Server 复选框并完成以下设置：
    • AppScan Enterprise Server：指定 AppScanEnterprise Server 实例的 URL。
    • 用户标识：指定您的 AppScanEnterprise Server 管理员用户标识。如果服务器配置为进行 Windows 认证，请输入在将您的帐户添加到服务器时使用的 Windows 用户标识（用户标识必须为以下格式：<host name>\<user id>）。
    • 密码：指定 AppScanEnterprise Server 用户标识的密码。
    • 数据库主机名：指定已安装 AppScan 源数据库 的机器的主机名。
      注： 此字段中的条目应始终为运行安装程序的机器的标准主机名。此字段中的值应在安装时进行预填充，并且只能在预填充不正确的情况下进行更改。

    单击下一步以前进到下一安装面板。

    注： 如果将使用 Oracle 数据库，确保未选择现在配置 AppScan Enterprise Server，然后单击下一步。该安装面板不用于将 Oralce 数据库注册到 Enterprise Server。相反，请使用 AppScan 源 随附的实用程序来配置数据库连接后安装。有关此处所述内容的信息可以在以下网址中找到：向 AppScanEnterprise Server 注册 AppScan 源数据库。该实用程序还可用于配置 solidDB 连接，而不是使用该安装面板。
  13. 在“安装完成”面板中，可通过选择启动 HCL AppScan 源 License Manager 来在退出安装向导后立即启动产品激活。单击完成以完成标准安装，并退出“安装向导”。
  14. 在 License Manager 实用程序中：
    1. 要应用许可证文件，请单击导入，然后浏览至已下载的 AppScan 源 许可证。
    2. 要应用浮动许可证，请单击配置许可证服务器，然后单击添加。输入包含了浮动许可证的主机的信息。
    请参阅激活软件以获取其他的激活指示信息。