Using the Profiles population wizard in silent mode

You can run the Profiles population wizard in silent mode to populate the Profiles database.

Before you begin

When you run the Profiles population wizard in silent mode, it creates the map_dbrepos_from_source.properties file, located in the Wizards\TDIPopulation\platform\TDI directory, and updates this file with data from the mappings.properties file.

Note: When you use the Profiles population wizard in interactive mode, the wizard creates a response file called tdisettings.properties in the Wizards\TDIPopulation directory. You can modify the existing response file or create a new one. It also creates a mappings.properties file, which contains properties very similar to those in map_dbrepos_from_source.properties file.

If you need to configure multiple systems with Profiles data, you can run the wizard in silent mode.

You can also modify the mappings files manually. For more information, see the Mapping fields manually topic.

Note:

  • (AIX® only) If you are downloading the wizard, the TAR program available by default with AIX does not handle path lengths longer than 100 characters. To overcome this restriction, use the GNU file archiving program instead. This program is an open source package that IBM® distributes through the AIX Toolbox for Linux™ Applications at the IBM AIX Toolbox web site. Download and install the GNU-compatible TAR package. You do not need to install the RPM Package Manager because it is provided with AIX.

    After you have installed the GNU-compatible TAR program, change to the directory where you downloaded the IBM Connections TAR file, and enter the following command to extract the files from it:

    gtar -xvf IBM_Connections_5.5_wizards_lin_aix.tar

    This command creates a directory named after the wizard.

About this task

To run the Profiles population wizard in silent mode, complete the following steps:

Procedure

  1. Log in to your database server as the root user or system administrator.
  2. (AIX and Linux only) Grant display authority to all users by running the following commands under the root user or system administrator:
    xhost + // Grant display authority to other users
    Note: If granting display authority to all users is a security concern for you, change the command to grant display authority to a specific user or users. For more information about this command, consult your AIX or Linux administrator guide.

    echo $DISPLAY // Echo the value of DISPLAY under the root user

  3. Ensure that the Profiles population wizard has created the tdisettings.properties response file in the TDIPopulation directory.
  4. Open a command prompt, change to the TDIPopulation directory, and enter the following commands to launch the wizard in silent mode:
    • AIX/Linux:

      • populationWizard.sh -silent response_file

        [ -mappingFile mapping_file]

        [ -dbPassword db_password]

        [ -ldapPassword ldap_password]

        [ -sslPassword ssl_password]

        [ -help | -? | /help | /? | -usage]

    • Windows®:

      • populationWizard.bat -silent response_file

        [ -mappingFile mapping_file]

        [ -dbPassword db_password]

        [ -ldapPassword ldap_password]

        [ -sslPassword ssl_password]

        [ -help | -? | /help | /? | -usage]

    where response_file is the full path to the tdisettings.properties response file, mapping_file is the full path to the mappings.properties file, dbPassword is the password for the Profiles database, ldapPassword is the password for bind user in the LDAP directory, and sslPassword is the password for the SSL key store.

    Note:
    If you do not specify a mapping file, the default mapping file for your LDAP directory type is used. These mapping files are located in the Wizards/TDIPopulation directory, where you can edit the file for your LDAP directory type. For more information about editing the mapping file, see the Mapping fields manually topic. The following table lists the mappings files for applicable LDAP directory types:
    Table 1. Options to specify a supported LDAP directory
    Directory type Mapping file
    IBM Domino® defaultMapping_domino.properties
    IBM Tivoli® Directory Integrator defaultMapping_tivoli.properties
    Microsoft® Active Directory Application Mode defaultMapping_adam.properties
    Microsoft Windows Server 2003 Active Directory defaultMapping_ad.properties
    Novell Directory Services defaultMapping_nds.properties
    Sun ONE defaultMapping_sun.properties
    The parameters for running the population wizard in silent mode are described in the following table:
    Table 2. Command parameters
    Parameter Value Description
    responseFile (required) full path to the tdisettings.properties response file After running the population wizard successfully, the tdisettings.properties response file is stored in the Wizards\TDIPopulation directory in the IBM Connections set-up directory.
    mappingFile (optional) full path to the mappings.properties file The mappings.properties file is stored in the Wizards\TDIPopulation directory in the IBM Connections set-up directory. If you do not specify a different file with the -mappingFile parameter, the wizard uses this file to map properties to the LDAP directory.
    dbPassword (optional) Database password Overwrites the database password in the response file. If you do not specify the database password here, you must specify it in the response file.
    ldapPassword (optional) LDAP password Overwrites the LDAP password in the response file. If you do not specify the LDAP password here, you must specify it in the response file.
    sslPassword (optional) SSL key store password Overwrites the SSL key store password in the response file. If you do not specify the SSL password here, you must specify it in the response file.

Results

After the wizard has finished, check the log file in the <user home>/lcwizard/log/tdi/ directory for messages. The log file name uses the time as a suffix. For example: tdi_20090912_163536.log.