1.2 Getting Started
The following sections cover a few basic requirements for
getting set up and started with DSMLv2/SOAP:
1.2.1 Dependencies
Developing and running an application that uses DSMLv2/SOAP
support for eDirectory requires the following:
- A Web Application Server
or Servlet engine, such as the following:
- Novell exteNd™ JBroker™ Web:
You can download JBroker from the Novell
Download site.
- Novell exteNd Application Server: The Novell exteNd
Application Server ships with NetWare 6.5 SP 1.1 and later.You can
download this from the Novell
Download site.
- rta Tomcat version 4: You can download this from http://jakarta.apache.org/tomcat.
NOTE:Tomcat version 3 is not supported.
- Java Runtime Environment (JRE) 1.4 or higher, required
to run an application. You can download this from http://java.sun.com/j2se/1.4.
- Java Development Kit (JDK*) 1.4 or higher,
required to develop applications. You can download this from http://java.sun.com/j2se/1.4.
- An LDAP server. If you want to use TLS (SSL) or
the Start/Stop TLS (Transport Layer Security) functionality,
you need an LDAP server that supports these features.
Novell eDirectory 8.x and higher
supports SSL (Secure Socket Layer).
Novell eDirectory 8.7 supports Start/Stop TLS. Refer
to Section 2.3, Enabling TLS (SSL) for
more information.
- Novell eDirectory 8.5 or higher if you want to develop
or run applications that use the LDAP extensions for partition and
replica management.
1.2.2 Supported Platforms
DSML and LDAP need not run in the same server.
This product is available on the following platforms:
- Windows*:
- Windows NT Server 4.0 with Service
Pack 6 or later
- Windows 2000 Server with Service Pack 2 or later
- Windows XP
- Linux*:
- Red Hat* Linux 7.2, 7.3,
8.0 or Red Hat Enterprise Linux AS 2.1
- SuSE* Linux Enterprise Server 8
- Solaris*:
- Solaris 7 on Sun SPARC (with patch
106327-13 or later for 32-bit systems)
- Solaris 7 on Sun SPARC (with patch 106300-07 or
later for 64-bit systems)
- Solaris 8 on Sun SPARC (with patch 108827-20 or
later)
- Solaris 9 on Sun SPARC
- AIX*:
1.2.4 What does this Kit Contain?
This kit consists of a deployable web archive (.war) file,
called novell-dsml.war.
This file consists of the following:
- .jar files and .xml configuration
files to run DSMLv2/SOAP support on your Web application server.
- The web.xml configuration file.
This file is located in the WEB-INF directory.
- A readme that lists the known issues.
- Sample programs to get you started using DSMLv2/SOAP
support.
1.2.5 DSMLv2 Authentication
An LDAP application associates a security principal with an
LDAP connection by issuing a Bind request—or, in the SASL Bind case,
by issuing as many successive Bind requests as needed to complete
the authentication. A DSMLv2 document can be transported by means
of a variety of mechanisms, so the document itself is not used to
authenticate the requestor.
In the DSMLv2/SOAP implementation on eDirectory,
the only authentication is the normal HTTP authentication. Therefore,
the only way to bind with DSML is by sending the user name and password
in the HTTP header.