Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

How to "Smoke Test" the new technology agent controller

Download the agntctrl and sdk packages for each given system, create subdirectories for holding the release packages, and unzip them there.

There is some debate about whether to overlay the runtime and sdk packages or keep them separate. My fear with overlaying is that you're likely to miss any error in either package if it is masked by the other. Therefore, I put the agntctrl package in <ac> and the sdk package in <sdk>.


Set up environment variables.

  1. cd <ac>/lib; export LD_LIBRARY_PATH=`pwd`:$LD_LIBRARY_PATH
  2. cd <ac>/bin; export PATH=`pwd`:$PATH
  3. export PATH=<path to the correct Java bin>:$PATH

Note that "the correct Java" is something to think carefully about! It's an important factor to document to ensure thorough testing.

Note that if you're running 32-bit apps on a 64-bit system, you're in for a rough ride separating out the two environments!

Set up your <ac>/config/serviceconfig.xml file (it's empty on delivery) by running ./SetConfig.sh (you are still in the <ac>/bin directory, right?). You can Accept defaults for all values (unless you know you want to test security, or remotely from another system, etc.).

Edit <ac>/agents/*/agent.xml, remove all ".\" prefixes and ".exe" suffixes from all launchinfo lines.

Make sure an AC is not running already:

  1. ps aex | grep -i server
  2. ls -last /tmp/IBMRAC (clean it out if stuff is there)
  3. ipcs (to see if there are unattached shmids! if so, su to root and ipcrm the shmids)

Start the agent controller.

It's important to use the ACStart.sh script now.

Check the AC for minimal functionality: run "./SampleClient"

Back to the top