Deploying programmed extensions

When your IBM Director extension is ready for use, you will need to follow specific steps to integrate it into the IBM Director product. The steps required depend on whether it is a console extension, server extension, or agent extension. Throughout the discussion of deploying an IBM Director extension, it is assumed that IBM Director has been installed in the default Windows directory of \Program Files\IBM\Director.

Subtopics

Deploying extensions onto the IBM Director Server

Steps for redeploying an extension on the IBM Director Server. Since every IBM Director server install includes an IBM Director Console, deploying onto the IBM Director Server will automatically deploy onto the Director Console on the same machine.

  1. Stop the IBM Director Server. Use the command: "net stop twgipc"
  2. Copy files to the appropraite locations within IBM Director NOTE: if you are using Eclipse, then the copy can be done simply by exporting the contents of the "deploy" folder into the directory where IBM Director is installed.
    1. Copy the .TWGExt Extension File to the IBM Director classes\extensions directory
    2. Copy the Jar file to the IBM Director classes directory.
  3. If you have any persistent objects ou might need to run the "twgreset" command to reset the IBM Director persistent store.
    These are the most common reasons for needing twgreset:
  4. Start the IBM Director Server. Use the command: "net start twgipc"

Deploying a Console extension

Steps for redeploying an Extension on the IBM Director Server

  1. Stop the IBM Director Console
  2. Copy files to the appropraite locations within IBM Director NOTE: if you are using Eclipse, then the copy can be done simply by exporting the contents of the "deploy" folder into the directory where IBM Director is installed.
    1. Copy the Jar file to the IBM Director classes directory.
  3. Start the IBM Director Consoele and Log in tothe IBM Director Server.

Ensure that your Console Extension conforms to all Accessibility requirements.

Deploying an Agent extension

A new agent service can be packaged and distributed using the Custom Package Editor feature of the IBM Director software distribution task. The following steps demonstrate how to build an agent distribution package:


Removing extensions

Currently, there is no automated method of removing an extension. The files that you install on either the server, console, or agent must be removed with specific delete operations. This will involve erasing:

For a native code extension on the server, you must delete the appropriate binary files (.exe or .dll) in the folder x:\Program Files\IBM\Director\bin.

In addition to removing the files that comprise your extension, you must inform the IBM Director server that your extension no longer exists by deleting all of Director's persistent storage and log files using the program bin\TWGReset.exe. TWGReset.exe removes all extensions by effectively erasing all persistent storage.