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
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.
- Stop the IBM Director Server. Use the command: "net stop twgipc"
- 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.
- Copy the .TWGExt Extension File to the IBM Director classes\extensions
directory
- Copy the Jar file to the IBM Director classes directory.
- 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:
- You have modified a Task definition.
- You have modified a Filter definition.
- You have modified a TWGDatabaseTable definition
- Start the IBM Director Server. Use the command: "net start twgipc"
Steps for redeploying an Extension on the IBM Director Server
- Stop the IBM Director Console
- 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.
- Copy the Jar file to the IBM Director classes directory.
- Start the IBM Director Consoele and Log in tothe IBM Director Server.
Ensure that your Console Extension conforms to all Accessibility requirements.
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:
- Make the IBM Director agent aware of your new agent service by creating
a new .ini file. This .ini file contains information that
describes your new agent service. To create your .ini file, use
the program TWGSVCEE.
- Create a simple batch or command file which contains the TWGMRGSI
merge command, for example, twgmrgsi merge newsvmgr.ini.
The merge command will merge your .ini file with Directors .ini
file thereby informing the IBM Director agent of your new agent service.
- Create a custom software distribution package:
- Select the Files tab and add the appropriate agent files
and the batch/command file from step 1. Do not select the Move
subdirectories with parent option.
- Select the required platform tab and enable distribution to the
platform type.
- Set the Destination Directory to Program
Files\IBM\Director\bin.
- Set Post Distribution Action to Restart Computer.
- Set the Execute Post-Distribution program to be the merge
batch/command file created in step 1.
- Save the software package.
- Distribute the software package to a managed system. When the
targeted system is restarted, the new service should be available.
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:
- Java class files and properties files which belong specifically to
the extension from folder x:\Program
Files\IBM\Director\classes
- HTML help files which belong specifically to the extension from
folder x:\Program Files\IBM\Director\classes\doc
- Properties file of any Java extension from its position under
folder x:\Program Files\IBM\Director\classes\extensions
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.