ODSEE basic installation steps

ORACLE DIRECTORY SERVER ENTERPRISE EDITION BASIC INSTALL STEPS

Installation procedure of Oracle Directory Server Enterprise Edition 11.1.1.5 aka Sun Directory Server Enterprise Edition 7 The installation procedure can be divided into the following steps:

A) Laying out the software elements in the chosen place on a host filesystem.

B) Pre-configuring installation--running the minimum set of commands to make the software installation operational.

C) Checking the installation--running a few commands to confirm if the software is fully operational

--Note that DSEE 7.0 processes run as 32-bit applications on Windows systems.

A)Laying out the software elements in the chosen place on a host filesystem.

1)Unpack the .zip file 'ofm_odsee_win_11.1.1.5.0_disk1_1of1.zip' This contains two folders 'ODSEE_Identity_Synchronization_for_Windows' and 'ODSEE_ZIP_Distribution'. Open the folder 'ODSEE_ZIP_Distribution' and see it contains the following files

'idsktune.exe'-->utility, 'sun-dsee7.zip'  and 'vcredist_x86.exe'-->Microsoft Visual C++ 2008 Redistributable Package

2)Directory Server Enterprise Edition 11g Release 1 (11.1.1.5.0) depends on the Microsoft Visual C++ 2008 Redistributable Package. Double-click and install vcredist_x86 if the Microsoft Visual C++ 2008 Redistributable Package is not already installed on the system.

3.Run the idsktune utility. This is for system checking.. dont worry if this shows any errors.

4.Unpack sun-dsee7.zip where you want to put the software, such as C:\Sun\dsee7. The .zip contains a dsee7 folder that houses all the files you need to keep

B)Pre-configuring installation--running the minimum set of commands to make the software installation operational.

After installing the Directory Server Enterprise Edition software successfully, you must pre-configure the software to make it functional.

This includes the following steps.

--To Pre-Configure "Directory Service Control Center" and the "DSCC Agent"

The Directory Service Control Center (DSCC) is a web-based interface to manage Directory Server and Directory Proxy Server instances.(a web app housed in an application server such as GlassFish, Tomcat, or WebLogic )

1)Initialize the DSCC registry.

(the Directory Server instance DSCC uses to keep track of managed servers. During this step, set and remember the Directory Service Manager password.Directory Service Manager is the DSCC user who has credentials to handle all managed servers.)

C:\Sun\dsee7\bin>dsccsetup ads-create

Choose password for Directory Service Manager:

Confirm password for Directory Service Manager:

Creating DSCC registry...

DSCC Registry has been created successfully

C:\Sun\dsee7\bin>

2)Create theWAR file for DSCC.

C:\Sun\dsee7\bin>dsccsetup war-file-create

Created C:\Sun\dsee7\var\dscc7.war

C:\Sun\dsee7\bin>

3)Note the port and the path assigned to DSCC registry

C:\Sun\dsee7\bin>dsccsetup status

***

DSCC Agent is not registered in Cacao

***

DSCC Registry has been created

Path of DSCC registry is C:/Sun/dsee7/var/dcc/ads

Port of DSCC registry is 3998

***

C:\Sun\dsee7\bin>

4)To create server instances on the same host where DSCC is deployed, register the DSCC agent in the CommonAgent Container (a local service residing in the Common Agent Container, aka Cacao, that allows you to access servers, in particular to start them when they are stopped, and so forth).

C:\Sun\dsee7\bin>dsccsetup cacao-reg

Configuring Cacao...

Cacao will listen on port 21162

Cacao has been successfully configured.

Registering DSCC Agent in Cacao...

Checking Cacao status...

Starting Cacao...

DSCC agent has been successfully registered in Cacao.

C:\Sun\dsee7\bin>

5)status check:::

C:\Sun\dsee7\bin>dsccsetup status

***

DSCC Agent is registered in Cacao

Cacao uses a custom port number (21162)

***

DSCC Registry has been created

Path of DSCC registry is C:/Sun/dsee7/var/dcc/ads

Port of DSCC registry is 3998

DSCC registry is not running. You may start it using:

         C:/Sun/dsee7/bin/dsadm.exe start C:/Sun/dsee7/var/dcc/ads

***

C:\Sun\dsee7\bin>

6)start the dscc registry

C:\Sun\dsee7\bin>dsadm.exe start C:/Sun/dsee7/var/dcc/ads

Waiting for Directory Server instance 'C:/Sun/dsee7/var/dcc/ads' to start...

Directory Server instance 'C:/Sun/dsee7/var/dcc/ads' started: pid=2064

7)status check:::

C:\Sun\dsee7\bin>dsccsetup status

***

DSCC Agent is registered in Cacao

Cacao uses a custom port number (21162)

***

DSCC Registry has been created

Path of DSCC registry is C:/Sun/dsee7/var/dcc/ads

Port of DSCC registry is 3998

***

C:\Sun\dsee7\bin>

8)Deploy theWAR file in any of the supported application server instance.

We are choosing to deploy this war file on to admin server on weblogic server.

start admin server

Browse theWebLogic console using http://localhost:7001/console

Navigate to basic_domain/Deployments in the Domain Structure panel

Click Lock and Edit

Click Install

Click Upload your file(s).

In Deployment Archive, select install-path/var/dscc7.war and click Next

Select dscc7.war and click Next.

Select Install this deployment as an application and click Next

Provide a Name for the deployment, accept the default Optional Settings and click Finish

Click Activate Changes in the top left corner.

The dscc7 deployment must be in the active state

9)check the dscc web interface

Use http://hostname:port/dscc7 to connect to DSCC.

The default port number for Oracle WebLogic Server is 7001.

The Oracle Directory Service Control Center authentication page is displayed

username:admin

password: As given while creating the registry.

C)Checking the installation--running a few commands to confirm if the software is fully operational

1)Creation of server instances

C:\Sun\dsee7\bin>dsadm create -p 2389 -P 2636 C:\Sun\servers\dsInst2

Choose the Directory Manager password:

Confirm the Directory Manager password:

Use 'dsadm start 'C:\Sun\servers\dsInst2'' to start the instance

C:\Sun\dsee7\bin>dsadm create -p 1389 -P 1636 C:\Sun\servers\dsInst1

Choose the Directory Manager password:

Confirm the Directory Manager password:

Use 'dsadm start 'C:\Sun\servers\dsInst1'' to start the instance

C:\Sun\dsee7\bin>

2)Starting the server instances

C:\Sun\dsee7\bin>dsadm start C:\Sun\servers\dsInst2

Waiting for Directory Server instance 'C:/Sun/servers/dsInst2' to start...

Directory Server instance 'C:/Sun/servers/dsInst2' started: pid=1440

C:\Sun\dsee7\bin>dsadm start C:\Sun\servers\dsInst1

Waiting for Directory Server instance 'C:/Sun/servers/dsInst1' to start...

Directory Server instance 'C:/Sun/servers/dsInst1' started: pid=1836

C:\Sun\dsee7\bin>

3)Create and delete the server instances.

C:\Sun\dsee7\bin>dsadm create -p 3389 -P 3636 C:\Sun\servers\dsInst3

Choose the Directory Manager password:

Confirm the Directory Manager password:

Use 'dsadm start 'C:\Sun\servers\dsInst3'' to start the instance

C:\Sun\dsee7\bin>dsadm delete C:\Sun\servers\dsInst3

Removing 'C:/Sun/servers/dsInst3' directory ...

Directory Server instance 'C:/Sun/servers/dsInst3' deleted

C:\Sun\dsee7\bin>

4)Suffix creation and data population

C:\Sun\dsee7\bin>dsconf create-suffix -p 1389 -e dc=example,dc=com

Enter "cn=Directory Manager" password:

C:\Sun\dsee7\bin>dsconf import -p 1389 -e C:/Sun/dsee7/resources/ldif/Example.ldif dc=example,dc=com

Enter "cn=Directory Manager" password:

New data will override existing data of the suffix "dc=example,dc=com".

Initialization will have to be performed on replicated suffixes.

Do you want to continue [y/n] ?  y

## Index buffering enabled with bucket size 40

## Beginning import job...

## Starting to process and index entries

## Processing file "C:/Sun/dsee7/resources/ldif/Example.ldif"

## Finished scanning file "C:/Sun/dsee7/resources/ldif/Example.ldif" (160 entries)

## Workers finished; cleaning up...

## Workers cleaned up.

## Cleaning up producer thread...

## Indexing complete.

## Starting numsubordinates attribute generation.

## This may take a while, please wait for further activity reports.

## Numsubordinates attribute generation complete. Flushing caches...

## Closing files...

## Import complete.  Processed 160 entries in 4 seconds. (40.00 entries/sec)

Task completed (slapd exit code: 0).

C:\Sun\dsee7\bin>

5)View the entries from a normal ldap broswser

6)execute a sample ldap search command

C:\Sun\dsee7\bin>ldapsearch -h localhost -p 1389 -b dc=example,dc=com "(uid=bjensen)" mail

uid=bjensen, ou=People, dc=example,dc=com

mail=bjensen@example.com

7)Register the above created server instances with DSCC

C:\Sun\dsee7\bin>dsadm.exe start C:/Sun/dsee7/var/dcc/ads

Directory Server instance 'C:/Sun/dsee7/var/dcc/ads' started: pid=3272

C:\Sun\dsee7\bin>dsccreg add-server -h localhost -p 3998  C:\Sun\servers\dsInst1

Enter DSCC administrator's password:

C:\Sun\servers\dsInst1 is an instance of DS

Enter password of "cn=Directory Manager" for C:\Sun\servers\dsInst1:

This operation will restart C:\Sun\servers\dsInst1.

Do you want to continue ? (y/n) y

Connecting to C:/Sun/servers/dsInst1 (using ldap://127.0.0.1:1389)

Enabling DSCC access to C:/Sun/servers/dsInst1

Restarting C:/Sun/servers/dsInst1

Registering C:/Sun/servers/dsInst1 in DSCC on localhost.

C:\Sun\dsee7\bin>

adding another server...

C:\Sun\dsee7\bin>dsccreg add-server -h localhost -p 3998  C:\Sun\servers\dsInst2

Enter DSCC administrator's password:

C:\Sun\servers\dsInst2 is an instance of DS

Enter password of "cn=Directory Manager" for C:\Sun\servers\dsInst2:

This operation will restart C:\Sun\servers\dsInst2.

Do you want to continue ? (y/n) y

Starting C:/Sun/servers/dsInst2

Connecting to C:/Sun/servers/dsInst2 (using ldap://127.0.0.1:2389)

Enabling DSCC access to C:/Sun/servers/dsInst2

Restarting C:/Sun/servers/dsInst2

Registering C:/Sun/servers/dsInst2 in DSCC on localhost.

8)viewing the list of servers registered with dscc

C:\Sun\dsee7\bin>dsccreg list-servers -h localhost -p 3998

Enter DSCC administrator's password:

Hostname        Port  sPort  Type  Owner  Flags  iPath                   Description

--------------  ----  -----  ----  -----  -----  ----------------------  -----------

192.168.64.131  1389  1636   DS                  C:/Sun/servers/dsInst1

192.168.64.131  2389  2636   DS                  C:/Sun/servers/dsInst2

2 server instance(s) found in DSCC on localhost.

C:\Sun\dsee7\bin>

9) unregistering  a server from dscc

C:\Sun\dsee7\bin>dsccreg remove-server -h localhost -p 3998  C:\Sun\servers\dsInst2

Enter DSCC administrator's password:

C:\Sun\servers\dsInst2 is an instance of DS

Enter password of "cn=Directory Manager" for C:\Sun\servers\dsInst2:

This operation will restart C:\Sun\servers\dsInst2.

Do you want to continue ? (y/n) y

Unregistering C:/Sun/servers/dsInst2 from DSCC on localhost.

Connecting to C:/Sun/servers/dsInst2 (using ldap://127.0.0.1:2389)

Disabling DSCC access to C:/Sun/servers/dsInst2

Restarting C:/Sun/servers/dsInst2

C:\Sun\dsee7\bin>dsccreg list-servers -h localhost -p 3998

Enter DSCC administrator's password:

Hostname        Port  sPort  Type  Owner  Flags  iPath                   Description

--------------  ----  -----  ----  -----  -----  ----------------------  -----------

192.168.64.131  1389  1636   DS                  C:/Sun/servers/dsInst1

1 server instance(s) found in DSCC on localhost.

C:\Sun\dsee7\bin>

10)Above basic administration activities can be done by using dscc web interface as well.