B STA 无提示模式安装程序和卸载程序

本附录包含以下几节:

使用 STA 无提示模式安装程序和卸载程序

无提示模式允许您绕过图形用户界面,并在称为响应文件的 XML 属性文件中提供 STA 安装或卸载选项。使用响应文件生成实用程序 silentInstallUtility_version.jar 来创建响应文件,其中 version 是您已下载的实用程序的版本。

该模式对于无人参与安装和在多个计算机上安装 STA 很有用。通过使用响应文件,可以提供单个参数集并自动执行安装。可以通过脚本或 Linux 命令行运行无提示模式安装程序。

无提示模式要求

有关一般 STA 安装要求,请参见验证安装先决条件。此外,STA 无提示模式安装程序和卸载程序具有以下特定于模式的要求:

  • 可以通过 telnet 客户机(如 PuTTY)使用无提示模式,该方式不使用 X11 协议。不过,必须在 STA 服务器上安装 xorg-x11-utils RPM 软件包。

  • 在使用无提示模式之前,必须从 Oracle Software Delivery Cloud Web 站点下载 silentInstallUtility_version.jar 文件,并使用该文件创建包含加密密码的响应文件。有关说明,请参见创建无提示模式安装程序响应文件

  • 无提示模式还要求主产品清单指针文件,用于指定 Oracle 主产品清单目录的位置和 Oracle 安装组。如果该文件尚不存在,则必须手动创建该文件。有关详细信息,请参见Oracle 主产品清单指针文件

无提示模式下使用的文件和实用程序

本节介绍无提示模式安装和卸载的关键概念和术语。

Oracle 主产品清单指针文件

STA 无提示模式安装程序和卸载程序使用在主产品清单指针文件中指定的 Oracle 主产品清单位置和 Oracle 安装组。有关详细信息,请参见STA 安装程序使用的用户、组和位置

默认情况下,无提示模式安装程序和卸载程序使用指针文件 /etc/oraInst.loc。注册 Oracle 主产品清单时,会使用该名称和位置自动创建该文件。有关详细信息,请参见注册 Oracle 主产品清单位置

如果尚未注册 Oracle 主产品清单位置,则必须手动创建该指针文件并为其提供文件名 oraInst.loc。有关详细信息,请参见创建 Oracle 主产品清单指针文件。可以将指针文件置于任何目录中,但如果该文件不位于 /etc,则必须在运行无提示模式安装程序或卸载程序时使用 –invPtrLoc 参数指定文件位置。有关该参数的详细信息,请参见–invPtrLoc pointer_file

无提示模式安装程序和卸载程序响应文件

为了在无人参与的情况下运行,STA 无提示模式安装程序和卸载程序使用您创建的响应文件中包含的配置设置。必须使用 –responseFile 参数指定该文件的名称和位置。

安装程序和卸载程序拥有其各自的响应文件。示例 B-1示例 B-2 显示了每个响应文件的内容和必需的条目。要创建您自己的响应文件,可以将每个模板复制并粘贴到文本文件中并针对您的站点进行相应的更改。

为了确保密码安全,请勿在响应文件中输入明文密码。在输入所有其他配置设置并保存该文件后,必须使用响应文件生成实用程序将加密密码插入该文件。有关详细信息,请参见STA 安装程序响应文件生成实用程序

示例 B-1 STA 无提示模式安装程序响应文件模板

[ENGINE]
#DO NOT CHANGE THIS. Response File Version=1.0.0.0.0
[GENERIC]
#The oracle storage home location. This can be an existing Oracle Storage Home or #a new Oracle Storage Home
STORAGE_HOME=required
#Root access passsword var.
ROOT ACCESS PASSWORD=
RESPONSEFILE_LOC=
KEYFILE_LOC=
#DBDATA LOC
DBDATA LOC=required
#DBBACKUP LOC
DBBACKUP LOC=required
#Weblogic Admin Name Var
WEBLOGIC ADMIN NAME=required
#Weblogic Admin Password Var
WEBLOGIC ADMIN PASSWORD=
#Weblogic Admin ConfirmPassword Var
WEBLOGIC ADMIN CONFIRMPASSWORD=
#STAGUI Admin Name Var
STAGUI ADMIN NAME=required
#STAGUI Admin Password Var
STAGUI ADMIN PASSWORD=
#STAGUI Admin ConfirmPassword Var
STAGUI ADMIN CONFIRMPASSWORD=
#MySQL root passsword var.
MYSQL ROOT PASSWORD=
#MySQL root confirm passsword var.
MYSQL ROOT CONFIRM PASSWORD=
#MySQL App Name Var
MYSQL APP NAME=required
#MySQL App Password Var
MYSQL APP PASSWORD=
#MySQL App ConfirmPassword Var
MYSQL APP CONFIRMPASSWORD=
#MySQL RPTS Name Var
MYSQL RPTS NAME=required
#MySQL RPTS Password Var
MYSQL RPTS PASSWORD=
#MySQL RPTS ConfirmPassword Var
MYSQL RPTS CONFIRMPASSWORD=
#MySQL DBA Name Var
MYSQL DBA NAME=required
#MySQL DBA Password Var
MYSQL DBA PASSWORD=
#MySQL DBA ConfirmPassword Var
MYSQL DBA CONFIRMPASSWORD=
#ADMINSERVER HTTP Port Var
ADMINSERVER HTTP PORT=7019
#ADMINSERVER HTTPS Port Var
ADMINSERVER HTTPS PORT=7020
#staEngine HTTP Port Var
STAENGINE HTTP PORT=7023
#staEngine HTTPS Port Var
STAENGINE HTTPS PORT=7024
#staAdapter HTTP Port Var
STAADAPTER HTTP PORT=7025
#staAdapter HTTPS Port Var
STAADAPTER HTTPS PORT=7026
#staUi HTTP Port Var
STAUI HTTP PORT=7021
#staUi HTTPS Port Var
STAUI HTTPS PORT=7022
#Domain name var.
DOMAIN NAME=required

示例 B-2 STA 无提示模式卸载程序响应文件模板

[ENGINE]
#DO NOT CHANGE THIS. Response File Version=1.0.0.0.0
[GENERIC]
#This will be blank when there is nothing to be de-installed in distribution level
SELECTED_DISTRIBUTION=STA_Install~2.1.0.0.0
#Root access passsword var.
DEINSTALL ROOT ACCESS PASSWORD=
RESPONSEFILE_LOC=
KEYFILE_LOC=
STA 安装程序响应文件生成实用程序

安装程序响应文件生成实用程序允许您将加密密码插入无提示模式安装程序和卸载程序响应文件。该实用程序提示您输入密码并以加密形式将其添加到指定的文件中。该实用程序还将一个加密密钥文件保存到您选择的目录中。

可以在下载 STA 安装程序时下载响应文件生成实用程序。该实用程序名称为 silentInstallUtility_version.jar,其中 version 是您已下载的实用程序的版本。

成功安装或卸载 STA 后,会从各自的响应文件中删除加密密码。要再次运行无提示模式安装程序或卸载程序,可以重新运行生成实用程序以重新提供加密密码。

生成实用程序将响应文件位置写入文件的内容,因此,使用该实用程序更新响应文件后,无法重新定位响应文件。

有关说明,请参见创建无提示模式安装程序响应文件

STA 无提示模式安装程序任务

在使用这些任务之前,应获取必要的安装信息、验证先决条件并下载 STA 安装程序。有关说明,请参见STA 安装任务

然后,要使用无提示模式安装程序安装 STA,请按照所列的顺序使用以下任务。

创建 Oracle 主产品清单指针文件

使用该过程创建 Oracle 主产品清单指针文件(如果该文件尚不存在)。

  1. 以 Oracle 安装用户身份登录。

  2. 发出以下命令,以确定 Oracle 主产品清单指针文件是否存在。

    $ cat /etc/oraInst.loc
    

    下面是显示示例,具体取决于该文件是否存在:

    • 文件不存在:

      cat: /etc/oraInst.loc: No such file or directory
      
    • 文件存在:

      inventory_loc=/opt/oracle/oraInventory
      inst_group=oinstall
      
  3. 如果文件存在,则可以退出该过程;否则,继续执行下一步。

  4. 使用文本编辑器创建产品清单指针文件。该文件的名称必须为 oraInst.loc。有关该文件的内容,请参见–invPtrLoc pointer_file

  5. 将该文件保存在您选择的目录中。如果在 /etc 目录中保存该文件,则 STA 无提示模式安装程序和卸载程序会自动找到该文件;否则必须在运行这些实用程序时指定该位置。

创建无提示模式安装程序响应文件

使用该过程创建无提示模式安装程序响应文件并将加密密码添加到该文件中。

  1. 以 Oracle 安装用户身份登录。

  2. 使用文本编辑器创建具有您选择的名称的响应文件。有关文件模板,请参见示例 B-1

    将模板复制并粘贴到文本文件中,并针对您的站点进行相应的更改。必须为所有标记为 "required" 的变量提供值,可以根据站点的需要更改端口号。

    • RESPONSEFILE_LOC

    • KEYFILE_LOC

    • 所有 PASSWORD 变量

  3. 使用您选择的名称和位置保存该文件。

  4. 转至已在其中下载响应文件生成实用程序的目录。该实用程序的名称为 silentInstallUtility_version.jar。例如:

    $ cd /Installers
    
  5. 运行响应文件生成实用程序。

    $ java -jar silentInstallUtility_2.1.0.64.124.jar  response_file
    

    其中 response_file 是您已创建的响应文件的绝对路径。

  6. 使用相应的信息响应每个提示。您输入的密码值不会显示在屏幕中。有关密码要求,请参见用于管理 STA 的用户帐户

    示例 B-3 是响应文件生成实用程序运行样例。

    示例 B-3 安装程序响应文件生成实用程序运行样例

    $ java -jar silentInstallUtility_2.1.0.64.124.jar /Installers/SilentInstall.rsp
    Oracle StorageTek Tape Analytics Silent Installation Utility
    ------------------------------------------------------------
     
    This utility is used to assist users with the password fields in the Silent Installation response file. The silent installation process requireds the password fields in the response file requires the password fields to be encrypted. The utility will ask the users for the required passwords, and encrypt these values, then update the values into the supplied response file.
     
     
    Please enter the location to save the key file : /Installers
    What is the response file used for? ('i' for Install, 'd' for Deinstall) : i
    Enter system root password:
    Confirm system root password:
    Enter mySQL DB root password:
    Confirm mySQL DB root password:
    Enter STA user password:
    Confirm STA user password:
    Enter Weblogic console password:
    Confirm Weblogic console password:
    Enter STA DB Application password:
    Confirm STA DB Application password:
    Enter STA DB Report password:
    Confirm STA DB Report password:
    Enter STA DBA password:
    Confirm STA DBA password:
    
  7. 完成该实用程序后,验证是否已在响应文件所在的目录中创建加密密钥文件。这是一个隐藏文件,该文件具有随机生成的以 "sk" 开头的名称。例如:

    $ ls -la /Installers/.sk* 
    -r--------   1 oracle oinstall         17 Sep 22 12:00 .sk1414440339833
    
  8. 查看响应文件并验证以下值:

    • 已使用正确的响应文件位置更新 RESPONSEFILE_LOC

    • 已使用正确的加密密钥文件位置更新 KEYFILE_LOC

    • 已使用加密值更新所有密码。

    示例 B-4 是该文件的第一部分样例,其中显示了正确的值。

    示例 B-4 使用生成实用程序之后的安装程序实用程序文件样例

    $ view /Installers/SilentInstall.rsp
    [ENGINE]
    #DO NOT CHANGE THIS. Response File Version=1.0.0.0.0
    [GENERIC]
    #The oracle storage home location. This can be an existing Oracle Storage Home or a new Oracle Storage Home
    STORAGE_HOME=/Oracle
    #Root access passsword var.
    ROOT ACCESS PASSWORD=JvPABRzrtVP7LZT1Vin0Qg==
    RESPONSEFILE_LOC=/Installers/SilentInstall.rsp
    KEYFILE_LOC=/Installers/.sk1414705403180
    #DBDATA LOC
    DBDATA LOC=/dbdata
    #DBBACKUP LOC
    DBBACKUP LOC=/dbbackup
    #Weblogic Admin Name Var
    WEBLOGIC ADMIN NAME=weblogic
    #Weblogic Admin Password Var
    WEBLOGIC ADMIN PASSWORD=k5/c6Oq1KGwQdUje6CfCgA==
    #Weblogic Admin ConfirmPassword Var
    WEBLOGIC ADMIN CONFIRMPASSWORD=k5/c6Oq1KGwQdUje6CfCgA==
    ...
    

运行无提示模式安装程序

使用该过程通过无提示模式安装程序安装 STA。

  1. 转至 STA 安装程序位置。例如:

    $ cd /Installers
    
  2. 启动 STA 无提示模式安装程序。有关这些参数的完整定义,请参见STA 安装程序命令选项

    $ ./sta_installer_linux64_version.bin –silent  –responseFile response_file –invPtrLoc pointer_file
    

    其中:

    • version 是您已下载的 STA 安装程序的版本。

    • –silent 指示无提示模式;该参数是必需的。

    • –responseFile response_file 指定无提示模式安装程序响应文件的绝对路径;该参数是必需的。

    • –invPtrLoc pointer_file 指定 Oracle 主产品清单指针文件的绝对路径;仅当该文件不存在于 /etc 目录或您希望使用其他文件时才需要该参数。

    例如:

    $ ./sta_install_2.1.0.64.124_linux64.bin –silent –responseFile /Installers/SilentInstall.rsp -invPtrLoc /opt/oracle/oraInst.loc
    
  3. 安装程序在执行以下安装步骤时会在终端窗口中显示状态消息。该过程可能需要 30 到 60 分钟才能完成。

    • 对 STA 服务器环境执行先决条件检查。

    • 安装包含的软件包,包括 MySQL、WebLogic 和 STA 应用程序。

    • 使用您已在响应文件中提供的设置配置 STA 环境。

    • 启动 STA 应用程序。

    示例 B-5 显示了在成功的安装结束时显示的消息。示例 B-6 显示了您可能在失败的安装结束时看到的部分消息。

    示例 B-5 成功的 STA 无提示模式安装最终消息

    ...
    Started Configuration:Deploying STA Application
    Configuration:Deploying STA Application completed successfully
    Started Configuration:Restarting STA (this can take up to 30 minutes)
    Configuration:Restarting STA (this can take up to 30 minutes) completed successfully
    Started Configuration:Post Configuration
    Successfully moved logs to /var/log/tbi/install.
    Configuration:Post Configuration completed successfully
    The installation of STA_Install 2.1.0.0.0 completed successfully.
    Logs successfully copied to /home/oracle/oraInventory/logs.
    $
    

    示例 B-6 失败的 STA 无提示模式安装最终消息样例

    [ERROR] Rule_CalculateFreeSpace_Error. Aborting Install
    Logs are located here: /tmp/OraInstall2014-09-24_09-29-29AM.
    ** Error during execution, error code = 256.
    $
    
  4. 当安装程序成功完成时,验证 STA 是否在运行。有关说明,请参见验证安装是否成功

STA 无提示模式卸载程序任务

创建无提示模式卸载程序响应文件

使用该过程创建无提示模式卸载程序响应文件并将加密密码添加到该文件中。

  1. 以 Oracle 安装用户身份登录。

  2. 使用文本编辑器创建具有您选择的名称的卸载程序响应文件。有关文件模板,请参见示例 B-2

    将模板复制并粘贴到文本文件中,并将所有变量留空。

  3. 使用您选择的名称和位置保存该文件。

  4. 转至已在其中下载响应文件生成实用程序的目录。该实用程序的名称为 silentInstallUtility_version.jar。例如:

    $ cd /Installers
    
  5. 运行响应文件生成实用程序。

    $ java -jar silentInstallUtility_2.1.0.64.124.jar  response_file
    

    其中 response_file 是您已创建的响应文件的绝对路径。

  6. 使用相应的信息响应每个提示。您输入的密码值不会显示在屏幕中。

    示例 B-7 是实用程序运行样例。

    示例 B-7 卸载程序响应文件生成实用程序运行样例

    $ java -jar silentInstallUtility_2.1.0.64.124.jar /Installers/SilentIDeinstall.rsp
    Oracle StorageTek Tape Analytics Silent Installation Utility
    ------------------------------------------------------------
     
    This utility is used to assist users with the password fields in the Silent Installation response file. The silent installation process requireds the password fields in the response file requires the password fields to be encrypted. The utility will ask the users for the required passwords, and encrypt these values, then update the values into the supplied response file.
     
     
    Please enter the location to save the key file : /Installers
    What is the response file used for? ('i' for Install, 'd' for Deinstall) : d
    Enter system root password:
    Confirm system root password:
    
  7. 在完成该实用程序后,验证是否已创建加密密钥文件。这是一个隐藏文件,该文件具有随机生成的名称。例如:

    $ ls -la /Installers/.sk*
    -r--------   1 oracle oinstall         17 Sep 22 12:00 .sk1414437879829
    
  8. 查看响应文件并验证以下值:

    • 已使用加密值更新系统 root 用户密码。

    • 已使用正确的响应文件位置更新 RESPONSEFILE_LOC

    • 已使用加密密钥文件位置更新 KEYFILE_LOC

    示例 B-8 是显示正确值的文件样例。

    示例 B-8 使用生成实用程序之后的卸载程序响应文件样例

    $ view /Installers/SilentDeinst.rsp
    [ENGINE]
    #DO NOT CHANGE THIS. Response File Version=1.0.0.0.0
    [GENERIC]
    #This will be blank when there is nothing to be de-installed in distribution level
    SELECTED_DISTRIBUTION=STA_Install~2.1.0.0.0
    #Root access passsword var.
    DEINSTALL ROOT ACCESS PASSWORD=zMZJYDbrhiRZUQL35r7uEg==
    RESPONSEFILE_LOC=/Installers/silentdeinstall.rsp
    KEYFILE_LOC=/Installers/.sk1414700056981
    

运行无提示模式卸载程序

使用该过程通过无提示模式卸载程序卸载 STA。

  1. 以 Oracle 安装用户身份登录。

  2. 转至 STA 主目录。例如:

    $ cd /Oracle/StorageTek_Tape_Analytics
    
  3. 转至 STA 实用程序目录。

    $ cd oui/bin
    
  4. 启动 STA 无提示模式卸载程序。有关这些参数的完整定义,请参见STA 安装程序命令选项

    $ ./deinstall.sh –silent  –responseFile response_file –invPtrLoc pointer_file 
    

    其中:

    • –silent 指示无提示模式;该参数是必需的。

    • –responseFile response_file 指定 STA 卸载程序响应文件的绝对路径;该参数是必需的。

    • –invPtrLoc pointer_file 指定 Oracle 主产品清单指针文件的绝对路径;仅当该文件不存在于 /etc 目录或您希望使用其他文件时才需要该参数。

    例如:

    $ ./deinstall.sh –silent  –responseFile /Installers/SilentDeinst.rsp –invPtrLoc /opt/oracle/oraInst.loc
    
  5. 卸载程序在执行以下卸载步骤时会在终端窗口中显示状态消息。该过程可能最多需要 30 分钟才能完成。

    示例 B-9 显示了在成功的安装结束时显示的消息。示例 B-10 显示了您可能在失败的安装结束时看到的部分消息。

    示例 B-9 成功的 STA 无提示模式卸载最终消息

    ...
    Reading response file..
    Starting silent deinstallation...
    -----------20%----------40%----------60%----------80%-------Successfully moved logs to /var/log/tbi/install.
    s/common/bin/uninstall.sh/mysql was removed, with s/common/bin/uninstall.sh left, because there are user defined files in s/common/bin/uninstall.sh or it is a mount point.
    /dbdata/local was removed, with /dbdata left, because there are user defined files in /dbdata or it is a mount point.
    100%
     
    The uninstall of STA_Install 2.1.0.0.0 completed successfully.
    Logs successfully copied to /home/oracle/oraInventory/logs.
    

    示例 B-10 失败的 STA 无提示模式卸载最终消息样例

    ...
    Reading response file..
    Starting silent deinstallation...
    -----------20%----------40%----------60%----------80%-------Internal Error: File Copy failed. Aborting Install
    Logs are located here: /tmp/OraInstall2014-09-25_10-07-18AM.
    
  6. 当卸载程序完成时,验证是否已删除 STA 目录。有关说明,请参见验证卸载是否成功

STA 安装程序命令选项

本节提供 STA 安装程序选项的参考信息。无提示模式选项专门用于无提示模式安装程序和卸载程序。日志记录和其他选项可用于两种模式的安装和卸载。

无提示模式选项

以下选项用于无提示模式安装程序和卸载程序。

–force

允许在无提示模式下安装到非空目录。

–invPtrLoc pointer_file

使用指定的 Oracle 主产品清单指针文件,而不是位于 /etc/oraInst.loc 的 Oracle 主产品清单指针文件。pointer_file 必须是绝对路径。

Oracle 主产品清单文件的内容如下所示:

inventory_loc=Oracle_central_inventory_location
inst_group=Oracle_install_group

其中:

  • Oracle_central_inventory_location 是 Oracle 主产品清单的绝对路径。

  • Oracle_install_group 是 Oracle 安装组的名称。

–response, –responseFile response_file

对于无提示模式是必需的。包含 STA 无提示模式安装程序或卸载程序输入的响应文件的位置。response_file 必须是绝对路径。

有关安装程序和卸载程序响应文件的内容,请参见示例 B-1示例 B-2

–silent

对于无提示模式是必需的。指示使用无提示模式。输入来自指定的响应文件。

日志记录选项

以下选项允许您控制在安装程序和卸载程序日志中提供的信息类型。可将其用于图形模式和无提示模式。

–debug

记录调试信息。某些调试信息还会显示在控制台窗口中。

–logLevel level

忽略其优先级低于指定的级别的日志消息。level 的值如下所示:

  • severe

  • warning

  • info

  • config

  • fine

  • finer

  • finest

–printdiskusage

记录有关磁盘使用情况的调试信息。

–printmemory

记录有关内存使用情况的调试信息。

–printtime

记录有关用时的调试信息。

其他选项

以下命令选项是通用的。可将其用于图形模式和无提示模式。

–compatibilityFile compatibility_file

指定功能集相关项更改的文件的位置。

–executeSysPrereqs

为运行安装程序执行系统环境先决条件检查,然后在不执行安装的情况下退出。

–help

显示帮助。

–i、–install

使用图形模式。这是默认选项。

–J–Djava.io.tmpdir=working_directory

将 STA 安装程序解压缩至指定的工作目录,而不是 /tmpworking_directory 必须是绝对路径。

–paramFile initialization_file

使用指定的初始化文件,而不是位于 STA_home/oui/oraparam.ini 的初始化文件。initialization_file 必须是绝对路径。

STA 安装程序使用您为所有操作(包括先决条件检查)指定的文件。默认位置位于 STA_home/oui 目录中。