Skip Navigation Links | |
Exit Print View | |
Oracle Directory Server Enterprise Edition Administration Guide 11g Release 1 (11.1.1.5.0) |
Part I Directory Server Administration
2. Directory Server Instances and Suffixes
3. Directory Server Configuration
6. Directory Server Access Control
7. Directory Server Password Policy
8. Directory Server Backup and Restore
9. Directory Server Groups, Roles, and CoS
10. Directory Server Replication
13. Directory Server Attribute Value Uniqueness
15. Directory Server Monitoring
Part II Directory Proxy Server Administration
16. Directory Proxy Server Tools
17. Directory Proxy Server Instances
Working With Directory Proxy Server Instances
To Create a Directory Proxy Server Instance
To Find the Status of a Directory Proxy Server Instance
To Start and Stop Directory Proxy Server
To List All the Running Instances
To View Whether It Is Necessary to Restart a Directory Proxy Server Instance
Configuring Directory Proxy Server Instances
To Display the Configuration of Directory Proxy Server Instance
To Modify the Configuration of Directory Proxy Server
To Configure the Proxy Manager
Configuration Changes Requiring Server Restart
Backing Up and Restoring Directory Proxy Server Instances
To Back Up a Directory Proxy Server Instance
To Restore a Directory Proxy Server Instance
19. Directory Proxy Server Certificates
20. Directory Proxy Server Load Balancing and Client Affinity
21. Directory Proxy Server Distribution
22. Directory Proxy Server Virtualization
23. Virtual Data Transformations
24. Connections Between Directory Proxy Server and Back-End LDAP Servers
25. Connections Between Clients and Directory Proxy Server
26. Directory Proxy Server Client Authentication
27. Directory Proxy Server Logging
28. Directory Proxy Server Monitoring and Alerts
Part III Directory Service Control Center Administration
When you create an instance of Directory Proxy Server, the files and directories required for the instance are created in the path that you specify.
In this procedure, you create a server instance on the local host using the dpadm command. You then configure the instance using the dpconf command.
Non-root users can create server instances.
A Directory Proxy Server instance must be configured to proxy directory client application requests to data sources through data views. When you start or stop an instance, you start or stop the server process that proxies directory client application requests.
The dpadm command enables you to manage a Directory Proxy Server instance and the files belonging to that instance on the local host. The command does not allow you to administer servers over the network, but only directly on the local host. The dpadm command has subcommands for each key management task. For a complete description, see dpadm(1M).
The dpconf command is an LDAP client. The command enables you to configure nearly all server settings on a running Directory Proxy Server instance from the command line. You can configure settings whether the server is on the local host or another host that is accessible across the network. The dpconf command has subcommands for each key configuration task. For a complete description, see dpconf(1M).
You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.
If you use DSCC to create a new server instance, you can choose to copy some or all of the server configuration settings from an existing server.
$ dpadm create -p port instance-path
For example, to create a new instance in the directory /local/dps, use this command:
$ dpadm create -p 2389 /local/dps
To specify any other parameter of the instance, see the dpadm(1M) man page.
$ dpadm info instance-path
|
Access DSCC using http://hostname:8080/dscc7 or https://hostname:8181/dscc7 as per your application server configuration.
$ dsccreg add-server -h hostname --description "My Proxy" /local/dps Enter DSCC administrator's password: /local/dps is an instance of DPS Enter password of "cn=Proxy Manager" for /local/dps: Connecting to /local/dps Enabling DSCC access to /local/dps Registering /local/dps in DSCC on hostname.
See dsccreg(1M) for more information about the command.
You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.
$ dpadm info instance-path
You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.
dpadm list-running-instances [--all]
The -–all option lists the running instances from any installation path.
dpadm stop-running-instances [-i] [--force]
For more information, see dpadm(1M).
Sometimes, a configuration change requires the server to be restarted before the change takes effect. Use this procedure to check whether it is necessary to restart a Directory Proxy Server instance after a configuration change.
$ dpconf get-server-prop -h host -p port is-restart-required
If the command returns true, you must restart the instance of Directory Proxy Server.
If the command returns false, it is not necessary to restart the instance of Directory Proxy Server.
You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.
$ dpadm restart instance-path
For example, to restart an instance at /local/dps, use this command:
$ dpadm restart /local/dps
You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.
$ dpadm stop instance-path
If you do not stop the instance, the delete command will stop it automatically. However, if you have enabled the instance in a service management solution, you must stop it manually.
$ dsccreg remove-server /local/dps Enter DSCC administrator's password: /local/dps is an instance of DPS Enter password of "cn=Proxy Manager" for /local/dps: Unregistering /local/dps from DSCC on localhost. Connecting to /local/dps Disabling DSCC access to /local/dps
For details, see the dsccreg(1M) man page.
|
$ dpadm delete instance-path