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.
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
Enterprise Developer the name of your
enterprise server instance, and where to find certain files.
- From the
Application Explorer view, expand
ProgramREST > Web Services
- Right-click the
MakeCheckAppt Web service; then select
Web Service
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
OK (Windows) or
Open (UNIX).
- Click
Add Files again, and browse to your project's
New_Configuration.bin folder.
- Select
schedule.dll (Windows) or
, and then click
OK (Windows) or
Open (UNIX).
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:10086] > Default [127.0.0.1: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
.
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
Application Explorer view, 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
ESCWA.
- In
ESCWA, click
NATIVE.
- In the navigation pane, expand
, and double-click your
enterprise server instance.
- Click
This takes you to the
SERVICES page.
.
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.