Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
LDAP-UX Client Services B.04.10 with Microsoft Windows Active Directory Administrator's Guide: HP-UX 11i v1 and v2 > Appendix C Command, Tool, Schema Extension Utility, and Migration Script Reference

Client Management Tools

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

This section describes the following programs for managing client systems. Most of these programs are called by the setup program during system configuration.

  • create_profile_entry—creates a new profile in the directory.

  • create_profile_cache—creates a new active profile from an LDIF profile. This is also called by the get_profile_entry tool.

  • create_profile_schema—extends the schema in the directory for profiles.

  • display_profile_cache—displays the currently active profile.

  • get_profile_entry—downloads a profile from the directory to LDIF, and creates the profile cache.

  • ldap_proxy_config—configures a proxy user.

create_profile_entry

This tool, found in /opt/ldapux/config, creates a new profile entry in the LDAP directory from information you provide interactively. The directory schema must have the DUAConfigProfile extension.

Syntax

create_profile_entry

create_profile_cache

This tool, found in /opt/ldapux/config, creates a binary profile file from an LDIF profile file, thus activating the profile for the client. (You can download a profile to LDIF from the directory with get_profile_entry.) Typically you run the setup program instead of running this program directly. Also refer to “Downloading the Profile Periodically”.

Syntax

create_profile_cache [-i infile] [-o outfile]

where infile is the LDIF file containing a profile, by default/etc/opt/ldapux/ldapux_profile.ldif and outfile is the name of the binary output file, by default /etc/opt/ldapux/ldapux_profile.bin. The LDIF file must contain an entry for the object class DUAConfigProfile.

Examples

The following command creates the binary profile file /etc/opt/ldapux/ldapux_profile.bin from the existing LDIF file /etc/opt/ldapux/ldapux_profile.ldif:

create_profile_cache

The following command creates the binary profile file my_profile.bin from the existing LDIF file profile1.ldif:

create_profile_cache -i profile1.ldif -o my_profile.bin

NOTE: You must copy the file my_profile.bin to/etc/opt/ldapux/ldapux_profile.bin to activate the profile.

create_profile_schema

This tool, found in /opt/ldapux/config, extends the Active Directory schema with the DUAConfigProfile object class using the information you provide interactively. Typically you run the setup program instead of running this program directly.

Syntax

create_profile_schema

display_profile_cache

This tool, found in /opt/ldapux/config, displays information from a binary profile (cache) file. By default, it displays the currently active profile in /etc/opt/ldapux/ldapux_profile.bin.

Syntax

display_profile_cache [-i infile] [-o outfile]

where infile is a binary profile file, /etc/opt/ldapux/ldapux_profile.bin by default, and outfile is the output file, stdout by default.

The binary profile contains mappings for all backend commands (even those that are unused or unsupported by LDAP-UX Client Services with Active Directory); all of which are displayed by display_profile_cache. The actual client configuration can be reviewed in the configuration profile LDIF file /etc/opt/ldapux/ldapux_profile.ldif.

Examples

The following command displays the profile in the binary profile file /etc/opt/ldapux/ldapux_profile.bin to stdout:

display_profile_cache

The following command displays the profile in the binary profile file my_profile.bin and writes the output to the file profile:

display_profile_cache -i my_profile.bin -o profile

get_profile_entry

This tool, found in /opt/ldapux/config downloads a profile from an LDAP directory into an LDIF file and calls create_profile_cache to create a binary profile file, thereby activating it on the client. This tool looks in the local client configuration file /etc/opt/ldapux/ldapux_client.conf for the profile DN.

Syntax

get_profile_entry -s service [-o outfile] 
[-D bindDN -w passwd] [-p profile_id]

where service is the name of a supported service, typically NSS, outfile is the name of a file to contain the LDIF output, by default /etc/opt/ldapux_profile.ldif, and profile_id is <remote domain name> or gc for PROFILE_ID field in /etc/opt/ldapux/ldapux_client.conf. The -p option only applies if you want to configure multiple domains.

Examples

  • The following command downloads the profile for the NSS specified in the client configuration file /etc/opt/ldapux/ldapux_client.conf and places the LDIF in the file /etc/opt/ldapux/ldapux_profile.ldif.

    bindDN and password need to be provided if no valid proxy user is configured:

    get_profile_entry -s NSS -D bindDN -w passwd
  • The following command downloads the profile for the NSS specified in the client configuration file /etc/opt/ldapux/ldapux_client.confand places the LDIF in the file profile1.ldif:

    get_profile_entry -s NSS -o profile1.ldif -D bindDN -w passwd
  • The following command downloads the profile for the NSS and PROFILE_ID (ldap.ca.com) specified in the client configuration file /etc/opt/ldapux/ldapux_client.conf and places the LDIF in the file /etc/opt/ldapux/domain_profiles/ldapux_profile.ldif.ldap.ca.com:

    get_profile_entry -s NSS -D bindDN -w passwd -p ldap.ca.com
  • The following command downloads the profile for the Name Service Switch (NSS) and PROFILE_ID (gc) specified in the client configuration file /etc/opt/ldapux/ldapux_client.confand places the LDIF in the file /etc/opt/ldapux/domain_profiles/ldapux_profile.ldif.gc

    get_profile_entry -s NSS -D bindDN -w passwd -p gc

ldap_proxy_config

This tool, found in /opt/ldapux/config, configures a proxy user for the client accessing the directory. It stores the encrypted proxy user information in the file /etc/opt/ldapux/pcred. You must run this tool logged in as root.

Syntax

ldap_proxy_config [options]

where options can be any of the following:

-e

erases the currently configured proxy user from the file /etc/opt/ldapux/pcred. Has no effect on the proxy user information in the directory itself.

-i

configures the proxy user interactively from stdin. Enter the command with -ithen press the Enter key. Next enter the proxy user DN then press the Enter key. Finally enter the proxy user credential or password and press the Enter key.

-f file

configures the proxy user from file. file must contain two lines: the first line must be the proxy user DN, and the second line must be the proxy user credential or password.

CAUTION: After using the -f file option you should delete or protect the file as it could be a security risk.
-d DN

configures the proxy user distinguished name to be DN.

-c passwd

configures the proxy user credential or password to be passwd.

-p

prints the DN of the current proxy user.

-v

verifies the current proxy user and credential by connecting to the server.

-h

displays help on this command.

With no options, ldap_proxy_config configures the proxy user as specified in the file /etc/opt/ldapux/pcred.

Examples

  • The following example configures the proxy user as CN=Proxy User,CN=Users,DC=cup,DC=hp,DC=com with the password prox12pw and creates or updates the file /etc/opt/ldapux/pcredwith this information:

    ldap_proxy_config -i
    CN=Proxy User,CN=Users,DC=cup,DC=hp,DC=com
    prox12pw
  • The following example displays the current proxy user:

    ldap_proxy_config -p
    PROXY_DN: CN=Proxy User,CN=users,DC=cup,DC=hp,DC=com
  • The following example checks the configured proxy user information and checks whether or not the client can bind to the directory as the proxy user with LDAP-UX Client Services B.03.10 or earlier:

    ldap_proxy_config -v
    File Credentials verified - valid
  • The following example configures the proxy user as CN=Proxy User,CN=Users,DC=cup,DC=hp,DC=com with the password prox12pw and creates or updates the file /etc/opt/ldapux/pcred with this information:

    ldap_proxy_config -d "CN=Proxy User,CN=Users,DC=cup,DC=hp,DC=com" \
    -c prox12pw
  • The following example configures the proxy user with the contents of the file proxyfile and updates the file /etc/opt/ldapux/pcredwith this information (the pcred file must exist first):

    ldap_proxy_config -f proxyfile

    The file proxyfile must contain two lines: the proxy user DN on the first line and password on the second line.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2006 Hewlett-Packard Development Company, L.P.