The interactive mode provides a text interface to control and use the DirXML Command Line utility.
At the console, enter dxcmd.
Enter the name of a user with sufficient rights to the Identity Manager objects, such as admin.novell.
Enter the user’s password.
Enter the number of the command you want to perform.
Table 12-1 contains the list of options and what functionality is available.
Enter 99 to quit the utility.
NOTE:If you are running eDirectory 8.8 on UNIX or Linux, you must specify the -host and -port parameters. For example, dxcmd -host 10.0.0.1 -port 524. If the parameters are not specified, a jclient error occurs.
novell.jclient.JCException: connect (to address) 111 UNKNOWN ERROR
By default, eDirectory 8.8 is not listening to localhost. The DirXML Command Line utility needs to resolve the server IP address or hostname and the port to be able to authenticate.
Table 12-1 Interactive Mode Options
Option |
Description |
---|---|
1: |
Starts the driver. If there is more than one driver, each driver is listed with a number. Enter the number of the driver to start the driver. |
2: |
Stops the driver. If there is more than one driver, each driver is listed with a number. Enter the number of the driver to stop the driver. |
3: |
Lists the operations available for the driver. If there is more than one driver, each driver is listed with a number. Enter the number of the driver to see the operations available. For a list of operations, see Table 12-2. |
4: |
Lists the operations available for the driver set. For a list of operations, see Table 12-3. |
5: |
Lists the operations available for logging events through Novell Audit. For a description of these options, see Table 12-6. |
6: |
Lists the version of the Identity Manager installed. |
7: |
Manages jobs created for Identity Manager. |
99: |
Exits the DirXML Command Line utility. |
Figure 12-1 Driver Options
Table 12-2 Driver Options
Options |
Description |
---|---|
1: |
Starts the driver. |
2: |
Stops the driver. |
3: |
Lists the state of the driver.
|
4: |
Lists the current driver start option.
|
5: |
Changes the start option of the driver.
|
6: |
Forces a resynchronization the driver. It prompts for a time delay: If you enter Yes, specify the date and time you want the resynchronization to occur: .If you enter No, the resynchronization occurs immediately. |
7: |
Processes an XML document that contains a query command: Create the XML document that contains a query command by using the Novell nds.dtd. Examples: NetWare: sys:\files\query.xml Windows: c:\files\query.xml Linux: /files/query.xml |
8: |
Submits an XDS command document to the driver’s Subscriber channel, bypassing the driver cache. The document is processed before anything that might be in the cache at the time of the submission. It also means that the submission fails if the driver is not running.
Examples: Windows: c:\files\user.xml Linux: /files/user.xml
Examples: Windows: c:\files\user.log Linux: /files/user.log |
|
Submits an XDS event document to the driver’s Subscriber channel, bypassing the driver cache. The document is processed before anything that might be in the cache at the time of the submission. It also means that the submission fails if the driver is not running.
Examples: Windows: c:\files\add.xml Linux: /files/add.xml |
|
Submits a document to the driver’s Subscriber channel by queuing the document in the driver cache. The document is processed after anything that might be in the cache at the time of the submission. The submission does not fail if the driver is not running.
Examples: Windows: c:\files\add.xml Linux: /files/add.xml |
11: |
Validates that an object’s password in the connected system is associated with a driver. It matches the object’s eDirectory password (Distribution Password, used with Universal Password). : |
12: |
Performs an internal initialization of data on a new Driver object. This is only for testing purposes. |
13: |
There are nine Password options. See Table 12-4 for a description of these options. |
14: |
There are five Cache operations. See Table 12-5 for a descriptions of these options. |
99: |
Exits the driver options. |
<nds dtdversion="1.1" ndsversion="8.6" xml:space="default"> <input> <add class-name="User" src-dn="Doe John"> <association>JDoe@novell.com</association> <add-attr attr-name="LastName"> <value type="string">John</value> </add-attr> <add-attr attr-name="FirstName"> <value type="string">Doe</value> </add-attr> <add-attr attr-name="Email"> <value type="string">JDoe@novell.com</value> </add-attr> </add> </input> </nds>
<nds dtdversion="3.5" ndsversion="8.x"> <source> <product version="3.5.11.4223">DirXML</product> <contact>Novell, Inc.</contact> </source> <input> <add cached-time="20080519102858.809Z" class-name="User" eventid= "blr-krajiv-sles#20080519102858#1#1" qualified-srcdn= "O=n\OU=People\CN=JDoe" src-dn="\KRAJIV-LINUXTREE\n\People\JDoe" src-entry-id="32956" timestamp="1211192938#9"> <add-attr attr-name="Internet EMail Address"> <value timestamp="1211192938#8" type="string">JDoe@novell.com</value> </add-attr> <add-attr attr-name="Given Name"> <value timestamp="1211192938#5" type="string">John</value> </add-attr> <add-attr attr-name="Surname"> <value timestamp="1211192938#9" type="string">Doe</value> </add-attr> </add> </input> </nds>
Figure 12-2 Driver Set Operations
Table 12-3 Driver Set Operations
Operation |
Description |
---|---|
|
Adds a driver set to the server after which the driver set becomes active. |
|
Removes a driver set from the server after which the driver set becomes inactive. |
|
Exports the DirXML server's public key certificate which is used for encrypting data when setting passwords. |
|
Makes the DirXML Engine regenerate the public key/private key pair which is used for encrypting data when setting passwords. |
5: Passwords operations |
There are four password operations. For description of these operations, see the operations 5, 6, 7, and 99 in the Table 12-4. |
|
Lists the default reciprocal attribute mappings. |
|
Makes the DirXML Engine regenerate all server-specific encryption keys. |
99: |
Exits the current menu and takes you back to the DirXML commands. |
Figure 12-3 Password Operations
Table 12-4 Password Operations
Operation |
Description |
---|---|
1: |
Sets the application password. This is the password of the user account you are using to authenticate into the connected system with. |
2: |
Clears the application password. |
3: |
The Remote Loader password is used to control access to the Remote Loader instance. Enter the Remote Loader password, then confirm the password by typing it again. |
4: |
Clears the Remote Loader password so no Remote Loader password is set on the Driver object. |
5: |
Allows you to store a password or other pieces of security information on the driver. See Section 9.0, Securely Storing Driver Passwords with Named Passwords for more information. There are four prompts to fill in: |
6: |
Clears a specified Named Password or all Named Passwords that are stored on the driver object: If you enter Yes, all Named Passwords are cleared. If you enter No, you are prompted to specify the password name that you want to clear. |
7: |
Lists all Named Passwords that are stored on the driver object. It lists the password name and the password description. |
8: |
Lists if a password is set for:
The dxcmd utility allows you to set the Application password and the Remote Loader password. You cannot set the Driver Object password with this utility. It shows if the password has been set or not. |
99: |
Exits the current menu and takes you back to the Driver options. |
Figure 12-4 Cache Operations
Table 12-5 Cache Operations
Operation |
Description |
---|---|
1: |
Displays the current cache limit that is set for the driver. |
2: |
Sets the driver cache limit in kilobytes. A value of 0 is unlimited. |
3: |
A text file is created with the events that are stored in cache. You can select the number of transactions to view.
|
4: |
Deletes the transactions stored in cache.
|
99: |
Exits the current menu and takes you back to the Driver options. |
Figure 12-5 Log Event Operations
Table 12-6 Log Events Operations
Operation |
Description |
---|---|
1: |
Allows you to log driver set events through Novell Audit. There are 49 items you can select to log. See Table 12-7 for a list of these options. Enter the number of the item you want to log. After the items are selected, enter 99 to accept the selections. |
2: |
Resets all of the log event options. |
3: |
Allows you to log driver events through Novell Audit. There are 49 items to select to log. See Table 12-7 for a list of these options. Enter the number of the item you want to log. After the items are selected, enter 99 to accept the selections. |
4: |
Resets all of the log event options. |
99: |
Exits the log events operations menu. |
Table 12-7 Driver Set and Driver Log Events
Options |
---|
1: Status success |
2: Status retry |
3: Status warning |
4: Status error |
5: Status fatal |
6: Status other |
7: Query elements |
8: Add elements |
9: Remove elements |
10: Modify elements |
11: Rename elements |
12: Move elements |
13: Add-association elements |
14: Remove-association elements |
15: Query-schema elements |
16: Check-password elements |
17: Check-object-password elements |
18: Modify-password elements |
19: Sync elements |
20: Pre-transformed XDS document from shim |
21: Post input transformation XDS document |
22: Post output transformation XDS document |
23: Post event transformation XDS document |
24: Post placement transformation XDS document |
25: Post create transformation XDS document |
26: Post mapping transformation <inbound> XDS document |
27: Post mapping transformation <outbound> XDS document |
28: Post matching transformation XDS document |
29: Post command transformation XDS document |
30: Post-filtered XDS document <Publisher> |
31: User agent XDS command document |
32: Driver resync request |
33: Driver migrate from application |
34: Driver start |
35: Driver stop |
36: Password sync |
37: Password request |
38: Engine error |
39: Engine warning |
40: Add attribute |
41: Clear attribute |
42: Add value |
43: Remove value |
44: Merge entire |
45: Get named password |
46: Reset Attributes |
47: Add Value - Add Entry |
48: Set SSO Credential |
49: Clear SSO Credential |
50: Set SSO Passphrase |
51: User defined IDs |
99: Accept checked items |
Table 12-8 Job Operations
Options |
Description |
---|---|
1: |
Allows you to select an existing job.
Enter Yes or No
Examples: Windows: c:\files\user.log Linux: /files/user.log |
2: |
Allows you to perform operations for a specific job.
The following list of options is displayed: |