PeopleLink IM Server (Installation Guide [pdf])

1. (Windows NT/2000/XP) My server works for a while, but after a day the DOS/CMD window closes.
2. The server installed fine, but when it starts up there is an error "java.lang.ClassNotFoundException".
3. I get an error about connecting to the database when the server is started.
4. I want to have one Address Book for all my users!

1. (Windows NT/2000/XP) My server works for a while, but after a day the DOS/CMD window closes.

This is caused by a timeout in our license checker. In order to keep the server running continuously, follow these steps:

1. Open the cmd shell. (You can do this by going to Start -> Run, typing the word 'cmd' and clicking "Ok"
2. Go to the directory where you installed the PLIM Server.
3. To start the PLIM Server, type the command 'runss.bat' (or 'run_im_server.bat' depending on the version you downloaded).

In order to keep the server running continuously, you must start the server from a command prompt and not with the supplied shortcuts in the Start Menu.

Download the Installation Guide for more information.

2. The server installed fine, but when it starts up there is an error "java.lang.ClassNotFoundException".

This is caused by missing JDBC jar files; In most cases, the JDBC jar files required to connect to the database have not been added to your classpath.

Try the following:

1. Go to the directory where you installed the PLIM Server.
2. Open the folder named shared
3. Copy the JDBC jar files into this directory.
4. Start the server.

If this does not solve the problem, then modify the runss.bat file to point to the JDBC jar files directly.

1. Go to the directory where you installed the PLIM Server.
2. Using an editor (e.g. WordPad, vi, etc...), open the file named runss.bat
3. Modify add the full path to your JDBC jar file(s) to the classpath, separating each location with a colon (Unix) or a semi-colon (Windows). The classpath is a long string of characters that looks like this

 .\shared\mail.jar;...


If your JDBC jar file is named mydatabasejdbc.jar and it is located in C:\jarfiles, you would would modify the classpath like this:



.\shared\mail.jar;c:\jarfiles\mydatabasejdbc.jar;...

4. Save the file.
5. Start the server.

3. I get an error about connecting to the database when I start the server.

When you installed the server, you specified the following for your database: and listening port of your database.

1. IP address
2. Listening Port
3. Database Name (default was CommServer_DB)
4. Database login/password

Verify these values in the cserver.ini file.

Download the Installation Guide for more information.

4. I want to have one Address Book for all my users!

There are two recommended ways to do this.

Export your own Address Book and share it with others

• From the PeopleLink IM Client, click on File -> Export Address Book.
• Save the file to your Desktop. The file extension will be .dat.
• Now you can send the file via email to anyone and they can import it.
• To import, click on File -> Import Address Book and select the file. It will overwrite their current Address Book.

Modify the database stored procedure "all_list" to get the Address Book of a specific user by their USER_ID (stored in the UserRegistration table).

In this method, a single user ("AddressBook" for examnple) is created and holds a master Address Book that everyone uses.

all_list is the main stored procedure that calls the Address Book from the database. By modifying the query in the procedure to use a specific USER_ID, the Address Book that every user will get will be the one you specified.

Example of a modified all_list stored procedure (PostgreSQL):

CREATE FUNCTION all_list (integer) RETURNS SETOF abview
    AS '
   /* forcing the Address Book to be pulled from USER_ID 872 */
   select * from abview where user_id = 872
'
    LANGUAGE sql;

Return to top

.