Integrated Test Environment uses a software agent that communicates with InterChange Server Express to perform tests. This agent must communicate with InterChange Server Express and the tools through a port using Remote Method Invocation (RMI). Integrated Test Environment also requires a block of nine contiguous ports over which to communicate with each connector that is emulated in the interface being tested.
You must configure your environment so that there are ports available for these communication requirements. The default RMI port is 1099, and this is the port that the Integrated Test Environment agent is configured to use by default. Integrated Test Environment is configured by default to use ports 1100 and up to communicate with the connectors being emulated in the interface.
Other programs installed on your system may be configured to use port 1099, however, so you must determine which ports you can use. After determining which ports you can use you must configure settings in Integrated Test Environment to use the desired port as well as set a property in the start_server.bat batch file.
The following example shows the use of the netstat command and a portion of the returned output:
C:\>netstat -a -n Active Connections Proto Local Address Foreign Address State TCP 0.0.0.0:80 0.0.0.0:0 LISTENING TCP 0.0.0.0:135 0.0.0.0:0 LISTENING TCP 0.0.0.0:371 0.0.0.0:0 LISTENING TCP 0.0.0.0:445 0.0.0.0:0 LISTENING TCP 0.0.0.0:1029 0.0.0.0:0 LISTENING TCP 0.0.0.0:1030 0.0.0.0:0 LISTENINGThe first entry shows that port 80 is being used and the last line shows that port 1030 is being used. Examine the lines to determine if ports 1099 through 1108 are being used. It is recommended that you copy the output into a text file where you can search for the port numbers.
If ports 1099 through 1108 are in use already then you must change the settings as described in Setting the RMI port in start_server.bat and Setting the RMI port in start_server.bat.
If you find any such entries, you might experience complications
when trying to use Integrated Test Environment with the default configuration.
Change the settings as described in Setting
the RMI port in start_server.bat and Setting
the RMI port in start_server.bat if so.
Integrated Test Environment requires a single port for the test environment agent to communicate with the server. It also requires nine ports to communicate with up to nine connector agents that can be emulated during a test. You configure the port number that Integrated Test Environment will use for the first of the nine possible connector agents, and then it uses the eight ports above that number for the others, so you must ensure that there is a block of nine contiguous ports available. If you do not have nine connectors that require emulation in the interface then you can use a smaller block of ports. Ideally, you should find a block of ten available ports so that all of the ports related to the Integrated Test Environment are contiguous.
Do the following to configure the port usage for Integrated Test Environment:
Figure 58 shows the Integrated
Test Environment preferences.
Figure 58. Integrated Test Environment general preferences
The default value is 1099.
The default value is 1100. Integrated Test Environment
will use the value in the Base port number field for the first connector
agent that must be emulated, and use the subsequent port numbers for other
connector agents.
If you do not plan to use the custom batch file that Integrated
Test Environment can create, leave the Verify server launch script (start_server.bat)
checkbox disabled and be sure to follow the instructions in Setting
the RMI port in start_server.bat to add the port configuration information
yourself.
Even if you plan to use the default RMI port number of 1099, you must add the property to the batch file and set it equal to the default value. Do the following to do so:
REM Start the InterChange Server "%CROSSWORLDS%\bin\java" -server -mx%CW_MEM_HEAP%m -DTEAgent=1099 -DCW_MEMORY_MAX=%CW_MEM_HEAP% -Duser.home="%CROSSWORLDS%" -Djava.ext.dirs="%MQ_LIB%" -DORBNamingProvider=VisiBroker -classpath %JCLASSES% ServerWrapper -s%SERVERNAME% %2 %3
[ Top of Page | Table of Contents ]