Trading Networks 10.3 | Administering and Monitoring B2B Transactions | Service Development Help | Using the Local Service Development Feature | Prerequisites
 
Prerequisites
Before you use the local service development feature, you must:
*Ensure that Integration Server is installed in the same installation directory as the Designer instance you are using. If you selected Local Version Control Integration (or Designer Workstation in versions prior to 9.8) from the Software AG Installer, this was already done for you.
*Ensure that the watt.server.ns.lockingMode parameter is set to system on the Integration Server used as the local development server. If you set any other value for this parameter, the Local Service Development feature may not work as expected. For more information about this parameter, see webMethods Integration Server Administrator’s Guide.
*Install the Workstation local service development feature as described in Installing Software AG Products.
*Ensure that the VCS Integration feature is not configured on the local development server.
*Install the correct version of the VCS client that you want to use, and if necessary, install the correct Eclipse plug-in for that client. For details about supported Eclipse plug-ins and VCS versions, see Supported Platforms and Eclipse Plug-ins.
Important:
If you are using Subversion as your VCS client, Software AG recommends that you use Subversion 1.7 or higher. Using versions of Subversion prior to 1.7 might cause issues while refreshing web service descriptors and web service connectors.
*In Designer, configure your workspace to be refreshed automatically by selecting the Refresh using native hooks or polling or Refresh automatically check box in Window > Preferences > General > Workspace.
*In Designer, remove .BAK and .bak from the list of resource name patterns to exclude from the VCS. To do this, clear the .BAK and .bak check boxes in Window > Preferences > Team > Ignored Resources.
*If you are using CVS as your VCS client, in Designer, clear the Prune empty directories check box in Window > Preferences >Team > CVS > Files and Folders.
*If you are using EGit as your VCS client, clear the Auto share projects located in a git repository check box in Window > Preferences >Team > Git > Projects.
*If you are using EGit as your VCS client, before creating the local service development project, create a new local Git repository. To create a new local Git repository, select Create new local Git repository in the Git Repositories view.
You can also use the Create Repository field in the Configure Git Repository screen of the Share Project wizard to create and select local Git repository while creating the local service development project.
Clear the Move project to Integration Server package as linked resource check box in Window > Preferences > Software AG > Service Development > Local Service Development to set the Integration Server_directory \instances\default\packages directory as the local Git repository. You can use the local Git repository for all further local development operations.
*If you are using Team Foundation Server as your VCS client, in Designer, clear the Connect mapped projects to TFS automatically check box in Window > Preferences >Team > Team Foundation Server before sharing the local service development project. Otherwise, Team Foundation Server might throw an exception when sharing the local service development project.
*For local development in Integration Server or Microservices Runtime running inside a Docker container, before you start the Docker container, ensure that you mount the corresponding host directory of local Git repository or the TFS project directory in the Docker container. Consider the following sample startup command:
docker run -i -t -d \
--name $[container_name] \
-v $[container_named_volume]: [Install_Dir]/IntegrationServer/instances/ [instance_Name] \
-v [host_git_project_location]:/[container_git_project_location]
-p [host_primary_port:]primary_port \
[image_name] \
/bin/bash