Guides you through the steps required to prepare the ProgramREST project and MakeCheckAppt Web service for deployment, deploy
the Web service to the ESREST enterprise server, and verify the deployment results.
Restriction: This topic applies only when the Enterprise Server feature is enabled.
Restriction: This topic applies to Windows environments only.
Work through the following sections to prepare your project and Web service for deployment, and to deploy and verify.
Set deployment properties
To successfully deploy a REST Web service to an
enterprise server instance, you need to first set some options that tell
Visual COBOL the name of your
enterprise server instance, and where to find certain files.
- From the
COBOL Explorer, expand
ProgramREST > Web Services
- Right-click the
MakeCheckAppt Web service; then select
Properties from the context menu.
- On the
Deployment Server tab, click the
Change button that corresponds to the
Enterprise Server name field.
- In the
Server column, click
ESREST; then click
OK.
- On the
Application Files tab, click
Legacy application needs deploying; then click
Add Files.
- Browse to your project's
ProgramREST 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 Files again, and browse to your project's
New_Configuration.bin folder.
- Select
schedule.dll, and then click
Open.
This is the executable file you need to debug the service
- Click
OK.
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
Local [localhost:86]
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
![Started enterprise server instance](GUID-705DBC03-E77B-4D94-AE46-01D47B99AB22-low.png)
.
Start the ESREST
enterprise server instance
Before deploying your service interface, you must start the ESREST instance where the MakeCheckAppt service will run.
- From the
Server Explorer, right-click
ESREST; 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 ESREST entry appears with a green icon
, indicating that it is started.
Deploy the MakeCheckAppt Web service
- From the
COBOL Explorer, right-click the
MakeCheckAppt Web service, and then click
Deploy.
- In Eclipse, click the
Console tab.
- On the icon bar, click the down arrow associated with
Display Selected Console
.
- Click
Service Interfaces Console to monitor deployment progress.
The
Console view 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.
Note: If the console switches to the
Micro Focus Build view after deployment, switch the view back to
Service Interfaces Console to review the deployment log.
If deployment ever fails, you should find a message in the
Console view 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 REST Web service is deployed, you can look at its details in
Enterprise Server Administration.
- On the
Enterprise Server Administration
Home page, in the row showing information for the ESREST
enterprise server instance, you should see that the
Objects column shows the number of services that this
enterprise server instance runs.
- Click the
Details button for the ESREST Services.
In the row showing your new service,
MakeCheckAppt, you should see that the
Current Status column shows both operations as
Available. This means that the service is ready to be accessed by a client.
- Close
Enterprise Server Administration.