Previous Page     Contents     Next Page


Building PingIM


This section details the steps necessary for building the PingIM application.  


Compilation

Compiling the PingIM jar file is fairly easy.  PingIM uses Jakarta Ant, an open-source XML-based build system.  Thus, the ant package is required in order to build the application.  From the top directory of the PingIM project, type:

    ant clean

This will delete any existing PingIM.jar file as well as all compiled PingIM Java .class files.  The command

    ant all

will compile all the necessary class files and generate the jar file.  To install the .jar file on the PingTel Xpressa phone or PingTel Xpressa softphone, you will need to utilize the phone's web interface.  More information on installing PingTel Xpressions can be obtained from the PingTel website.

Optionally, the Javadoc files may also be generated using the ant make system.  The command to generate the Javadoc HTML files is:

    ant javadoc



Configuring the LDAP server

As mentioned earlier, PingIM relies on an LDAP directory service.  To configure an LDAP directory for use, the schema must be augmented to include attributes specific to the PingIM application.  Specifically, the following must be added to the LDAP schema:

Name
 Description
 Type
sip
 Represents a SIP address.
 attribute
devicename
 The device name for an X10 device.
 attribute
presence
 Represents a buddy's presence status, e.g., away, present, etc.
 attribute
sip-expires
 The date, in String format, that a buddy's subscription expires.
 attribute
pingim
 May contain sip, devicename, presence, and/or sip-expires.
 objectclass

For an OpenLDAP implementation, the following example schema should suffice:

attributetype ( 1.3.6.5.5.5.2.1  NAME ( 'sip' ) SUP name )
attributetype ( 1.3.6.5.5.5.2.2  NAME ( 'devicename' ) SUP name )
attributetype ( 1.3.6.5.5.5.2.3  NAME ( 'presence' ) SUP name )
attributetype ( 1.3.6.5.5.5.2.4  NAME ( 'sip-expires' ) SUP name )
objectclass ( 1.3.6.5.5.5.2 NAME 'pingim' SUP top STRUCTURAL MAY ( sip $ devicename $ presence $ sip-expires ) )

LDAP
The LDAP administrator also should be careful to include the entries "ou=pingim_phone" and "ou=pingim_machine" for users who wish to use the PingIM application, as illustrated above in the example for uid=msherr.




Previous Page     Contents     Next Page