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