"GI-conf" GI-cat configurator

Download User guide GI-conf as stand-alone application Authentication Configuration management Select a configuration Add a new configuration Remove a configuration Export a configuration Import a configuration Manage the published interfaces Publish/unpublish interfaces Edit interfaces context path Save changes, create a report and view the service capabilities document Manage the federated resources Edit a resource Add a resource Remove a resource Saving changes and create a report

Overview

This is the user friendly approach for GI-cat configuration, you are encouraged to use it.

GI-conf is included with GI-cat in the Auto Installer Package, or as a stand-alone application in order to configure a GI-cat instance installed with the Java Multiplatform WAR Package.

In the main dialog ( see figure above ), you can find a graphical overview of the GI-cat published interfaces ( on the left side ) and federated resources ( right side ), each represented by a specific icon. As described hereinafter, you can click an icon to view and edit the correspondant interface or resource properties.

Download

For GI-cat 6.*

Download

For GI-cat 7.*

Download

After a GI-cat installation using the Java WAR Package, you can download GI-conf in order to configure it.

User guide

GI-conf as stand-alone application

When using GI-conf as a stand-alone application, it's necessary to provide the endpoint of the GI-cat instance to configure, as depicted in the image below.

Authentication

A password is needed to configure GI-cat.

If you install GI-cat with the Auto Installer Package, you can set the password during with the installation wizard.

If you install Gi-cat with the Java WAR Package, the default password topsecret will be used; we suggest you to set a new password editing the file ${GI-CAT_WEBAPP_DIR}/conf/gi-cat.realm.xml.
Restart the webapp after the password change.

After the application start up, you will be asked to enter the authentication password as depicted in the image below.

Figure 1. Authentication form

Configuration management

GI-cat can have one or more configurations. You can manage the configurations by means of the "Configuration manager" accessible either by clicking the button depicted in the image below ( Figure 2 )

Figure 2. The configurations drop-down menu and the "Configuration manager" button

or by selecting "Manage configurations" in the toolbar tools menu.

Figure 3. The "Configuration manager" dialog

Every configuration has a name used as unambiguous identifier, and identifies a set ( possibly empty ) of published interfaces and one or more federated resources. The "default" configuration included in the GI-cat distribution, publishes the standard OGC CSW 2.0.2 AP ISO interface and federates an example WMS.

Follows the list of configurations related operations.

Select a configuration

You can select a configuration either from the drop-down menu as depicted in the Figure 2, or by means of the "Configuration manager" ( see Figure 3 )

Add a new configuration

When you add a new configuration, it will be created as a copy of the currently selected configuration.

Figure 4. The form by wich to add a new configuration

To add a new configuration, press the "Add" button, then insert the desired name in the text field, as depicted in the above image ( Figure 4 ).

Note that if you type the name of an existing configuration, the "Accept" button will be disabled until you type a different name.

Remove a configuration

To remove a configuration, just select it in the "Configuration manager" list, then click the related button. Note that you can not remove all the configurations; if you try to remove the last configuration, you will be informed by a notification dialog.

Export a configuration

In order to export a configuration, select it in the "Configuration manager" list and click the "Export" button, then choose a folder in the local file system, in which to store the relative file. The configuration will be saved as a file with the ".gcp" extension.

Import a configuration

In order to import a configuration, select it in the "Configuration manager" list and click the "Import" button, then choose the configuration file to import ( it must have the ".gcp" extension ). If a configuration with the name of the imported one already exists, the operation will fail and you will be informed by a notification dialog.

Manage the published interfaces

You can edit the published interfaces by means of "Interfaces editor" either by clicking the "Edit published interfaces" button on the upper-left side of the GUI, or by selecting "Edit interfaces" in the toolbar tools menu.

If you want to open the "Interfaces editor" on a specific interface, just click in the relative icon, as depicted in Figure 5 and Figure 6 below.

Figure 5. First click on an interface icon...

Figure 6. ...then edit its properties

You can choose to publish the CSW/ISO, CSW/ebRIM-CIM, and CSW/ebRIM-EO interfaces. Note that the save button is enabled only if there are some pending changes.

Follows the list of the interfaces related operations.

Publish/unpublish interfaces

To publish or unpublish an interface, just click in the correspondant check box in the "Published" column ( see Figure 5 ).

Edit interfaces context path

If an interface is published, you can edit its context path by clicking the button beside the endpoint column. The context path is the last part of the endpoint, as shown in Figure 7 ( "ebrimcim" is the context path ).

Figure 7. Edit the context path

The rightmost button in the table, can be used to copy the complete interface endpoint to the system clipboard.

Save changes, create a report and view the service capabilities document

Figure 8. Summary dialog of the published interfaces

When the editing is done, click the "Save" button to save the changes in the currently selected configuration; the summary dialog depicted in the Figure 8 above will be shown.

Figure 9. GI-cat HTML report

With the summary dialog, other than print the summary table, you can create an HTML report of the GI-cat service, that will be saved in the application folder ( %USER_HOME%GI-conf ) and opened with the default browser ( see Figure 9 above ). You can create the report even from the main dialog ( see Figure 1 ) or by selecting "Create HTML report" in the toolbar tools menu.

Figure 10. The "ESSI lab" CSW/ISO service capabilities

The button beside the endpoint ( see Figure 8), may be used to open the browser on the service capabilities document, as depicted in figure 10 above.

Manage the federated resources

You can edit the federated resources by means of "Resources editor" either by clicking the "Edit federated resources" button on the upper-right side of the GUI, or by selecting "Edit resources" in the toolbar tools menu.

As for the "Interfaces editor", if you want to open the "Resources editor" on a specific resource, just click in the relative icon, as depicted in Figure 11 and Figure 12 below.

Figure 11. First click on a resource icon...

Figure 12. ...then edit its properties

Follows the list of resources related operations.

Edit a resource

To edit a resource, select it with the "Resources editor" pane, then edit its properties by means of the the text fields and drop-down menus accessible in the "Resources properties editor" pane. Note that every resource is univocally identified by the couple "name-endpoint", so if you try to edit a resource with this properties already in use in the currently selected configuration, you will informed by a notification dialog.

If you need to restore the state of the selected resource, click the "Restore resource" button ( see Figure 12).

Add a resource

Figure 13. The dialog by wich to add a new resource

In order to add a new resource, click the "Add" button, then edit it properties in the form as depicted in Figure 13 above.

Even in this case, you will not be allowed to insert the "name-endpoint" properties of an existing resource.

Remove a resource

To remove a resource, just select it in the "Resources editor" pane, then click the "Remove" button ( see Figure 12 ).
Note that you can not remove all the resources; if you try to remove the unique resource, you will be informed by a notification dialog.

Saving changes and create a report

Figure 14. Summary dialog of the federated resources

As for the interfaces, when the resources editing is done, click the "Save" button to save the changes in the currently selected configuration and to show the summary dialog depicted in Figure 14 ( note that some endpoints are not complete, and they must be intended only as presentation purpose ).