Walks you through the process of creating and configuring the ESSOAP
enterprise server instance used to run the MakeCheckAppt SOAP Web service.
Restriction: This topic applies to Windows environments only.
To successfully deploy and run (debug) a Web Service, you must have an
enterprise server instance started in
Enterprise Server. For this tutorial, you create and configure the ESSOAP
enterprise server instance.
Start the Server Explorer
The
Server Explorer view is visible by default when using the Team Developer perspective, and appears as a tab on the same level as the
Application Explorer view. However, if it is not visible:
- In Eclipse, click
, and then click
Open.
Create ESSOAP
In this section, you create the ESSOAP
enterprise server instance from the
Server Explorer in
Enterprise Developer.
- On the
Server Explorer,
right-click
Local [localhost:86]; then select
New > Enterprise Server.
- In the
Name field, type
ESSOAP.
- Click the
Browse button associated with the
Template field.
The default location for
Enterprise Server templates is
%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\etc\ServerTemplates.
- Double-click
ESTemplate.xml to select it.
Note: If the
Template field does not show the path and
ESTemplate.xml file, browse to the
Enterprise Server template location cited above to find and select the file.
- Click
Finish.
Start
Enterprise Server Administration
Configure a listener port
When you create a service interface, it is configured by default to use port number 9003 to send messages to
Enterprise Server, which listens for incoming messages on its Web Services and J2EE listener. You need to set the endpoint address for the
Web Services and J2EE listener to match the port number for the service interface.
- On the
Enterprise Server Administration
Home page, in the
Communications Processes column that corresponds to your
enterprise server instance, click the
Details button.
This takes you to the
Communications Processes page for
Enterprise Server listeners.
- Click the
Edit button that corresponds to
Web Services and J2EE.
- Change the contents of the
Endpoint Address field to
*:9003.
- Click
OK.
This returns you to the
Communications Processes page.
- Click
Home at the top of the menu ribbon to return to the
Home page.
Important: The default deployment directory used by
Enterprise Server is a subdirectory,
deploy, within your
Enterprise Developer installation directory structure. If you have Administrator privileges to this subdirectory, or if you started
Eclipse using
Run as Administrator, you are not required to complete the following tasks. Otherwise, you must complete them to create and configure an alternative deployment directory.
Create and configure a deployment directory
- Create the
deploy directory
- Without Administrator privileges, you cannot deploy to
Enterprise Server from the default
Enterprise Developer deployment folder. To ensure successful deployment, create a
deploy subdirectory in your project.
- In the
Application Explorer view, right-click the project, and then select
from the context menu.
- In the
Folder name field, type
deploy, and then click
Finish.
- Import the .mfdeploy file
- The new
deploy folder must contain the
.mfdeploy configuration file. You import the file from the
Application Explorer view.
- From the
Application Explorer view, right-click the project folder; then select
Import from the context menu.
- Expand
General; then click double-click
File System.
- Click the
Browse button that corresponds to the
From directory field, and navigate to the
%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\deploy folder.
- Click
Select Folder.
- Check
.mfdeploy in the right pane.
- In the
Into folder field, append
\deploy to the existing value so that it points to the
deploy subdirectory.
- Click
Finish to import the file into the project.
- Define the deployment directory
- Now you need to configure your
enterprise server instance by defining the new
deploy project folder as the deployment folder.
- On the
Enterprise Server Administration
Home page in the
Communications Processes column for your
enterprise server instance, click the
Details button that corresponds to
Listeners.
- In the row for the
Web listener name, click
Edit.
- Scroll down to the
Configuration Information field; then within the field, scroll down until you find the relevant code, then change:
uploads=<ES>/deploy
to:
uploads=project-folder/deploy
where
project-folder is the full path to your project folder, using forward slashes to separate subfolders. For example:
uploads=c:/Users/Bob/workspace/project-name/deploy
- Click
OK.
- Click
Home to return to the
Home page.