Table of Contents

Search

  1. Preface
  2. Product Overview
  3. Security
  4. Applications
  5. Partner and Account Information
  6. Events
  7. Event Archiving
  8. User Policies
  9. Schedules
  10. B2B Data Exchange Administrative Tasks
  11. On-boarding Checklist Template
  12. System Properties
  13. Repository Management
  14. Document Management
  15. B2B Data Exchange Utilities
  16. Dashboard and Reports Management

Administrator Guide

Administrator Guide

Repository Utility Command Syntax

Repository Utility Command Syntax

Use the repository utility syntax to define the actions that you want to perform on the
B2B Data Exchange
repository.
The repository utility uses the following syntax:
repoutil <-c|--command> command <-t|contentType> contentType
<-l|--url> “url”
<-u|--user> user <-p|--password> password
[--authmode mode]
[--sysadmin name] [--docStore docStore] [--file file]
[--forceDelete]
[-Ddx.kerberos.initial.administrator] [-Ddx.pwc.domain.gateway] [-Ddx.kerberos.krb5.file] [-Ddx.kerberos.console.keytab.file] [-Ddx.kerberos.console.service.principal.name]
The following table describes the repository utility options and arguments:
Options
Argument
Description
- c
--command
command
Required. Command to run on the repository. Enter one of the following commands:
  • createContent. Initializes the repository. Use this command after you run the repository utility with the deleteContent command.
  • CreateOdsContent. Initialized the operational data store. Use this command after you run the repository utility with the deleteODSContent command
  • createSchema. Creates the tables and views in the repository.
  • createOdsSchema. Creates the tables and views in the operational data store.
  • deleteContent. Removes all content from the repository. If you use this command, you must run the repository utility with the createContent command before you can use the repository again.
  • deleteOdsContent. Removes all content from the operational data store. If you use this command, you must run the repository utility with the createOdsContent command before you can use the operational data store again.
  • deleteSchema. Deletes all tables and views in the repository.
  • deleteOdsSchema. Deletes all tables and views in the operational data store.
  • loadProperties. Loads and sets
    B2B Data Exchange
    system properties and event attributes in the
    B2B Data Exchange
    repository.
  • migrateToISP. Switches the authentication mode to Informatica domain authentication and deletes all user information from the
    B2B Data Exchange
    repository.
    For details see the section "Switching to Informatica Domain Authentication".
    You can synchronize
    B2B Data Exchange
    with the Informatica security domain when you switch authentication modes. Create a
    .PROPERTIES
    file with the properties dx.authentication.groups, dx.pwc.domain.gateway, dx.pwc.user, and dx.pwc.password, and enter the file path in the
    --file
    command to load the properties from the file.
    You can also synchronize the users after you switch authentication modes on the
    Users
    page of the Operation Console.
  • migrateToISPKerberos. Switches the authentication mode to Informatica domain with Kerberos authentication. Deletes synchronized users from the
    B2B Data Exchange
    repository and adds the system administrator that is defined by the command argument
    -Ddx.kerberos.initial.administrator
    .
    For details see the section "Switching to Informatica Domain with Kerberos Authentication".
  • migrateToNative. Switches the authentication mode to
    B2B Data Exchange
    native authentication and deletes synchronized users from the
    B2B Data Exchange
    repository.
    For details see the section "Switching to Native Authentication".
  • moveDocumentStore. Moves the document store directory to a different location. Enter the absolute file path of the location to which you want to move the document store in the
    --file
    command.
  • upgradeSchema. Upgrades the repository to the latest version.
  • upgradeOdsSchema. Upgrades the operational data store to the latest version.
  • verifyContents. Verifies the contents of the
    B2B Data Exchange
    repository.
-t
--contentType
contentType
Required. Specifies on which repository the command runs. Specify one of the following options:
  • dx.
    B2B Data Exchange
    repository.
  • dx_ods. Operational data store.
-l
-- url
"url"
Optional. JDBC URL for the
B2B Data Exchange
repository
or for the operational data store
. You must enclose the URL in quotation marks. For example:
repoutil -c createContent -l “jdbc:informatica:oracle:// //oracle_1:1521;SID=orcl”...
-u
--user
user
Optional. User name for the database account to use when the utility connects to the
B2B Data Exchange
repository or for the operational data store.
-p
--password
password
Optional. Password for the database account to use when the utility connects to the
B2B Data Exchange
repository or for the operational data store.
--authMode
mode
Optional for the createContent command. The argument determines the authentication mode to set. Specify one of the following options:
  • native. Native authentication.
  • isp. Informatica platform authentication.
--sysadmin
name
Required for the following commands:
  • migrateToNative
  • createContent if the --authMode parameter value is native
Creates an administrator user account that you use to log in to the Operation Console.
By default, the password for the administrator user account is the same as the user name. If --authMode has the value "isp", this option is ignored.
--docStore
docStore
Required for the moveDocumentStore command. Absolute path of the directory to which to move the document store. The directory must have the same access permissions as the current directory.
You cannot move the document store to a subdirectory of the current document store directory. For example, if current document store directory is
c:\DocStore
, you cannot move the document store to the following directory:
c:\DocStore\newstore
If the repository utility fails when you run the moveDocumentStore command, you can resume the move with the same value in the --docStore command.
On Windows operating systems, you must use forward double slashes (//) in the file path.
--file
file
Optional for the loadProperties, migrateToISPKerberos, migrateToISP, and verifyContents commands.
Enter the following file name in the command:
The commands use the file to determine the connection properties of the publication repository. Each property must appear on a separate line in the following format:
<propertyName>=<propertyValue>
--configFile
propertyFile
Optional for all the repository commands. Points to the location of the
B2B Data Exchange
configuration property file. If not specified,
B2B Data Exchange
loads the file from the following location:
<
DX
InstallationDir>/conf/dx-configuration.properties
--createVersion
version
Optional. If you run the createSchema command, you can use this option to specify the version of the product for which to create the repository. The product version consists of numbers separated by periods. For example:
9.5.1
. By default, the product version is set to the latest version.
--forceDelete
Optional for the deleteSchema command. Deletes the repository schema regardless of errors. By default, the deleteSchema command does not delete the repository schema if it encounters errors.
-Ddx.kerberos.initial.administrator
user
Required for the migrateToISPKerberos command. Kerberos user that exists in the Informatica security domain, in the following format:
<username>@<SECURITY_DOMAIN>
You must enter
<SECURITY_DOMAIN>
in uppercase letters. For example:
Administrator@DEVELOPMENT.COM
-Ddx.pwc.domain.gateway
host
Required for the migrateToISPKerberos command. Gateway machine to the Informatica domain. For example:
host:6005
-Ddx.kerberos.krb5.file
file
Required for the migrateToISPKerberos command. Location of the Kerberos configuration file. This file usually resided in the same location as the PowerCenter configuration file.
-Ddx.kerberos.console.keytab.file
file
Required for the migrateToISPKerberos command. Location of the keytab file.
If
B2B Data Exchange
is installed on the same machine as the PowerCenter Administrator Console, the keytab file is the same file that is used for the service principal
HTTP/<hostname>@<domain>
, the file
webapp_http.keytab
.
If
B2B Data Exchange
is installed on a different machine than the PowerCenter Administrator Console, the keytab file must contain the credentials for the service principal
HTTP/<
DX
hostname>@<domain>
.
-Ddx.kerberos.console.service.principal.name
name
Required for the migrateToISPKerberos command. Service principal host name in the following format:
HTTP/<FQDN>@<REALM NAME>
For exampe:
HTTP/webserver.development.com@DEVELOPMENT.COM

0 COMMENTS

We’d like to hear from you!