Walks you through the process of creating and configuring the ESSOAP
enterprise server instance used to run the MakeCheckAppt SOAP Web service.
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 expandable ribbon is visible in Visual Studio on the top left side of the IDE by default when using
Enterprise Developer. However, if it is not visible:
- In Visual Studio, click
View > Server Explorer.
Attention: You might encounter an
Enterprise Server Sign On dialog box as you perform the steps required to create, configure, start, or stop an
enterprise server region from the
Server Explorer. If you do, ensure that the
Server requires credentials,
Use specific server credentials, or
Server is secured
box is
unchecked, and then click
OK.
Also, if prompted to disable password recovery, click
No.
Create ESSOAP
In this section, you create the ESSOAP
enterprise server instance from the
Server Explorer in
Enterprise Developer.
- On the
Server Explorer,
expand
Micro Focus Servers; then right-click
Default and select
New Enterprise Server.
- In the
Name field, type
ESSOAP.
- Check
64-bit to match your project's bitism.
- Click the
browse button associated with the
Template field.
The default location for
Enterprise Server templates is
a subdirectory named
ServerTemplates located several levels under the Visual Studio installation directory.
- Click
ESTemplate.xml to select it, and then click
Open.
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.
- In the
Associate with projects box, check
ProgramSOAP.
- Click
OK.
Start Enterprise Server Common Web Administration (ESCWA)
Configure listener ports in ESCWA
When you create a service interface in
Enterprise Developer, 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.
In addition, you need to enable the Web listener to start automatically with the
enterprise server instance.
- In
ESCWA, click
Native.
- In the navigation pane, expand
, and select your
enterprise server instance.
- On the
General drop-down list, select
Listeners.
- In the
Listeners section, notice the
Web Services and J2EE one.
- Click
(Edit) on the row for this listener.
- In the
Port field, type
9003.
- Scroll down to the
Status section, and set
Requested Status to
Stopped, if not set to this already.
- Click
Apply.
- In the
Native Listener Navigation pane on the left, click
Web under
Communications Process 1.
- Change the value of the
Requested Status field to
Stopped.
- Click
Apply.
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
Visual Studio 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
Solution Explorer, right-click the project, and then select
Add > New Folder from the context menu.
- Type
deploy, and then press
Enter.
- Import the .mfdeploy file
- The new
deploy folder must contain the
.mfdeploy configuration file. You import the file from the
Solution Explorer.
- From the
Solution Explorer, right-click the
deploy folder; then select
Add > Existing Item.
- Browse to the
%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\deploy folder.
- Set the filter drop-down list to
All Files (*.*).
- Double-click the
.mfdeploy file.
- Define the deployment directory in ESCWA
- Now you need to configure your
enterprise server region by defining the new
deploy project folder as the deployment folder.
- In
ESCWA ensure that your
enterprise server region is selected in the navigation pane, and the
Communications Processes page is open in the right pane.
- Under
Communications Process 1 in the lower left pane, select
Web.
- In the
Listener Properties pane, scroll down to the
Custom Configuration field.
- Within the
Custom Configuration field, scroll down until you find the relevant code, then change:
uploads=<ES>/deploy
to:
uploads=c:/tutorials/IMTK/project-name/deploy
where
project-name is the name of the project.
- Click
Apply.