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.3 Installing DSMLv2/SOAP

To install DSMLv2/SOAP support on your system, download the exe from http://developer.novell.com/ndk/dsml.htm.

Run the exe to install DSMLv2/SOAP support on your system.

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.