Portus	Version 2012-12-17	PDF BOOKS   |   HOME   UP   PREV   NEXT

The Servers View lists all defined servers along with their status.

This view is your top level of configuration of one or many Portus servers.

Note:
The Servers view is part of the Portus "legacy" perspective. This perspective is superseded by the new "Portus perspective", you are strongly encouraged to familiarise yourself with, and start using the new perspective as early as possible, only the latter will be enhanced further some features are available in the Portus perspective only.

Working with the Servers View

There are 2 ways to perform actions on a defined server.

• The first method is to left-click the server, and use the Properties view. In this view you can:

  1. Get some more detailed information on the server

  2. Set tracing parameters

  3. Set security levels

  4. Set transactional parameters

  5. Set server settings

  6. Add or modify the drivers used to access resources

• Using the second method, you may right click on a server entry and bring up the context menu.

Refresh the Portus configuration

When a Portus Server configuration is modified "on-the-fly", for example by modifying, adding or deleting resources, these changes are volatile, they are not preserved over a server restart. Additionally, a server configuration may have been modified by someone else. In either case, your local representation of the Portus server configuration may no longer be accurate, issue a Refresh to synchronize it by selecting the "Refresh Configuration" option on the context menu. A message will be written to the Action Log as well as the status line after the refresh operation is completed.

Save current Configuration to server file

As the Portus Server configuration is volatile - not preserved over a restart - the configuration has to be "saved" (written to disc) in order to have it available for subsequent server executions. Selecting the "Save current Configuration to server file" function from the context menu brings up the following dialog:

Leave the Save as field empty to overwrite the currently active configuration file, or opt to write to a different file (specify the name in the "Save as" field), in which case the respective Portus Server environment variables have to be adjusted to point to the new file. Click "Continue" to save the configuration, the successful operation will be confirmed by a message in the status line.

To include unpublished configuration changes in the saved copy, check the respective box.

Import the Portus Configuration from server

The current "live" Portus Server configuration can be imported to the local file system, e.g. for archiving purposes (locally, saved in a CVS repository etc.), copying / exporting to another Portus server etc.

1. Select the "Import Configuration from server" option from the context menu

2. Select a target directory, click OK.

   

3. Successful import will be confirmed with a message in the status line as well as the Log View

   

Export the Portus Server configuration

An imported configuration can be exported back to any Portus Server.

1. Select the "Export Configuration to server" option from the context menu

2. Select an exported configuration, click "OK".

   

3. Specify the export destination, either the currently active, or a different Portus configuration file, click "Continue" to perform the export operation.

   

4. Successful export will be confirmed with a message in the status line

   

Export Portus WebService definitions

Export Portus WebService related definition elements - DataViews (XRDs) and/or XML Schemata (XSDs) and/or Stylesheets (XSLs).

1. Select the export WebService Definitions option from the context menu

2. Select a DataView (XRD), Schema (XSD) or Stylesheet (XSL), click OK.

Remove a Portus Server entry

1. Select the "Remove Server definition" option from the context menu

2. Confirm by clicking the "Yes" button.

   

3. The server entry is now deleted and removed from the Servers View

Create new Services

1. Select the "Creat new Services" option from the context menu

2. 

   Select the driver to be used for creating/importing the resource(s), then click 'Next'.

Example: Create a new Adabas WebService

For Adabas drivers, the following dialog is presented

Specify

• The database ID to "discover" web services from

• The file number to begin discovery at

• The file number to end discovery at. Any existing files in this from-to range will then be enabled as Web Services.

For a comprehensive description please refer to the Portus WebService Creation section.

Example: Create a new MySQL WebService

For MySQL, PostgreSQL, and other ODBC-based Drivers, the following dialog will be displayed

Specify

• The ODBC DSN required

• The credentials to access the database catalog, if required

• A value used to pattern match tables. The percentage (%) will match any sequence of zero or more characters. The underscore (_) will match any single character. In our above example, "C%" will match the tables "City", "Country", but not "Department". You may also leave this value blank to match all tables.

• Max. Tables is a hard-limit on the amount of tables returned.

Click the Discover button to start the import/generation process.

When "Options for generated Service name" is checked, the following dialog will appear after having clicked the Discover button

Here you can control how the names of automatically created WebServices will be assembled. Specify the replacement character for whitespaces in table names, decide if (and what) prefix is to be attached, select which catalog elements describing a table are to be included in the WebService name.

Click Continue to use the current settings as per this dialog, or click Cancel to use the default settings.

When "Show all table types" is checked, the following dialog will appear after having clicked the Discover button

Click Continue to use the current settings as per this dialog, or click Cancel to use the default settings.

WebService definition(s), DataViews as well as XSDs, for the selected file(s) will be generated

For a comprehensive description please refer to the Portus WebService Creation section.

Modify the Portus Server definition entry

In this section you can modify the friendly-name, host and port that the Portus server is running on. You may also view some detailed information about the server.

To modify the Portus server entry:

1. In the Portus Server view, left-click the server you wish to modify.

2. Select the General tab in the Properties view

3. Modify parameters as required, click Save.

   

Note: you can also view the Portus Status, and license information here too. This information is not modifable.

Modify Global -> Security Options

In this section located in the Global properties you can set the Security Level that Portus runs at.

Important:
We recommend you contact your Portus support team before modifying these parameters.

To open the Security view, left-click the server you wish to modify. In the Properties view, select the Global tab. Security options are in the Security group.

There are 4 security levels that Portus can run at

1. None: No Portus security.

2. Userid: All requests must have a user ID.

3. Password: All requests must have a user ID and password.

4. SSLCert: All requests must have a SSL Certficate.

Under normal circumstances the user will be authenticated by sending the credentials to the underlying resource ( for example the ODBC database). It is also possible to provide a 3rd party DLL which can authenticate the credentials. This DLL name should be added in the Manager text box.

Modify Global -> Transactional Options

In this section you can set the Transaction Manager that Portus uses to handle data integrity.

Important:
We recommend you contact your Portus support team before modifying these parameters.

To open the Transaction view, left-click the server you wish to modify. In the Properties view, select the Global tab. Transaction options are in the Transaction group.

Modify Global -> Settings

In this section you can set threshold values for Portus global variables.

Left-click the server you wish to modify. In the Properties view, select the Global tab. Server settings are in the Settings group.

The following can be set here

• Context Time-to-live: specifies the time (in seconds) after which orphaned contexts (for example due to timeouts or broken connections) will be considered "dead" and cleaned up.

• Configuration write timer: The in-core copy of the Portus configuration will be automatically saved to file after the specified interval (in seconds) elapsed. A value of 0 means the current configuration will never be saved back to the configuration file.

• SELECT record limit: Limit the amount of records returned from a "select" or "select next" call.

• Trim repeating elements. This option only applies to Natural-based web services. Repeating array elements will be trimmed based on the first empty field found. For example, if the service returns . . . <myArray>ONE</myArray><myArray>TWO</myArray><myArray/><myArray/><myArray/> . . ., when this option is turned on the output will be trimmed to . . .<myArray>ONE</myArray><myArray>TWO</myArray> . . ..

• Trim repeating elements: This option only applies to Natural-based web services. Repeating array elements will be trimmed based on the first empty field found. For example, if the service returns . . . <myArray>ONE</myArray><myArray>TWO</myArray><myArray/><myArray/><myArray/> . . ., when this option is turned on the output will be trimmed to . . .<myArray>ONE</myArray><myArray>TWO</myArray> . . ..

Modify tracing / messaging options

The message level set for a Portus Server determines the amount and detail of information written to the server log.

Important:
Trace options are debugging instruments which should not be modified unless instructed to do so by support personnel, continuous tracing will adversely effect the performance of the Portus Server.

To change either the message level or trace options:

1. Select the "Tracing" tab from the Properties view

2. Modify the message level or tracing option(s), as appropriate, click "Apply" to send the changes to the Portus Server.

   

Add / Modify Drivers

This section describes how you add/remove/modify the drivers that Portus uses to talk to the underlying resource whether that be Adabas, Natural, MySQL, PostgreSQL, etc

To open the Drivers view, left-click the server you wish to modify. In the Properties view, select the Drivers tab.

From here you can add, remove and modify drivers, or view detailed information about a particular driver.

You may left-click a driver entry and select Details to display more information about this driver.

To modify an existing driver, left-click the driver,and select Modify

To add a new driver, click the Add... button.

The Driver Definition Wizard presents a list of licensed drivers, select one to all and press the Configure button.

The Driver Definition dialog will come up with preset values. Modify as appropriate.

Press the Save button to define the driver.

If the new driver does not apper, check the error log.

If the driver requires any options, you will be prompted to enter these after you click Save once, specify them as appropriate, click Save again to actually define the driver.

When "Show (post-setup) Driver Information" is selected, additional information may be displayed after the driver add operation has completed:

The following table illustrates information about all the drivers Portus supports on Linux and Windows systems

And the following outlines the driver information for Portus running on mainframe (z/OS or z/VSE) systems

To remove an existing driver, select the driver, and click Remove

ostia   www.softwareag.com

Copyright © 2006-2012 Ostia Software Solutions Limited.

PDF BOOKS   |   HOME   UP   PREV   NEXT