Previous | Contents | Next |
This chapter tells you where to download Directory Server Enterprise Edition software, and lists primary installation requirements.
This chapter includes the following sections:
Refer to the Oralce Directory Services blog for the most current information about the Directory Server product line.
Before you start with the product installation, make sure you read your Oracle terms and conditions.
Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 is a patch release that corrects known issues in the Directory Server Enterprise Edition versions 6.0 through 6.3, including some enhancements in the Directory Server and Directory Proxy Server. The following highlights important changes in this release:
The repack of the database now can be applied to individual database files.
The dsadm repack command repacks or compacts an existing suffix. Usage:
dsadm repack [-b backend][ -T FILE_TYPE ...] INSTANCE_PATH SUFFIX_DN [SUFFIX_DN...]
The -b option enables you to specify the name of the backend instead of the suffix name. At least one suffix DN or one backend name must be specified.
The -T option specifies which type of file needs to be repacked. Possible values are entries|indexes|changelog.
The server instance must be stopped before running this command.
The Directory Proxy Server part of Directory Enterprise Edition Bundle Patch 6.3.1.1.1 also adds the following new properties:
Dynamic (no restart required)
Dynamic (no restart required)
Level: ldap-data-source
Type: string
Default : base
Description : This property specifies the scope (base, subtree, one) used in a search operation. The availability monitor uses the search operation to test a connection to the data source.
Dynamic (no restart required)
Level: abstract-data-view
Type: boolean
Default: true
Description: Specifies whether the data view handles searches whose search base is handled by another data view.
Dynamic (no restart required)
Level: abstract-data-view
Type: string (LDAP filter string) Example: objectClass=person
Default: none
Description: Controls retrieval of secondary entries; secondary entries are retrieved only if the primary entry matches that filter.
Native package distributions are not supported for Linux and Windows platforms.
Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 is a maintenance release that is applied to an existing installation of Directory Server Enterprise Edition 6.3.1. You cannot apply Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 to an installation of Directory Server that is not version 6.3.1.
You can download Sun Java System Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 software from My Oracle Support. My Oracle Support serves as a starting point to direct you to the proper downloads depending upon the distribution type you need to download.
Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 is available in the following distributions.
Native package distribution (available for Solaris only)
Contains native patches to upgrade installed Directory Server Enterprise Edition 6.3.1 native packages.
Zip distribution (available for Solaris, Linux, HP-UX, and Windows)
Contains zip-based patches to upgrade Directory Server Enterprise Edition 6.3.1 zip installations, and to upgrade 6.3.1 native installations on Solaris, Linux , HP-UX, and Windows platforms.
Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 is available through My Oracle Support. For information on patch numbers, see Installation Instructions.
For the detailed information on what you need to install based on your current installation, refer to Installation Instructions.
This section covers hardware requirements for Directory Server Enterprise Edition component products.
Directory Server software requires the following hardware.
Component |
Platform Requirement |
---|---|
RAM |
1-2 GB for evaluation purposes Minimum 2 GB for production servers |
Local disk space |
400 MB disk space for binaries. By default, binaries installed from native packages are placed in /opt on UNIX systems. For evaluation purposes, an additional 2 GB local disk space for server software might be sufficient. If you are using Directory Server, consider that entries stored in Directory Server use local disk space. Directory Server does not support logs and databases installed on NFS-mounted file systems. Sufficient space should be provided for the database on a local file system in, for example, /var/opt or /local. For a typical production deployment with a maximum of 250,000 entries and no binary attributes such as photos, 4 GB might be sufficient. Directory Server may use more than 1.2 GB of disk space for its log files. This should be taken into account that 4 GB storage space is only for the databases, not the logs. Directory Server supports SAN disk storage. Before using SAN disk, you need to understand the layout and the design of the disk because the write performance of the system is affected if many applications simultaneously access data from the same disk. Directory Server does not support NAS disk storage. |
Directory Proxy Server software requires the following hardware.
Component |
Platform Requirement |
---|---|
RAM |
1-2 GB for evaluation purposes Minimum 2GB for production servers |
Local disk space |
400 MB disk space for binaries. By default, binaries installed from native packages are placed in /opt on UNIX systems. For evaluation purposes, an additional 2 GB local disk space per server instance is sufficient to hold server logs when the default configuration is used. Directory Proxy Server does not support installation on NFS-mounted file systems. Sufficient space should be provided for the instance, and for all files used by the instance on a local file system in, for example, /var/opt or /local. Directory Server does not support NAS disk storage. |
This section covers operating systems, patches and service packs required to support Directory Server Enterprise Edition component products.
Directory Server, Directory Proxy Server, and Directory Server Resource Kit share the same operating system requirements. The Directory Server Enterprise Edition software has been validated with full installations of the operating systems listed here, not with reduced “base”, “End User”, or “core” installations. Certain operating systems require additional service packs or patches as shown in the following table. For more information, go to My Oracle Support.
Supported OS Versions for Directory Server, Directory Proxy Server, and Directory Server Resource Kit |
Additional Required Software and Comments |
---|---|
Solaris 10 Operating System for SPARC, 32-bit x86, Intel x64, and AMD x64 architectures |
Patches:
|
Solaris 9 Operating System for SPARC and x86 architectures |
Patches:
|
Red Hat Enterprise Linux Advanced Server AS and ES 3.0 Update 4 for x86 and AMD x64 |
Supported only for the zip distribution of Directory Server Enterprise Edition. No additional software is required. On 64–bit Red Hat systems, Directory Server runs in 32–bit mode but Directory Proxy Server runs in 64–bit mode. |
Red Hat Enterprise Linux Advanced Server AS and ES 4.0 Update 2 for x86 and AMD x64 |
Supported only for the zip distribution of Directory Server Enterprise Edition. The following compatibility libraries are recommended: compat-gcc-32-3.2.3-47.3.i386.rpm compat-gcc-32-c++-3.2.3-47.3.i386.rpm The following compatibility library is required: compat-libstdc++-33-3.2.3-47.3.rpm Even when running Red Hat on a 64-bit system, 32-bit system libraries are installed. These compatibility libraries are available from Red Hat media or https://www.redhat.com/rhn/rhndetails/update/. On 64–bit Red Hat systems, Directory Server runs in 32–bit mode but Directory Proxy Server runs in 64–bit mode. |
SuSE Linux Enterprise Server 10 for x86 and AMD x64 |
Service Pack 1 Supported only for the zip distribution of Directory Server Enterprise Edition. On 64–bit SuSE systems, Directory Server runs in 32–bit mode but Directory Proxy Server runs in 64–bit mode. |
SuSE Linux Enterprise Server 9 for x86 and AMD x64 |
Service Pack 4 Supported only for the zip distribution of Directory Server Enterprise Edition. On 64–bit SuSE systems, Directory Server runs in 32–bit mode but Directory Proxy Server runs in 64–bit mode. |
Microsoft Windows 2000 Server |
Service Pack 4 Supported only for the zip distribution of Directory Server Enterprise Edition. Microsoft ended support for Windows 2000 in July, 2010. |
Microsoft Windows 2000 Advanced Server |
Service Pack 4 Supported only for the zip distribution of Directory Server Enterprise Edition. Microsoft ended support for Windows 2000 in July, 2010. |
Microsoft Windows 2003 Server Standard Edition |
Service Pack 2 Supported only for the zip distribution of Directory Server Enterprise Edition. |
Microsoft Windows 2003 Server Enterprise Edition |
Service Pack 2 Supported only for the zip distribution of Directory Server Enterprise Edition. |
Note - Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 cannot be executed on Windows Microsoft 2008 |
|
Hewlett Packard HP-UX 11iV2 |
(11.23) PA-RISC 64–bit Supported only for the zip distribution of Directory Server Enterprise Edition. |
For all supported versions of Microsoft Windows, Directory Server and Directory Proxy Server run only in 32–bit mode, and the filesystem type must be NTFS.
To download the patch cluster for your Solaris OS and Java ES versions, go to My Oracle Support.
Note that installations on SuSE Linux Enterprise Server require you to reset several Java environment variables. See Sun Java System Directory Server Enterprise Edition 6.3 Installation Guide for more details.
Directory Server relies on the Network Security Services, NSS, layer for cryptographic algorithms. NSS has been validated to work with the Sun cryptographic framework provided on Solaris 10 systems, which supports cryptographic acceleration devices.
On Microsoft Windows systems, Directory Server requires ActivePerl software to use account activation and manual schema replication commands. Directory Server Enterprise Edition does not provide ActivePerl. The dependency concerns the following commands. For detailed command information, see the Sun Java System Directory Server Enterprise Edition 6.3 Man Page Reference.
ns-accountstatus
ns-activate
ns-inactivate
schema_push
On Microsoft Windows systems, you must disable the pop-up blocker to make Directory Service Control Center work properly.
The Directory Service Control Center supports the following application servers:
Sun Java System Application Server 8.2.
Tomcat 5.5.
For more information, see “Installing Directory Service Control Center from Zip Distribution” in the Sun Java System Directory Server Enterprise Edition 6.3 Installation Guide.
Directory Proxy Server will work with any LDAPv3 compliant directory servers, but it is tested only with Sun Java System Directory Server 6.x, Sun Directory Server Enterprise Edition 7.0 , Oracle Directory Server Enterprise Edition 11g R1, and Oracle Unified Directory 11g.
For virtualization, Directory Proxy Server has been validated with the following JDBC data sources, using the drivers mentioned below.
JDBC Data Source |
JDBC Driver |
---|---|
DB2 v9 |
IBM DB2 JDBC Universal Driver Architecture 2.10.27 |
JavaDB 10.2.2.0 |
Apache Derby Network Client JDBC Driver 10.2.2.0 |
Microsoft SQL Server 2005 |
sqljdbc.jar 1.2.2323.101 |
MySQL 5.0 |
MySQL-AB JDBC Driver mysql-connector-java-5.0.4 |
Oracle 9i DatabaseOracle 10g Database |
Oracle JDBC driver 10.2.0.2.0 |
On Microsoft Windows systems, the dsee_deploy command cannot properly register software with the Common Agent Container, cacao, when you run the command from an MKS shell. This can occur when your MKS PATH does not include the system-drive:\system32 folder. Alternatively, run the command on the Microsoft Windows native command line.
On Solaris 10, rc.scripts are deprecated so commands like dsadm autostart are not supported. Instead use Solaris 10 Service Management Facility (SMF) to handle these types of requests. For example, dsadm enable-service. For more information on SMF, see the Solaris operating system documentation.
You can run Identity Synchronization for Windows in a firewall environment. The following sections list the server ports that you must expose through the firewall.
Each Directory Server plug-in must be able to reach the Directory Server connector’s server port, which was chosen when the connector was installed. Plug-ins that run in Directory Server Master replicas must be able to connect to Active Directory’s LDAP, port 389, or LDAPS, port 636. The plug-ins that run in other Directory Server replicas must be able to reach the master Directory Server LDAP and LDAPS ports.
By default, Message Queue uses dynamic ports for all services except for its port mapper. To access the Message Queue broker through a firewall, the broker should use fixed ports for all services.
After installing the core, you must set the imq.<service_name>.<protocol_type>.port broker configuration properties. Specifically, you must set the imq.ssljms.tls.port option. Refer to the Message Queue documentation for more information.
The Identity Synchronization for Windows installer must be able to communicate with the Directory Server acting as the configuration directory.
If you are installing an Active Directory connector, the installer must be able to contact Active Directory’s LDAP port, 389.
If you are installing a Directory Server connector or a Directory Server plug-in (subcomponent), the installer must be able to contact the Directory Server LDAP port, default 389.
The Message Queue, system manager, and command line interface must be able to reach the Directory Server where the Identity Synchronization for Windows configuration is stored.
The Identity Synchronization for Windows console must be able to reach the following:
Active Directory over LDAP, port 389, or LDAPS, port 636
Active Directory Global Catalog over LDAP, port 3268, or LDAPS, port 3269
Each Directory Server over LDAP or LDAPS
Administration Server
Message Queue
All connectors must be able to communicate with Message Queue.
In addition, the following connector requirements must be met.
The Active Directory connector must be able to access the Active Directory Domain Controller over LDAP, port 389, or LDAPS, port 636.
The Directory Server connector must be able to access Directory Server instances over LDAP, default port 389, or LDAPS, default port 636.
The following table displays the browsers for each operating system that supports Directory Service Control Center.
Operating System |
Supported Browser |
---|---|
Solaris 10 and Solaris 9 (SPARC and x86) |
Netscape Communicator 7.1, Mozilla 1.7.12, and Firefox 1.0.7, 1.5, and 2.0 |
Red Hat Linux 4, Red Hat Linux 3 and SuSE Linux |
Mozilla 1.7.12 and Firefox 1.0.7, 1.5, and 2.0 |
Windows XP |
Netscape Communicator 8.0.4, Microsoft Internet Explorer 6.0SP2 and 7.0, Mozilla 1.7.12, and Firefox 1.0.7, 1.5, and 2.0 |
Windows 2000/2003 |
Netscape Communicator 8.0.4, Microsoft Internet Explorer 6.0 SP1 and 7.0, Mozilla 1.7.12, and Firefox 1.0.7, 1.5, and 2.0. Microsoft stopped supporting Windows 2000 in July, 2010. Bundle Patch 6.3.1.1.1 supports only the platforms that were certified at the time of the Directory Server Enterprise Edition 6.3.1 release. Bundle Patch 6.3.1.1.1 is not intended to be compatible with platforms or web browsers that are certified for post-6.3.1 releases. If you plan to use more recent OS or web browser versions, then you should upgrade to Oracle Directory Server Enterprise Edition 11gR1. |
This section covers privileges or credentials required for installation of Directory Server Enterprise Edition component products.
You must have the following privileges when installing Directory Server, Directory Proxy Server, or Directory Service Control Center from the Java Enterprise System native package based distribution.
On Solaris, you must install as root.
On Windows systems, you must install as Administrator.
You can install Directory Server, Directory Proxy Server, and Directory Server Resource Kit from the zip distribution without special privileges. See the Sun Java System Directory Server Enterprise Edition 6.3 Installation Guide for details.
Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 delivers bug fixes mainly for Directory Service Control Center, Directory Proxy Server, and Directory Server. Only the upgrade mode is offered within version 6.3.1.1.1 using Native Packages or ZIP distribution.
Upgrade is supported only from Directory Server Enterprise Edition 6.3.1 to Bundle Patch 6.3.1.1.1. If you are using a pre-6.3.1 Directory Server Enterprise Edition version , you must upgrade to Directory Server Enterprise Edition 6.3.1 before you can apply Bundle Patch 6.3.1.1.1.
This section covers the following parts.
Upgrading Directory Server Enterprise Edition to 6.3.1.1.1 Using Native Packages
Upgrading Directory Server Enterprise Edition to 6.3.1.1.1 Using ZIP distribution
Upgrading Directory Server Enterprise Edition 6.3.1 Native Packages to a 6.3.1.1.1 Zip installation
The following table identifies information for you to use to upgrade Directory Server Enterprise Edition to version 6.3.1.1.1 based on your current installation and the type of distribution you are using.
Table 2-1 Upgrade Paths to Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1
Current Directory Server Enterprise Edition Version |
Software Distribution |
Related Information |
---|---|---|
6.3.1 |
Zip |
Apply Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 zip distribution. See Upgrading Directory Server Enterprise Edition to 6.3.1.1.1 Using ZIP distributionin Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 Release Notes (this document). |
6.3.1 |
Native Packages (Solaris) |
Apply Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 native distribution. See Upgrading Directory Server Enterprise Edition to 6.3.1.1.1 Using Native Packages in Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 Release Notes (this document). |
6.3.1 |
Native Packages (Linux or Windows) |
Apply the Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 zip distribution. See Upgrading Directory Server Enterprise Edition 6.3.1 Native Packages to a 6.3.1.1.1 Zip installation in Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 Release Notes (this document). |
6.0, 6.1, 6.2 or 6.3 |
Zip |
Upgrade to Directory Server Enterprise Edition 6.3.1 prior to applying Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1.
|
6.0, 6.1, 6.2 or 6.3 |
Native Packages |
Upgrade to Directory Server Enterprise Edition 6.3.1 prior to applying the Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1. To upgrade to version 6.3.1, see Upgrading Directory Server Enterprise Edition to 6.3.1 Using Native Packages in Sun Java System Directory Server Enterprise Edition 6.3.1 Release Notes |
5.x |
Zip or Native Packages (Solaris) |
For best results, migrate to Oracle Directory Server Enterprise Edition 11g R1. See “Migrating Directory Server Enterprise Edition 5.2 to Version 11g Release 1 (11.1.1.5.0)” in Oracle Directory Server Enterprise Edition Upgrade and Migration Guide 11 g Release 1 (11.1.1.5.0). |
None |
Zip |
For best results, install Oracle Directory Server Enterprise Edition 11gR1 . See “Installing Directory Server Enterprise Edition Using Zip Distribution” in Oracle Directory Server Enterprise Edition Installation Guide 11 g Release 1 (11.1.1.5.0) . |
None |
Native Packages (Solaris) |
For best results, install Oracle Directory Server Enterprise Edition 11gR1. See “Installing and Uninstalling Directory Server Enterprise Edition Using Native Packages” in Oracle Directory Server Enterprise Edition Installation Guide 11 g Release 1 (11.1.1.5.0) . |
Note - In general, it is a good practice to back up the directory databases regularly and particularly before upgrading the directory server. See the Sun Java System Directory Server Enterprise Edition 6.3 Administration Guide for information about backing up the database.
You must stop all Directory Server and Directory Proxy Server instances before applying Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1.
All Directory Server and Directory Proxy Server instances, including the DSCC registry, must be stopped before Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 is applied.
To use the localized console, apply the Directory Server Enterprise Edition 6.3.1 localized patch (if it is not already applied) before the Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1. If you apply the Bundle Patch 6.3.1.1.1 before applying the 6.3.1 localization patch, then run the following commands in the specified order.
# dsccsetup console-unreg # dsccsetup console-reg
For more information, see bug 12207124/6583131 in Known Directory Server Issues in Bundle Patch 6.3.1.1.1.
All Directory Server and Directory Proxy Server instances must be stopped before the Directory Server Enterprise Edition Bundle Patch 6.3.1.1.1 zip distribution is applied on top the 6.3.1 zip installation.
Note that the patchzip is not applied to the Directory Service Control Center until you undeploy and then redeploy the WAR file. This requirement is related to bug 124/65831311 in Known Directory Server Issues in Bundle Patch 6.3.1.1.1.
Before You Begin
Before upgrading Directory Server Enterprise Edition to 6.3.1 using native packages, you must upgrade the shared components. On Solaris systems you must be root to perform this procedure.
Using patches, you can upgrade shared components on Solaris. .
Select the platform as per your requirements and install all the patches specified for that platform. If newer patch revisions become available, use the newer ones instead of those shown in the table. Note that DPS631U1 has been upgraded to 6.3.1.1.1 and validated with the level of shared components listed in this table
Description |
Solaris 10 SPARC and Solaris 9 SPARC |
Solaris 10 x86, AMD x64 and Solaris 9 x86 |
---|---|---|
International Components for Unicode (ICU) |
119810-05 (Solaris 10)114677-15 (Solaris 9) |
119811-05 (Solaris 10)114678-15 (Solaris 9) |
Simple Authentication and Security Layer (SASL) |
119345-07 (Solaris 10)115342-08 (Solaris 9) |
119346-07 (Solaris 10)115343-08 (Solaris 9) |
JDK 5.0u30 |
118667-32 (Solaris 10 64-bit and Solaris 9 64-bit)118666-32 (Solaris 10 32-bit and Solaris 9 32-bit) |
118669-32 (Solaris 10)118668-32 (Solaris 9) |
Sun Java Web Console (SJWC) |
125952-20 (Solaris 10)125950-20 (Solaris 9) |
125953-20 (Solaris 10)125951-20 (Solaris 9) |
Network Security Services/Netscape Portable Runtime/Java Security Services (NSS/NSPR/JSS) |
Refer to the table below for complete patch information. |
Refer to the table below for complete patch information. |
Java Dynamic Management Kit Runtime |
119044-04 |
119044-04 |
Common Agent Container Runtime |
123893-25 |
123896-25 |
Sun Java Monitoring Framework (MFWK) |
125444-13 |
125446-13 (Solaris 10 64-bit and Solaris 10 32-bit)125445-13 (Solaris 10 32-bit and Solaris 9 32-bit) |
Sun LDAP C SDK 6.0 |
136798–05 |
136799–05 (Solaris 9 x86) 136800–05 (Solaris 10 x86 and AMD64) |
Choose the right NSS/NSPR/JSS patch for your system by getting the package version of SUNWpr and SUNtls on your system.
# pkginfo -l SUNWpr | grep VERSION # pkginfo -l SUNWtls | grep VERSION
Then choose the right patch series from the table below.
Solaris |
Package Version |
Network Security Services/Netscape Portable Runtime/Java Security Services (NSS/NSPR/JSS) patch |
---|---|---|
Solaris 9 SPARC |
SUNWpr: VERSION=4.1.2,REV=2002.09.03.00.17 SUNWtls: VERSION=3.3.2,REV=2002.09.18.12.49 |
119211-25 |
Solaris 9 x86 |
SUNWpr: VERSION=4.1.3,REV=2003.01.09.13.59 SUNWtls: VERSION=3.3.3,REV=2003.01.09.17.07 |
119212-25 |
Solaris 10 SPARC |
SUNWpr: VERSION=4.5.1,REV=2004.11.05.02.30 SUNWtls: VERSION=3.9.5,REV=2005.01.14.17.27 |
119213-25 |
Solaris 10 x86 |
SUNWpr: VERSION=4.5.1,REV=2004.11.05.03.44 SUNWtls: VERSION=3.9.5,REV=2005.01.14.19.03 |
119214-25 |
Solaris 9 SPARC and Solaris 10 SPARC |
SUNWpr: VERSION=4.6.4,REV=2006.11.16.20.40 SUNWtls: VERSION=3.11.4,REV=2006.11.16.20.40 |
125358-13 |
Solaris 9 x86 and Solaris 10 x86 |
SUNWpr: VERSION=4.6.4,REV=2006.11.16.21.41 SUNWtls: VERSION=3.11.4,REV=2006.11.16.21.41 |
125359-13 |
# cacaoadm stop # smcswebserver stop
For more information on how to obtain the patches, see Getting the Software.
Read the README.patchID file for detailed patch installation procedures.
Read the README.patchID file for verification procedure.
# cacaoadm start # smcswebserver start
$ cd /var/mps/serverroot/lib $ ln -s /usr/lib/mps/secv1/libnssdbm3.so libnssdbm3.so $ ln -s /usr/lib/mps/secv1/libnssutil3.so libnssutil3.so $ ln -s /usr/lib/mps/secv1/libsqlite3.so libsqlite3.so $ cd /var/mps/serverroot/lib/sparcv9 $ ln -s /usr/lib/mps/secv1/sparcv9/libnssdbm3.so libnssdbm3.so $ ln -s /usr/lib/mps/secv1/sparcv9/libnssutil3.so libnssutil3.so $ ln -s /usr/lib/mps/secv1/sparcv9/libsqlite3.so libsqlite3.so
Before You Begin
Make sure all the shared components are up-to-date. For more information, see To Upgrade Shared Components Using Patches.
If you already have Directory Server Enterprise Edition 6.3.1 installed, upgrade to version 6.3.1.1.1 using the following procedure.
You must be root to perform these steps.
All the Directory Server instances, Directory Proxy Server instances, and configuration information remain unaffected after you complete the Directory Server Enterprise Edition upgrade.
The following table displays the patch numbers that are required to upgrade Directory Server Enterprise Edition on different platforms. If newer patch revisions become available, use the newer ones instead of those shown in the table.
Description |
Directory Server Enterprise Edition Core |
Directory Server Enterprise Edition Localization |
---|---|---|
Patch ID: Solaris SPARC |
125276-09 |
125937-06 |
Patch ID: Solaris 9 x86 |
125277-09 |
125938-06 |
Patch ID: Solaris 10 x86 or AMD x64 |
125278-09 |
125938-06 |
Note - To make the localized Directory Server Enterprise Edition work successfully, install the localized patches before installing the core patches.
Each localization patch contains all the supported languages for the selected platform.
# dsadm stop /var/opt/SUNWdsee/dscc6/dcc/ads
See Getting the Software for more details.
Before upgrading Directory Server Enterprise Edition, you must install 119254-38 on Solaris 10 SPARC and 119255-38 on Solaris 10 x86. See Getting the Software for information on downloading patches.
Alternatively, use -G with the patchadd command on Solaris 10 SPARC and Solaris 10 x86 while applying the Directory Server Enterprise Edition upgrade patch. For example:
# patchadd -G patch-id
For other versions of Solaris, use the following command:
# patchadd patch-id
# dsadm start /var/opt/SUNWdsee/dscc6/dcc/ads
Before You Begin
You can install the zip distribution as a non-root user.
Note - In general, it is a good practice to back up the directory databases regularly, and particularly before upgrading the Directory Server. You cannot restore an earlier Directory Server configuration later. This advice applies to both Zip and Native Packages installations. See the Sun Java System Directory Server Enterprise Edition 6.3 Administration Guide for information about backing up the database.
The dsee_deploy command automatically updates the installation if it finds any previous installation. However, in the case of SuSE Linux 9 and HP-UX, before you upgrade the Directory Server Enterprise Edition installation, you must first upgrade the operating system to SuSE Linux 9 SP4 and HP-UX 11.23 respectively. Then use following procedure to upgrade your Directory Server Enterprise Edition installation to 6.3.1.1.1.
Upgrade SuSE Linux 9 SP3 to SuSE Linux 9 SP4.
On SuSE 64-bit, .pam-32bit-9-yyyymmddhhmm.rpm is a prerequisite for CACAO to start, and you must install it if it is not already present on your system.
Refer to the operating system documentation for information about how to upgrade the operating system, how to preserve the partition where Directory Server Enterprise Edition is installed, and where to get the latest patch bundles.
Refer to the following table for information about the appropriate zip patch for your system. If newer patch revisions become available, use the newer ones instead of those shown in the table.
All the multilingual files are included in the above mentioned patches.
Operating System |
Patch number |
---|---|
Solaris SPARC |
126748-06 |
Solaris 9 x86 |
126749-06 |
Solaris 10 x86 and AMD x64 |
126750-06 |
Red Hat Linux |
126751-06 |
SuSE Linux |
126751-06 |
HP-UX |
126752-06 |
Windows |
126753-06 |
$ ./dsee_deploy install -i install-path -p cacao-port options
On Windows installations, browse to the zip distribution folder that contains the dsee_deploy command and run the following command:
dsee_deploy install -i install-path options
For example, the following command upgrades your existing Directory Server Enterprise Edition previously installed at /local directory, assuming that you have write access to the directory.
$ ./dsee_deploy install -i /local
You can also use the --no-inter option to install in non-interactive mode, accepting the license without confirmation. Non-interactive mode is particularly useful for silent installation.
During the installation process, a WAR file is saved on your system. The WAR file contains the DSCC web application which when deployed with the application server enables you to access and manage the server instances through web console. The functionality is similar to DSCC in native packages. For more information about the WAR file, see “Installing Directory Service Control Center From Zip Distribution” in the Sun Java System Directory Server Enterprise Edition 6.3 Installation Guide.
During the installation process, the multilingual packages are also installed.
For step-by- step information, refer to “Installing Directory Service Control Center From Zip Distribution” in the Sun Java System Directory Server Enterprise Edition 6.3 Installation Guide.
To upgrade Directory Server Enterprise Edition 6.3.1 Linux or Windows native packages to a 6.3.1.1.1 zip installation, you must complete the following procedures:
Before You Begin
In general, it is a good practice to back up the directory databases regularly, and particularly before upgrading the Directory Server. You cannot restore an earlier Directory Server configuration later. This advice applies to both Zip and Native Packages installations. See the Sun Java System Directory Server Enterprise Edition 6.3 Administration Guide for information about backing up the database.
# cacaoadm-path list-params
# dsadm-path info ads-path
On Linux
# /opt/sun/ds6/bin/dsconf export -p port cn=dscc /tmp/dscc.ldif
On Windows
# "C:\Program Files\Sun\JavaES5\DSEE\ds6\bin\dsconf.exe" export -p port -e cn=dscc c:\temp\dscc.ldif
Stop all running Directory Servers (including DSCC registry).
# dsadm-path stop instance-path # dsadm-path stop ads-path
Stop all running Directory Proxy Servers.
# dpadm-path stop instance-path
For any Directory Server instance registered to start at boot, type the following command:
# /opt/sun/ds6/bin/dsadm autostart --off instance-path
For any Directory Proxy Server instance registered to start at boot, type the following command:
# /opt/sun/dps6/bin/dpadm autostart --off instance-path
For any Directory Server instance registered to start at boot, type the following command:
# "C:\Program Files\Sun\JavaES5\DSEE\ds6\bin\dsadm.exe" disable-service --type WIN_SERVICE instance-path
For any Directory Proxy Server instance registered to start at boot, type the following command:
# "C:\Program Files\Sun\JavaES5\DSEE\dps6\bin\dpadm.exe" disable-service --type WIN_SERVICE instance-path
# dsccsetup-path cacao-unreg
# cacaoadm-path stop
# dsccsetup-path console-unreg
Run the following command:
# dsee_deploy install -i install-path options
This command works properly only if a Common Agent Container is not yet running on the default port, 11162. If you don't stop your previous Common Agent Container (step 7 of previous section), specify a different port using the -p option.
# dsee_deploy install -i install-path -p port options
This command installs a Common Agent Container with the local Directory Service Control Center agent as well, allowing you to use DSCC to create server instances.
# install-path/dsee6/cacao_2/cacao/bin/cacaoadm list-params
Update if needed:
# install-path/dsee6/cacao_2/cacao/bin/cacaoadm stop # install-path/dsee6/cacao_2/cacao/bin/cacaoadm set-param snmp-adaptor-port=snmp-port # install-path/dsee6/cacao_2/cacao/bin/cacaoadm set-param snmp-adaptor-trap-port=snmp-trap-port # install-path/dsee6/cacao_2/cacao/bin/cacaoadm set-param jmxmp-connector-port=jmxmp-port # install-path/dsee6/cacao_2/cacao/bin/cacaoadm start
# install-path/dsee6/cacao_2/cacao/bin/cacaoadm list-params
Update if needed:
# install-path/dsee6/cacao_2/cacao/bin/cacaoadm stop # install-path/dsee6/cacao_2/cacao/bin/cacaoadm set-param snmp-adaptor-port=snmp-port # install-path/dsee6/cacao_2/cacao/bin/cacaoadm set-param snmp-adaptor-trap-port=snmp-trap-port # install-path/dsee6/cacao_2/cacao/bin/cacaoadm set-param jmxmp-connector-port=jmxmp-port # install-path/dsee6/cacao_2/cacao/bin/cacaoadm start
# install-path/dscc6/bin/dsccsetup ads-create -p port -P secure-port
On Linux
# install-path/ds6/bin/dsconf import -p port /tmp/dscc.ldif cn=dscc
On Windows
# install-path\ds6\bin\dsconf.exe import -p port -e c:\temp\dscc.ldif cn=dscc
# install-path/dscc6/bin/dsccreg remove-server instance_path
# install-path/dscc6/bin/dsccreg add-server instance_path
During the installation process, a WAR file is saved on your system. The WAR file contains the DSCC web application which, when deployed with the application server, enables you to access and manage the server instances through web console.
To Deploy the WAR File with Sun Java System Application Server
Create an application server instance.
$ mkdir /local/domainroot $ setenv AS_DOMAINS_ROOT /local/domainroot $ cd app-server-install-path/bin $ asadmin create-domain --domaindir ${AS_DOMAINS_ROOT} --adminport 3737 \ --adminuser boss dscc
Edit the server.policy file.
Open the server.policy file.
$ vi ${AS_DOMAINS_ROOT}/dscc/config/server.policy
Add the following statements to the end of the file:
// Permissions for Directory Service Control Center grant codeBase "file:${com.sun.aas.instanceRoot}/ applications/j2ee-modules/dscc/-" { permission java.security.AllPermission; };
This configures the application server to grant all of the Java permissions to the DSCC application.
Deploy the WAR file in your application server instance.
$ asadmin start-domain --domaindir ${AS_DOMAINS_ROOT} --user boss dscc $ cp install-path/var/dscc6/dscc.war ${AS_DOMAINS_ROOT}/dscc/autodeploy
For more information about creating and configuring application server instances and deploying the WAR file, refer to the Sun Java System Application Server Online Help.
Open DSCC.
Use http://hostname:8080/dscc or https://hostname:8181/dscc based on the configuration of your application server.
The Directory Service Manager Login page displays.
To Deploy the WAR File with Tomcat
Identify your Tomcat installation and instance.
$ setenv CATALINA_HOME tomcat-install-path $ setenv CATALINA_BASE tomcat-instance-path $ setenv JAVA_HOME jdk-home-dir
For installing Tomcat and creating instances, refer to the Tomcat documentation.
Deploy the WAR file.
Create the DSCC directory as shown below:
$ mkdir ${CATALINA_BASE}/webapps/dscc
Copy the dscc.war file into newly created DSCC folder and unzip the dscc.war file.
$ unzip -d ${CATALINA_BASE}/webapps/dscc install-path/var/dscc6/dscc.war
Add the emphasized text in the ${CATALINA_BASE}/conf/web.xml file as shown below:
... <servlet> <servlet-name>jsp</servlet-name> <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class> <init-param> <param-name>fork</param-name> <param-value>false</param-value> </init-param> <init-param> <param-name>xpoweredBy</param-name> <param-value>false</param-value> </init-param> ... <init-param> <param-name>enablePooling</param-name> <param-value>false</param-value> </init-param> <load-on-startup>3</load-on-startup> </servlet> ....
Verify the permissions of startup.sh (tomcat5.exe on Windows) and run the following command:
$ ${CATALINA_HOME}/bin/startup.sh
Use http://hostname:8080/dscc to connect to DSCC.
The Directory Service Manager Login page displays.
If you plan to uninstall Directory Server Enterprise Edition 6.0, 6.1, 6.2, or 6.3 please refer to the chapter 3. "Uninstalling Directory Server Enterprise Edition" of Sun Java System Directory Server Enterprise Edition Installation Guide for 6.0, 6.1, 6.2, or 6.3. See the Sun Java System Directory Server Enterprise Edition 6.3 Installation Guide.
Previous | Contents | Next |