Use the Profiles population wizard in silent mode
Run the Profiles population wizard in silent mode to populate the Profiles database.
Before starting
When you use the Profiles population wizard in interactive mode, the wizard automatically creates a response file called tdisettings.properties in the Wizards/TDIPopulation directory in the IBM Connections set-up directory. You can, if necessary, modify the existing response file or create a new one.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 Lotus Connections TAR file, and enter the following command to extract the files from it:
gtar -xvf <Lotus_Connections_wizard>_aix.tar
This command creates a directory named after the wizard.
About this task
To run the Profiles population wizard in silent mode...
Procedure
- Log in to your database server as the root user or system administrator.
- (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
- Ensure that the Profiles population wizard has created the tdisettings.properties response file in the TDIPopulation directory.
- 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 Lotus Domino defaultMapping_domino.properties IBM Tivoli Directory Server 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 use 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, 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, 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, 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.
The tdisettings.properties file
When you run the Profiles population wizard, you can record your selections in two response files: a tdisettings.properties file and a mapping file.
Parent topic
Add LDAP data to the Profiles databaseRelated concepts
Administer Profiles
Related tasks
Use the Profiles population wizard
Manually populating the Profiles database
Mapping fields manually
Populating the Profiles databaseRelated reference
Attribute mapping for Profiles
Population functions for populating ID into PROF_GUID