- Configuring Client Services

configuring client services

proiv dashboard

Virtual Machine Connections Configuration

To set the Virtual Machine connections, do the following:

On the Client Connector Settings tab, click VM Connections.
Expand VM Connections.
The Default and Aurora Virtual Machine connections are displayed.

Click on the name of the Virtual Machine connection to modify its configuration. To add a new connection, click New. The following table describes the fields to change the values.

Field Name	Description
Name	Name of the interactive connection.
Description	Description of connection.
Host	The IP address or system name of the machine where the PROIV application server is installed. The web browser connects to the Open Client servlet which then connects to this host.
Port	The port which the PROIV application server listens to for connections. The default port for both Unix and Windows is 9023.
Username	Username to use for interactive login. (For UNIX operating system). If you use Microsoft Windows, the user name is used for the PROIV login process. If you use Unix, the user name is used to log onto the Unix operating system, not PROIV.
Password	The password used at login. If you use Microsoft Windows, the password is used for the PROIV login process. If you use Unix, the password is used to log onto the Unix operating system, not PROIV.
Command	Command to be run on the host machine once logged in. The default command is ./runproiv.sh. This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

On UNIX-based operating systems, you must specify the UNIX Prompt Connection Properties. Expand Default and click Unix Prompt Connection Properties.

Field Name	Description
Username	Specify the login prompt for the operating system.
Password	Specify the password prompt for the operating system.
Success	The string to search for to indicate that the login has been successful.
Failure	The string to search for to indicate that the login has failed.

To delete a Virtual Machine connection, click VM Connections and then click Delete for the Virtual Machine connection which you want to remove.
The VM connection is deleted from the list.
Click Submit.
The Virtual Machine connection is saved

Clients

To set the Clients configuration, do the following:

On the Client Connector Settings tab, click Aurora Client Configuration.

The Analytics configuration is general and is applicable to all connections through the Client Connector, both OpenClient and LiteClient services. The following table describes the Analytics fields to change the values.

Field Name	Description
Analytics
Analytics Context Path	The context path of the Analytics application.
Host	The host name of the server hosting the Analytics application.
Port	The port of the server hosting the Analytics application is listening on.
Protocol	The protocol that should be used to connect to the Analytics application. (HTTPS/HTTP)
General Settings
Session Idle Timeout	The period of time in seconds than an OpenClient can remain idle before the session times out.

Client Services Configuration

To set the Client Services configuration, do the following:

On the Client Connector Settings tab, navigate to the Client Services tree.
To configure Client services, expand Client Services.
The Default and Aurora services are displayed.

Click on the name of the service to modify its configuration. To add a new service, click New. The following table describes the fields to change the values.

Service Name	Name to identify the service.
Service Description	Enter the description for the service.
Enabled	By default, the service is enabled and is displayed in the list of Services. To disable, turn OFF the slider. If the service is disabled, the service is not displayed in the list of available Services. Additionally, the connection URL for that service does not function.
VM Connection	Select the VM Connection for this service to connect a PROIV Virtual Machine. For more information, refer to VM Connections.
Xfer In	Represents the data transferred at session start up.
Maximum Upload Size	Set the maximum upload size in bytes for the file send and receive process. The send and receive process in OpenClient requires user interaction, it is not a transparent process. Therefore, when a file is required by the PROIV Virtual Machine, a message box displays which prompts the user to locate the file and manually upload it to PROIV. To avoid the system bottlenecks, it is advised to set an upload file size limit to prevent users from uploading huge files.

Click Rendition.

Rendition
Character Width	Applications need character-width data to fit the text to page or column. It represents the width in pixels of a character cell. The default width is 9. This is the scaling factor used to convert columns for CSS positioning. You can specify the width of the PROIV rendition in the browser, whereby increasing the width factor moves the PROIV rendition further to the right in browser. The following illustration shows the height and width components of a character:
Character Height	Represents the height in pixels of a character cell. The default height is 20. This is the scaling factor used to convert rows for CSS positioning. You can specify the height of the PROIV rendition in the browser, whereby increasing the height factor moves the PROIV rendition further down the browser.
Resource Paths	A list of resources to be used by the OpenClient. Enter a comma-separated list of resources which is searched from left to right. Default value is "_proiv" Contains all of the PROIV Developer and PROIV Demo images. The ‘_’ (underscore) will do a lower case conversion on the image name supplied by PROIV, prior to an attempt to locate it. This feature is useful for people who move systems between Microsoft Windows and Unix, as Unix is case sensitive. Note: Images in the BMP file format are not supported by OpenClient. It is advisable to convert them to JPG or PNG format.
Template Page	Represents the name of the html page to use as a template for the inclusion of alternate CSS.
Legacy Render Mode Enabled	Turn ON to enable the Legacy Render Mode. This ensures PROIV fields remain visible beyond their function boundaries.
Code Page	The drop-down list displays all of the available code pages used by the current JVM, dependent on the platform used. Select the appropriate code page for the service. Default is UTF-8.
Calendar Control Enabled	Displays a calendar through which you can move to any day in any year. Turn ON the calendar control to use the calendar in the Date field.
Combobox Maximum Rows	The maximum number of rows that will be displayed in a combobox, default 5000.

Click Lite Client Rendition.

Lite Client Rendition
Resource URL	Resources (images, css, etc) will be obtained from the external URL that can be specified here. For further information see resources
Default Image Type	The image type (file extension) that Lite Client will use by default (.gif, .jpg, etc.).
Add missing Images	Enabling Add Missing Images will cause Lite Client to automatically generate disabled and mouseover images as required. Default value is "false"
Lower Case Images	Enabling Lower Case Images will cause Lite Client to take the image name supplied in the PROIV code and perform a lowercase conversion prior to attempting to locate the image. Default value is "false"

To delete a service, click Client Services and then click Delete for the service which you want to remove.
The service is deleted from the list.
Click Submit.
The Client service configuration is saved.
Note: The Client Services component is used by system administrators to set up connections details, which are sent to system users to enable them to access the application. General system users would not use this area to log onto Client applications, they may have a launch page created by their administrator, which contains connection details and made secure through the use of challenge responses.

Aurora Client Configuration

To set the Aurora client service configuration, do the following:

On the Client Connector Settings tab, click Aurora Client Configuration.
The Aurora configuration appears with default values.

Modify the configuration as required. The following table describes the fields that can be configured.

Field Name	Description
Aurora General Configuration
SSL Port Number	Represents the SSL port used by Aurora. The default port number is 9814.
Aurora Group Principal	Represents the security role used by Aurora. The default name is Aurora.
Show Output Device Selection	The default value is set to "True"; helps you to select the output device.
Help Locations
Infobar Help Directory URL	The location of the directory containing the help to be displayed in the infobar.
Infobar Main Help Page	The page to be displayed when no topic is specified.
Main Help URL	The location of the help to be displayed when the main help link is pressed.
Aurora Layout Configuration
Dashboard Maximum Panels	Represents the maximum number of panels in the Aurora Dashboard. The default number of panels supported are 5.
Sideboard Maximum Panels	Represents the maximum number of panels in the Aurora sideboard. The default value is 1.
OpenClient Configuration
OpenClient Service Name	Represents the name of the OpenClient that Aurora will use. The default service name is "Aurora".
Gateway Configuration
CODIV	The company/Division code required for running the Aurora tasks in the Gateway. The default value is "PTI".
Operator ID	The operator ID required for running the Aurora tasks in the Gateway. The default value is "TSK".
Operator Password	The operator password used to access the PROIV application. The default value is "TSK".
Encoding	The character encoding used for data transfer. The default value is "UTF-8".
Port Number	Represents the port number used by Aurora. The default port number is 9835; however, you can modify as required.

Click Submit.
The Aurora service configuration is saved.