Table of Contents

Search

  1. Preface
  2. Installation Overview
  3. Before You Install
  4. Data Archive Installation
  5. Data Vault Installation
  6. Application Accelerator Installation
  7. Application Retirement for Healthcare Accelerator Installation
  8. MongoDB Accelerator Installation
  9. Salesforce Accelerator Installation
  10. After You Install
  11. Data Archive Upgrade
  12. Data Vault Upgrade
  13. Upgrading Oracle History Data
  14. Upgrading PeopleSoft History Data
  15. ILM Data Validation Option Setup
  16. Data Archive Source and Target Database Requirements
  17. Data Archive Connectivity
  18. Data Archive Uninstallation
  19. SAP Application Retirement
  20. Database Users and Privileges
  21. Data Visualization Designer Installation
  22. Data Archive Installation Requirements Checklist and Architecture Options

Installation and Upgrade Guide

Installation and Upgrade Guide

Step 1. Create the Properties File

Step 1. Create the Properties File

Informatica provides a sample properties file that includes the parameters that are required by the Data Vault installer. You can customize the sample properties file to specify the options for your installation.
The sample properties file is named SilentInput.properties and is located in the root directory of the installation DVD or the installer download location. After you customize the file, save it back to the same file name SilentInput.properties.
  1. Go to the root of the directory that contains the installer files.
  2. Find the file named SilentInput.properties.
    Back up the file before you modify it.
  3. Use a text editor to open the file and modify the values of the parameters.
    The following table describes the installation parameters that you must set:
    Property Name
    Description
    INSTALL_TYPE_NEW
    Starts an installation of a Data Vault component. Default is 1. Do not modify the default value.
    INSTALL_TYPE_UPGRADE
    Starts an upgrade of a Data Vault component. Default is 0. Do not modify the default value.
    SELECTED_LICENSE_FILE
    Absolute path and file name of the license key file.
    USER_INSTALL_DIR
    Directory in which to install the Data Vault component. For the Data Vault Data Archive plug-in, the installation directory must contain an instance of Data Archive. For the Data Vault Administration Tool, the installation directory must be empty.
    SILENT_INSTALL
    Indicates silent installation mode. Default is True. Do not modify the default value.
    INSTALL_FAS
    Set to True to install the Data Vault component. Set to False to skip the installation of the Data Vault component.
    If you set the INSTALL_FAS parameter to True, you must set the following parameters to False:
    • INSTALL_ODBC
    • INSTALL_FAS_AGENT
    • INSTALL_FAS_ARCHIVE_PLUGIN
    • INSTALL_SQL_WORKSHEET
    • INSTALL_ADMIN_CONSOLE
    INSTALL_ODBC
    Set to True to install the Data Vault ODBC component. Set to False to skip the installation of the Data Vault ODBC component.
    If you set the INSTALL_ODBC parameter to True, you must set the following parameters to False:
    • INSTALL_FAS
    • INSTALL_FAS_AGENT
    • INSTALL_FAS_ARCHIVE_PLUGIN
    • INSTALL_SQL_WORKSHEET
    • INSTALL_ADMIN_CONSOLE
    INSTALL_FAS_AGENT
    Set to True to install the Data Vault Agent component. Set to False to skip the installation of the Data Vault Agent component.
    If you set the INSTALL_FAS_AGENT parameter to True, you must set the following parameters to False:
    • INSTALL_FAS
    • INSTALL_ODBC
    • INSTALL_FAS_ARCHIVE_PLUGIN
    • INSTALL_SQL_WORKSHEET
    • INSTALL_ADMIN_CONSOLE
    INSTALL_FAS_ARCHIVE_PLUGIN
    Set to True to install the Data Vault Data Archive plug-in. Set to False to skip the installation of the Data Vault Data Archive plug-in.
    If you set the INSTALL_FAS_ARCHIVE_PLUGIN parameter to True, you must set the following parameters to False:
    • INSTALL_FAS
    • INSTALL_ODBC
    • INSTALL_FAS_AGENT
    • INSTALL_SQL_WORKSHEET
    • INSTALL_ADMIN_CONSOLE
    You must install the Data Vault Data Archive plug-in on a machine that hosts Data Archive. Verify that Data Archive is running when you install the Data Archive plug-in.
    INSTALL_SQL_WORKSHEET
    Set to True to install the Data Vault SQL Tool. Set to False to skip the installation of the Data Vault SQL Tool.
    If you set the INSTALL_SQL_WORKSHEET parameter to True, you must set the following parameters to False:
    • INSTALL_FAS
    • INSTALL_ODBC
    • INSTALL_FAS_AGENT
    • INSTALL_FAS_ARCHIVE_PLUGIN
    • INSTALL_ADMIN_CONSOLE
    INSTALL_ADMIN_CONSOLE
    Set to True to install the Data Vault Administration Tool. Set to False to skip the installation of the Data Vault Administration Tool.
    If you set the INSTALL_ADMIN_CONSOLE parameter to True, you must set the following parameters to False:
    • INSTALL_FAS
    • INSTALL_ODBC
    • INSTALL_FAS_AGENT
    • INSTALL_FAS_ARCHIVE_PLUGIN
    • INSTALL_SQL_WORKSHEET
    SERVER_PORT
    Port number used by the ssasql command line program and other clients such as the Data Vault SQL Tool and ODBC applications to connect to the Data Vault. Default is 8500.
    SERVER_EXE_PORT
    Port number used by the Data Vault Agent and the Data Vault Administration Tool to connect to the Data Vault. Default is 8600.
    SERVER_TEMP_DIR
    Directory where the Data Vault Service stores temporary result set files.
    Default is $USER_INSTALL_DIR$/temp.
    SERVER_INDEX_DIR
    Directory where the Data Vault Service stores index files when you create indexes for archived tables.
    Default is $USER_INSTALL_DIR$/index.
    SERVER_LOG_DIR
    Directory where the Data Vault Service stores server logs.
    Default is $USER_INSTALL_DIR$/fas_logs.
    SERVER_THREADS
    Do not modify the default value.
    SERVER_ROWSETBUFFER
    Do not modify the default value.
    COMMON_TEMP_DIR
    Do not modify the default value.
    COMMON_LOG_DIR
    Do not modify the default value.
    COMMON_SHARE_DIR
    Do not modify the default value.
    COMMON_CRYPTOLEVEL
    Do not modify the default value.
    AGENT_PRIORITY
    Do not modify the default value.
    AGENT_LOG_DIR
    Directory where the Data Vault Service stores logs generated by the Data Vault Agents.
    Default is $USER_INSTALL_DIR$/fas_agent_logs.
    STARTER_LOG_DIR
    Directory where the Data Vault Service stores logs generated during initialization.
    Default is $USER_INSTALL_DIR$/fas_logs.
    META_AUTOSTARTUP
    Do not modify the default value.
    QUERY_THREADS
    Number of threads used by the Data Vault Agent to process client requests to the Data Vault. Default is 2.
    QUERY_MEMORY
    Maximum amount of memory in megabytes to use for processing client requests to the Data Vault. The Data Vault Service allocates memory dynamically up to the maximum specified in this property. Default is 2048 MB.
    QUERY_TEMP_DIR
    Directory where the Data Vault Service stores temporary files.
    Default is $USER_INSTALL_DIR$/temp.
    QUERY_SHARE_DIR
    Directory where the Data Vault Service stores temporary files for GROUP BY and ORDER BY queries. This directory must be accessible to the Data Vault Agent. If you install multiple agents, this directory must be accessible to all agents.
    Default is $USER_INSTALL_DIR$/share.
    QUERY_INDEX_DIR
    Directory where the Data Vault Service stores index files when you create indexes for archived tables.
    Default is $USER_INSTALL_DIR$/index.
    EXPORT_BUFFSIZE
    The size (in MB) of the internal buffer used for an export operation.
    Default is 512.
    SERVICE_LOG_DIR
    Directory where the Data Vault Service stores service logs.
    Default is $USER_INSTALL_DIR$/fas_logs.
    NUCLEUS_META_PORT
    Port number that the Data Vault Service uses to connect to the Data Vault repository. Default is 50501.
    NUCLEUS_CACHE
    Maximum amount of memory that the Data Vault Service uses for caching during database operations.
    The cache can have a minimum of 64 megabytes and a maximum of 1024 megabytes of memory. Default is 1024 MB.
    If this property is set to a value that is not within the allowed range, the Data Vault Service uses the default.
    FAS_CONNECTION_NAME
    Name of the connection to the Data Vault Service that the installer creates. Client applications can use this connection to connect to the Data Vault Service for query requests. Default name is
    fas
    .
    DEFAULT_USERNAME
    Name of the default administrator user account. The Data Vault Administration Tool, command line program, and other client applications use this user account to connect to the Data Vault.
    The installer sets the name of the user account to
    dba
    . You cannot change the user name during installation.
    DEFAULT_PASSWORD
    Password for the default administrator user account.
    DEFAULT_HOST
    Host name or IP address of the machine that hosts the Data Vault Service.
    On Windows, you can install the Data Vault and the Data Vault Agent as Windows services. You can configure the service for automatic startup. You can also specify the user account to run the service. By default, the service runs under the LocalSystem user account. You can run the Windows service under a different user account.
    You can set the following parameters to configure the Data Vault and the Data Vault Agent as Windows services:
    Property
    Description
    INSTALL_AS_SERVICE
    Indicates whether to install the Data Vault Service as a Windows service. Default is False.
    Set this option to True to install the component as a Windows service. Set this property if the INSTALL_FAS or INSTALL_FAS_AGENT property is set to True.
    STARTER_NO_OF_AGENTS
    Number of instances of the Data Vault Agent to start immediately after the Data Vault Service starts. Default is 2.
    STARTER_AUTO_START
    Indicates whether to start the Windows service immediately after the machine starts. Default is False.
    Set this option if the INSTALL_AS_SERVICE option is set to True.
    STARTER_USE_SYSTEM_USER
    Indicates whether to run the Windows service under the LocalSystem account. Default is True.
    Set this option to False to run the Windows service under another user account.
    STARTER_USE_OTHER_USER
    Indicates whether to run the Windows service under another user account that you specify. If you do not set this option, the service runs under the LocalSystem account. Default is False.
    Set this option to True to run the Windows service under another user account.
    STARTER_OTHER_USERNAME
    User account with which to run the Windows service. Use the following format:
    DomainName\UserAccount
    This user account must have the Act as operating system permission.
    Required if the STARTER_USE_OTHER_USER option is set to True.
    STARTER_OTHER_USER_PWD
    Password for the user account that runs the Windows service.
    Required if the STARTER_USE_OTHER_USER option is set to True.
  4. Save the properties file with the name SilentInput.properties.

0 COMMENTS

We’d like to hear from you!