Guides you through the steps required to prepare the ProgramSOAP project and MakeCheckAppt Web service for deployment, deploy
the Web service to the ESSOAP
enterprise server instance, and verify the deployment results.
Work through the following sections to prepare your project and Web service for deployment, and to deploy and verify.
Build the ProgramSOAP Project
You need to build the project to generate all required deployment files.
- On the
Solution Explorer, right-click the
ProgramSOAP project; then click
Build.
Stop
enterprise server instances
To ensure that your
enterprise server instance does not encounter any port conflicts with other
enterprise server instances that use the same listener port, stop all started
enterprise server instances, if any, as follows:
- On the
Server Explorer, expand
localhost
under
Micro Focus Servers to see a list of
enterprise server instances.
- Right-click each started
enterprise server instance, and stop it by selecting
Stop from the context menu.
Note: Started
enterprise server instances show with a green icon
.
Start the ESSOAP
enterprise server instance
Before deploying your service interface, you must start the ESSOAP instance where the MakeCheckAppt service will run.
- From the
Server Explorer, right-click
ESSOAP; then select
Start from the context menu.
Note: If this is the first time you have started the server, you see a sign-on dialog box. If
Server is secured is checked, uncheck it; then click
OK. Unchecking
Server is secured prevents this dialog box from showing when you subsequently start the region. If
Server is secured is not checked, simply click
OK to clear the dialog box. Also, if prompted to disable password recovery, click
No.
After the list on the
Server Explorer refreshes, the ESSOAP entry appears with a green icon
, indicating that it is started.
Set Deployment Properties
To successfully deploy a SOAP Web service to an
enterprise server instance, you need to first set some options that tell
Enterprise Developer where to find certain files.
- From the
Solution Explorer, right-click the
MakeCheckAppt service interface; then click
Properties.
- Ensure that the
Interface type property is set to
SOAP Web Service (default).
- Click the
Application files to deploy field, and then click its corresponding browse button
.
- On the
Add/Remove Items dialog box, click
Add File.
- Browse to your project's
ProgramSOAP folder, and select the following files:
- appoint.dat
- consultants.dat
- customers.dat
These are the data files accessed by the service.
- Click
Open.
- Click
Add File again, and browse to the
ProgramSOAP\bin\x86\Debug
folder.
- Select
schedule.dll
, and then click
Open.
This is the executable file you need to debug the service
- Click
OK to close the
Add/Remove Items dialog box.
Deploy the MakeCheckAppt Web service
- From the
Solution Explorer, right-click the
MakeCheckAppt service interface; then click
Deploy.
The
Output window shows the progression of the deployment process. If deployment was successful, you should see a message: Deployment completed
with warnings. If you scroll up to see the log output, notice that the deployment process changed the direction of the slashes
in some directory specifications. This is normal behavior for successful deployment.
If deployment ever fails, you should find a message in the
Output window indicating why it failed. Also, the failure message contains the path to the deployment log file. You can type the address
into a browser and view the log file from there.
View deployment results
Now that your SOAP Web service is deployed, you can look at its details in
ESCWA.
- In
ESCWA, click
Native.
- In the navigation pane, expand
, and double-click your
enterprise server instance.
- On the
General drop-down list, select
Services.
At the bottom of the right pane, you should see both operations marked as
Available. This means that the service is ready to be accessed by a client.
- Close
ESCWA.