Master Note for Delegated Administrator (Delegated Administrator Console, "commadmin" CLI and Delegated Administrator Server)
(Doc ID 1300904.1)
Last updated on NOVEMBER 30, 2018
Applies to:Oracle Communications Delegated Administrator - Version 7.0.0 and later
Information in this document applies to any platform.
This is the Master Note for Delegated Administrator, which is a component of the Oracle Communications Unified Communications Suite.
The Master Note for the Suite may be found here - Oracle Communications Unified Communications Suite Master Note (Doc ID 1297190.1)
- Users of Delegated Administrator (TLA, SPA, and BOA/OA)
- System administrators installing, patching, configuring, and maintaining Delegated Administrator
- LDAP Administrators who have Directory Server DIT's provisioned by Delegated Administrator
- Deployment architects who are designing deployments of Delegated Administrator
Understanding the structure of components in Delegated Administrator is the most important thing you need to know.
#1: Delegated Administrator is a sophisticated LDAP editor for the Communications Suite.
For most people, it will work better than any other tool, such as ldapmodify and other product-specific tools.
#2: Delegated Administrator is a client-server environment.
The server, Delegated Administrator Server (DA Server), connects to your Directory Server. (In earlier versions, it did so via Access Manager). It runs inside a web container.
The clients are Delegated Administrator Console (DA Console) and "commadmin".
DA Console runs in a web container as well. It is a web "front-end", so you use your supported browser-of-choice.
The commadmin utility is a line command client. Most customers simply install it on the same system as the DA server, and ssh to that system, so it runs as a local utility. It can be installed on any system that is a supported Communications Suite platform, and can make a connection to a DA Server.
#3. Is Access Manager used by your installation?
- If DA 6.4, what version of AM?
- If DA 7, what mode? See: Delegated Administrator - How to Set and Confirm "directory access mode" [ID 1471500.1]
- If access mode, what version of AM?
#4. What web container is being used?
If you are initially installing Delegated Administrator, the best place to begin is with the Delegated Administrator Installation and Configuration Guide.
Check Your Version
To identify the steps you will use to maintain your Delegated Administrator installation, you should begin with identifying which versions and patches you currently have installed. To identify the versions and patches you have installed:
Delegated Administrator Console
Login as any delegated administrator.
Click on the "Version" button (upper left).
Use the command with -V.
Ex: commadmin -V
look for the appropriate patch base.
Ex. showrev -p | grep "enter_patch_base_here"
Delegated Administrator 7
The current version is DA22.214.171.124.0 See: Where are the patches for Delegated Administrator? (Doc ID 1283053.1)
- 124581-11 - Oracle Communications Delegated Administrator commcli 7.0-11.00 / 126.96.36.199.0: Solaris: core patch
- 124582-11 - Oracle Communications Delegated Administrator commcli 7.0-11.00_x86 / 188.8.131.52.0 Solaris_x86: core patch
- 124583-11 - Oracle Communications Delegated Administrator commcli 7.0-11.00 / 184.108.40.206.0 RHEL4.0 RHEL5.0: core patch
- CommsInstaller Based Patch 20640136 (all platforms) - for use with commpkg upgrade to install it rather than patchadd.
Delegated Administrator 6.4*
- 121581-21 - commcli 6.4-3.03 SunOS 5.9 5.10: core patch
- 121582-21 - commcli 6.4-3.03_x86: core patch
- 121583-21 - commcli 6.4-3.03 RHEL3.0 RHEL4.0: core patch
*Contact support if these patches are needed
Review General Guidelines
- It is strongly recommended that patch updates are first tested out in a development environment before applying a patch to the production environment.
- It is recommended that you update Delegated Administrator to the latest build, however if you are not experiencing problems there is no immediate need to update.
- When patching and maintaining your Delegated Administrator Installation you will be applying "Communications Products Admin CLI" components as the method of installing a patch.
- Effort is made to keep this article updated, however best practice is to also check My Oracle Support for additional patches.
IMPORTANT: This article focuses on patches for the Delegated Administrator. You may also need to install other patches, depending upon which feature of Delegated Administrator are used.
Perform the Steps for patch upgrading
Review Additional Patches Requirements
Depending upon your features, you may also need to install additional patches. This Note only focuses on the patches to maintain the core Delegated Administrator. Check the Patches and Updates section of My Oracle Support for patches related to other features.
The Delegated Administrator's critical application dependencies are the Directory Server and the web container (Web or Application Server).
Other Important Knowledge Base Information
To stay informed of important issues related to Delegated Administrator, set your My Oracle Support Headlines and My Oracle Support Hot Topics to email you information on Delegated Administrator. Please see Doc ID 166650.1, "Working Effectively With Global Customer Support."
The most recent product documentation may be found here:
- Delegated Administrator 7.0 Documentation
In addition, the following are the most commonly referenced sections of the Admin Guide:
- E Delegated Administrator Reference (commadmin command)
- 4 Removing Users, Groups, and Services from a Domain
$DA_BASE - The base directory of the DA installation.
- By default /opt/sun/comms/da (in other words $INSTALL_ROOT + "/da").
- In Comms 5, this was /opt/SUNWcomm.
- This should be used in all MOS/KM articles.
- This is a shell-friendly equivalent of "da-base", and "DelegatedAdmin-base", used in product documentation
- NOTE: "DelegatedAdminConfig-base" should not be used in KM articles, except for the worksheet and describing user input to config-commda. (When you give DelegatedAdminConfig-base to config-commda, it saves it by creating $DA_BASE/config as a soft link to DelegatedAdminConfig-base.)
Previous Release Documentation
- Delegated Administrator 6.4 Documentation (In the Comms 6U1 pdf)
- Delegated Administrator 6.4 Documentation (In the Comms 6 pdf)
Typically, a customization describes a change to a file in the web property, that is deployed to the web container. In Delegated Administrator documentation, customization is used more losely in some cases, to describe "configurations that happen in post-config".
The documentation provides several pages that describe "customizations", which is actually a collection of sample changes to various files.
The types of customizations described in the documentation are supported, but technical support does not perform the development and deployment of a customer's customization.
Customer should also consider informing support when performing a customization, because not conceivable customization will work as expected. For example. changing the logger.properties files is a customization, and it is supported. However, other lines in other property files may not work as a customer would expect.
- Delegated Administrator 6.x does not support Calendar 7 (Doc ID 1284333.1)
- DA7: product upgrades and patch upgrades should complete the config-commda session (Doc ID 1280841.1)
- Deleting Messaging Server, Calendar Server, and Communications Express Users
- commadmin domain purge Fails with Error: "5079:The resource removal utility for each service must be run before domain can be purged." (Doc ID 1411396.1)
- DA 7 Doesn't Follow Consumer Referral In Ldap: err=9 Received (Doc ID 1414964.1)
For Delegated Administrator 6.x:
- Sun Java[TM] System: Adding Mail User with commadmin Results in "Service UserMailService not registered" Error (Doc ID 1005008.1)
- (Serious problem) with HTTP Response Splitting in Sun Java System Delegated Administrator [ID 1020305.1]
To view full details, sign in with your My Oracle Support account.
Don't have a My Oracle Support account? Click to get started!
In this Document
|Check Your Version|
|Delegated Administrator Console|
|Delegated Administrator 7|
|Review General Guidelines|
|Perform the Steps for patch upgrading|
|Review Additional Patches Requirements|
|Other Important Knowledge Base Information|
|Oracle Unified Communications Compatibility Matrix|
|Previous Release Documentation|
|For Delegated Administrator 6.x:|