Services

Services make APIs accessible to users. A service, through its assigned Access Control Policy, determines which users are allowed access. Furthermore, a service can limit which server TCP/IP ports will be used for the service. A service is comprised of a single API.

Services are managed through the LightWave Server Console. After you have defined an API and created an Access Control Policy, you can deploy them as a Service.

When a service is deployed, a snapshot is taken of the API definition and any dictionaries associated with the API. This allows the original API definition and dictionaries to be modified without affecting the deployed service.

To deploy a new service:

Select "Services" from the console menu.
Click the icon to add (deploy) a new service.
Enter a name and description for the service.
Supply a version identifier for the service.
Select the API to be exposed by the service.
Select the appropriate Access Control Policy from the list.
If desired, restrict the TCP/IP ports at which API requests will be accepted.
Enable the service and save. The API associated with the service is immediately available.

To redeploy a service:

Redeploying a service refreshes the service from the origin API definition and dictionaries.

Select "Services" from the console menu.
Select the Service you wish to redeploy.
Click the icon to open refresh confirmation dialog.
Click OK to complete the refresh or Cancel to exit without refreshing.

To export a service:

Exporting a service creates a service package file that contains the API and all related dictionaries for a service. The service package can then be imported into another server instance for deployment.

Select "Services" from the console menu.
Select the Service you wish to export.
Click the icon to open the system file browser.
Select a download location for the file and click Save to download the Service package file.

To import a Service:

Click the icon to open the upload dialog.
Click the to open a file browser and select the Service package file.
Enter the name of the Service.
If appropriate, select the checkbox to replace an existing Service with the same name.
Click Upload.
Complete the service configuration by selecting an Access Control Policy and optionally enabling the Service.