Using the idsync command - Oracle Identity Synchronization for Windows 6.0 Installation and Configuration Guide

Using the `idsync` command

You use the idsync command and subcommands to execute the Identity Synchronization for Windows command line utility.

Note - The idsync command converts all DN-valued arguments (such as bind DN or suffix name) from the character set specified for that window to UTF-8 before sending the arguments to Directory Server.

Do not use backslashes as escape characters in suffix names.

To specify UTF-8 characters on Solaris and on Linux, your terminal window must have a locale based on UTF-8. Make sure that the environmental variable’s LC_CTYPE and LANG.are set correctly.

Unless specifically noted otherwise, you can run the idsync command with subcommands using either of the following methods:

From Solaris:
1. Open a terminal window and cd to the /opt/SUNWisw/bin directory.
2. Type the idsync command with one subcommand, as follows
  
  idsync subcommand
From Linux:
1. Open a terminal window and cd to the /opt/sun/isw/bin directory.
2. Type the idsync command with one subcommand, as follows
  
  idsync subcommand
From Windows:
1. Open a Command Window and cd to the install_path\isw-hostname\bin directory.
2. Type the idsync command with one subcommand, as follows
  
  idsync subcommand
  
  Using the idsync command lists all of the idsync utility subcommands and their purpose:

Table A-4 Quick Reference to idsync Subcommands

Subcommand	Purpose
`certinfo`	Displays certificate information based on your configuration and SSL settings (see Using certinfo)
`changepw`	Changes the Identity Synchronization for Windows configuration password (see Using changepw)
`importcnf`	Imports an exported Identity Synchronization for Windows version 1.0 configuration XML document (see Using importcnf)
`prepds`	Prepares a Sun Java System Directory Server source for use by Identity Synchronization for Windows (see Using prepds)
`printstat`	Displays a list of steps you must perform to complete the installation/configuration process. Also provides the status of installed connectors, the system manager, and the Message Queue (see Using printstat)
`resetconn`	Resets connector states in the configuration directory to uninstalled (see Using resetconn)
`resync`	Links and resynchronizes existing users or groups and pre-populates directories as part of the installation process (see Using resync)
`groupsync`	Synchronizes group information between users and groups from one directory source to another (see Using groupsync)
`accountlockout`	Synchronizes account lockout and unlockout between Directory Server and Active Directory sources (see Using accountlockout)
`dspluginconfig`	Configures and unconfigures Directory Server plugin on a specified host (see Using dspluginconfig)
`startsync`	Starts synchronization (see Using startsync)
`stopsync`	Stops synchronization (see Using stopsync)

Using certinfo

You can use the certinfo subcommand to display certificate information based on your configuration and SSL settings. This information can help you determine which certificates must be added for each connector and/or Directory Server Plug-in certificate database.

To display certificate information, open a terminal window (or Command Window) and type the idsync certinfo command as follows:

idsync certinfo [bind-DN] -w bind-password | - 
[-h Configuration Directory-hostname] [-p Configuration Directory-port-no] 
[-s rootsuffix] -q configuration_password [-Z] 
[-P cert-db-path] [-m secmod-db-path]

Note - Because the certinfo subcommand does not have access to the connectors’ and Directory Server’s certificate databases, some of the required steps it lists might have already been performed.

For example:

idsync certinfo -w admin-password -q configuration-password

Note - For detailed information about the certinfo arguments, review Common Arguments to the Idsync Subcommands.

Using changepw

You can use the changepw subcommand to change the Identity Synchronization for Windows configuration password.

Skip Navigation Links
Exit Print View
	Oracle Identity Synchronization for Windows 6.0 Installation and Configuration Guide