Configuring InterChange Server Express to start
in design mode
If you plan to deploy the components you will test through Integrated Test
Environment then you must modify the start_server.bat batch file
so that the InterChange Server Express instance starts in design mode. This is
because Integrated Test Environment may deploy the components in such an
order that dependencies are not immediately resolved. For the deployment
to succeed in such a situation, the server must run in design mode.
You typically start InterChange Server Express in design mode by passing the
-design
option at the command line or in the
Target field of the shortcut.
When you use Integrated Test Environment, you start the server through
the Integrated Test Environment perspective, and it does not use the shortcut,
so even if you modify your InterChange Server Express shortcut to use the -design
option the server will not start in design mode.
To start the server in design mode when using Integrated Test Environment,
you can either add the -design option to the
start_server.bat
batch file, or have Integrated Test Environment use a temporary batch file
to which it adds the option itself. Follow the instructions in one of the
following sections depending on your preference:
Manually editing the start_server.bat
file
Do the following to edit the start_server.bat batch file yourself
and add the -design option to it:
-
Use a text editor to open the batch file named
start_server.bat
in the bin directory of the product installation.
-
Add the -design option to the line in the batch file where the Java
program is executed to start the server. You should add the
-design
option after the
-s%SERVERNAME% option. The following example shows how the batch
file should appear:
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% -design %2 %3
-
Save and close the file.
Enabling Integrated Test Environment to
create a custom batch file
You can configure Integrated Test Environment to start InterChange Server Express
in design mode automatically. With this approach, Integrated Test Environment
reads in the start_server.bat file and determines if the -design
option has been specified properly or not. It then creates a file named
start_server_ite_tmp.bat
as a copy of the
start_server.bat file and adds the -design
option if it has not been properly specified. If you start the server from
within Integrated Test Environment then it uses this temporary file.
Do the following to configure the Integrated Test Environment preferences
to create a temporary batch file:
-
Select Window > Preferences from the menu bar of the workbench.
-
Select Integrated Test Environment.
Figure 58 shows
the Integrated Test Environment preferences.
-
Enable the Verify server launch script (start_server.bat) checkbox.
-
Click OK.
-
Important:
-
For this approach to work, you must start the server from Integrated Test
Environment. If you start the server using the program group shortcut or
the command line then this approach will not work, because those startup
techniques do not use the temporary startup script.
[ Top of Page | Table
of Contents ]
