OPENWIS USER GUIDE - ADMINISTRATION PORTAL

Transcription

1 Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page: 1/80 Agency or Service : ISTNI Project : OpenWIS OPENWIS USER GUIDE - ADMINISTRATION PORTAL Written by : Yannick Lizzi (Akka), Alexia Audevart (Akka), Mathieu Silgado (Akka), Marc Brüggen (VCS) Diffused to : Météo-France UK MetOffice MFI Authorized by : D. Cher AKKA Informatique et Systèmes Siège social : 3 rue Thierry Le Luron LEVALLOIS PERRET Tél BORDEAUX - BREST - BRUXELLES - CLERMONT-FERRAND - GRENOBLE - LILLE - LONDRES - LYON - MARSEILLE - MONTPELLIER - NANTES - PARIS - RENNES - SOPHIA-ANTIPOLIS - STRASBOURG - TOULON - TOULOUSE - VALENCE UGA-OpenWIS-1-AdminPortal-v01.2

2 DOCUMENT MODIFICATIONS Vers. Date Modified Paragraphs Comments /08/2011 First diffusion /03/2012 All sections Iteration 3-7 Splitting of User Guide into 2 User Guides for User and Administration portals /04/ Configure synchronization section added Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 2/80

3 TABLE OF CONTENTS 1 INTRODUCTION ADMINISTRATION PORTAL Alarms Recent events Global reports Metadata Service Create metadata Insert metadata Configure harvesting Configure synchronization Monitor catalogue content Catalogue statistics Templates Index Thesauri management Category management Data Service Monitor current requests Requests statistics Cache configuration Browse content Cache statistics Blacklisting Security Service SSO Management User management Group management Data policy management Backup Availability of local system Availability of remote system System Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 3/80

4 2.6.1 System configuration Personal information User information Change my password APPLICABLE AND REFERENCE DOCUMENTS (A/R) GLOSSARY AND ACRONYMS Glossary Abbreviations Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 4/80

5 1 INTRODUCTION The guide describes the functionalities provided by the OpenWIS Administration portal. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 5/80

6 2 ADMINISTRATION PORTAL 2.1 ALARMS Recent events The Recent Events page offers a searchable view of every event, alarm and error raised by the Dataservice module. The event table provides the date of the event, the component and process raising it, a severity parameter (INFO, WARN, ERROR) as well as a more detailed description. To be able to read the sometimes longer Description filed, an appropriate tooltip is displayed when moving the curser over a table field. By specifying search parameters (i.e. start- and end-date, the severity parameter, a process, a component or a description) the table can be configured to show only those events matching the given parameters. The parameters for Process, Component, and Description may contain the wildcard character % (see screenshot for an example). List of events: Event Severity Comment The arrival of critical, high priority data WARN A new high priority data (GTS Priority 1 or 2) has been ingested. The component X is in a degraded state ERROR One of the component (Ingestion, Feeding, Replication) Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 6/80

7 The loss or corruption of data ERROR A corrupted data (bad file, wrong format ) has been received and rejected. (in temp folder) Metadata validation failed ERROR The validation of a metadata has failed (insert, harvesting, synchronization) The ingestion of data for which no metadata record exists The size of the data Cache exceeds a defined value Dissemination request exceeds a predefined threshold Number of entries in the DAR catalogue exceeds a defined threshold Administrators and Operators fail authentication Unauthorized access attempt to the system from user Number of registered users exceeds a defined threshold Number of active authenticated users exceeds threshold Number of active anonymous users exceeds a defined threshold WARN WARN WARN WARN WARN WARN WARN WARN WARN A high priority (GTS priority 1 or 2) product has been ingested whereas no associated metadata was found. Hence a Stop-Gap metadata has been created. A dissemination request for one user request exceeds a predefined threshold. The number of metadata in the catalogue exceeds a pre-defined threshold. An attempt to authenticate as Administrator or Operator failed. When a user tries to access the system via federation whereas he is not allowed to When the number of registered users exceeds the threshold When the number of concurrent authenticated users exceeds the threshold When the number of concurrent anonymous users exceeds the threshold Delivery failed on dissemination system ERROR Error while trying to disseminate via the Dissemination Harness Size of products in one Staging Post exceeds threshold Failure to contact a local data source or when extraction fails Harvesting/synchronization task is complete WARN ERROR INFO When the total size of products in Staging Post of one user exceed the threshold Error while trying to access a Local Data Source (dedicated harness) User requests an extension of privileges INFO A user has requested a privilege extension for accessing (request/subscribe) a specific data Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 7/80

8 2.1.2 Global reports The Global Reports page offers sort-able table views for different data statistics. A period of 1 to 10 days can be specified to filter those statistics Volume of data disseminated per day The table contains the size of the data that has been disseminated to a given user on a specific date as well as that user s data threshold Overall volume of data disseminated and extracted per day This table contains the size of all the data that has been extracted and disseminated on a specific date Volume of data ingested per day This table contains the size of the data that has been ingested on a specific date Overall volume of data replicated per source and per day This table contains the size of all data replicated from a given source on a specific date. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 8/80

9 2.2 METADATA SERVICE Create metadata Create metadata is accessible for editors or operator only. It offers the possibility to create a new metadata record from an existing metadata template. The metadata URN (unique identifier) must comply with a pre-defined format: urn:x-wmo:md:<authority>:<unique identifier> To create a new metadata: - Set the authority and a unique identifier (in the scope of the given authority) - Choose a pre-defined Template - Choose a Category - Click on Create button to create the new metadata Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 9/80

10 The metadata editor is then opened, allowing to edit the metadata content that has been initialized with the selected template Insert metadata Insert metadata is accessible for editors or operator only. It offers the possibility to insert a new metadata record in the system from an metadata XML file. Select your local metadata by clicking the Browse button, and adapt the file type (single file or MEF File). You can insert simultaneously several metadata by clicking on New button. Removing a file can be done by clicking the button. Up to 10 metadata can be added at a time. Continue by selecting: - the style sheet: an XSL transformation will then be applied before inserting the metadata - the type of validation: None, XSD or XSD and Schematron - the metadata category in which the metadata will be assigned Click on Insert to create the metadata. At the end of import, a report is presented showing the number of success/failure and the list of metadata that have been created and the list of errors. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 10/80

11 2.2.3 Configure harvesting Harvesting is the process of collecting remote metadata and storing them locally. This process could be manually launched or scheduled as a periodic task Create/Modify a task To define a new harvesting task click New and choose the desire harvester: Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 11/80

12 You can modify the task definition by selecting it in the table and click on Edit. For both creation and edition of a harvesting task, a task definition dialog will then be shown, to define the parameters of the task. Some parameters are shared by all harvesting protocols and some are specifics. The shared parameters are: - Name: the harvesting task name (information only) - Run mode: o o On request: the task need to be run manually Recurrent: the task is run with a recurrent frequency expressed in Day/Hour/Minutes and will start immediately after creation (unless it s a backup task) - Validation: validation level of metadata before importing into the system (No Validation, XSD, XSD and Schematron) - Categories: the category to which the imported metadata will belong to after import Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 12/80

13 Note about Category: in case the metadata already exists in the catalogue, the metadata content will be updated if the harvested metadata is more recent than the existing one. If the selected category of the harvesting task differs from the category of the current metadata, the original category is kept, unless this category was draft. The following sections describe the parameters specific for each harvesting protocol OAIPMH The following specific parameters may be set for an OAIPMH harvesting task; - URL: the OAIPMH server URL; on OpenWIS system, both user and admin portal may serve as OAIPMH server; the URL is then - User Account (+ login / password): optional; if the connection request an authentication - Date Interval: optional; from/to date filter applied on update date of the metadata (insertion/update/removal date) - Set: mandatory; the remote set (category) of metadata to select (click on fetch first to retrieve the possible values from server; therefore the URL needs to be set) Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 13/80

14 - Prefix: mandatory; the metadata record type; typically iso19139 (click on fetch first to retrieve the possible values from server; therefore the URL needs to be set) - Deletion supported by server: whether the OAIPMH server supports deletion propagation (normally automatically set) - Incremental: incremental harvesting or full harvesting; in case of incremental, the from filter will be updated at each run of the harvesting task to retrieve only the last changes since the last run - Backup: optional; if a Backup deployment is selected, the task is considered as a backup task that will be activated only when the backup mode is switched on for the selected backup deployment File System Harvester File system may be seen as a standard harvesting task, allowing a full synchronization with the harvested directory, but it s also a convenient way to massively import a set of metadata into the Catalogue (in this case Local Import must be set). Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 14/80

15 The following specific parameters may be set for a File system harvesting task; - Directory: the location on server where to find the metadata files - Recurse: recurse or not in sub-folder - Keep local if deleted at source: to avoid deletion propagation - Local Import: whether this task is an import of metadata (or a normal harvesting task) - File type: metadata are as XML files or as part of MEF file (GeoNetwork archive) - StyleSheet: optional; a style sheet to apply before import GeoNetwork 2.0 Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 15/80

16 The following specific parameters may be set for a GeoNetwork harvesting task; - Host / Port: the Host and port of the GeoNetwork server - Servlet: Remote servlet ( geonetwork in most case) - User Account (+ login / password): optional; if the connection request an authentication - Filters: optional; query filters that will be applied when retrieving metadata; search can be performed on free text, title, abstract, keyword, options (digital/hard copy) and source - Backup: optional; if a Backup deployment is selected, the task is considered as a backup task that will be activated only when the backup mode is switched on for the selected backup deployment CSW The following specific parameters may be set for a CSW harvesting task; - Service URL: Remote CSW service; for OpenWIS or GeoNetwork system, the URL looks like: - User Account (+ login / password): optional; if the connection request an authentication - Filters: optional; query filters that will be applied when retrieving metadata; search can be performed on free text, title, abstract, keyword Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 16/80

17 - Backup: optional; if a Backup deployment is selected, the task is considered as a backup task that will be activated only when the backup mode is switched on for the selected backup deployment WebDAV The following specific parameters may be set for a WebDAV harvesting task; - URL: Remote WebDAV service - Recurse: recurse or not in subfolders - Validate: perform or not schema validation (legacy GeoNetwork option) - Backup: optional; if a Backup deployment is selected, the task is considered as a backup task that will be activated only when the backup mode is switched on for the selected backup deployment Remove a task Select the task to remove and click Remove, confirm. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 17/80

18 Warning: Removing a harvesting task will remove all the metadata via this harvesting task, except in the case of File System Harvesting when the option Local Import has been set. As a consequence, removing the harvesting task may be long, depending on the number of harvested metadata. Hence, the action may show an error because the process takes too long time, but this error may be ignored as the deletion process will still be running in background. Once the deletion process is complete, the harvested is finally removed Activate/Deactivate and Run a task You can activate/deactivate a task by selecting it in the table and click the desire button. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 18/80

19 If activate, you can run a task by clicking the button Run Remote metadata matching the harvesting request are collected locally According to the validation level selected, validation is performed For each valid metadata, manage extracted information and data policy association Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 19/80

20 Valid metadata records are locally imported into the database and linked to the extracted data policy, nonvalid metadata are logged in an error report Harvesting report Last harvesting report can be displayed by the Administrator. Select the task and click Report : Configure synchronization Synchronization tasks are specific harvesting tasks (described in previous section) with default pre-defined elements: - the protocol: OAI-PMH - the options: always incremental with deletion propagation - scheduling: recurrent - category (Set): the remote Set must correspond to a local category; the remote set is selected and the metadata will be assigned to the category of the same name (Refer to section for details on OAI-PMH task configuration) Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 20/80

21 2.2.5 Monitor catalogue content The page Monitor Catalogue Content offers an administration view of all the catalogue metadata and its extracted attributes. These attributes are exploited in main functions such as request processing, ingestion and feeding and can be overridden by Operators. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 21/80

22 You can filter the metadata displayed by using the text search field Duplicate You can duplicate a selected metadata by clicking the Duplicate button. Just enter a valid and not used urn and confirm, the new metadata is created based on the selected one, and the metadata editor opens. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 22/80

23 View It s possible to view the selected metadata by clicking the View button. The editor opens in viewing mode with all the metadata information. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 23/80

24 Edit You can edit the metadata of your choice by clicking Edit button. The editor opens in edition mode with all the metadata information. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 24/80

25 Edit MetaInfo By clicking the Edit MetaInfo button, the MetaInfo form is displayed, allowing the Operator to override the extracted attributes of the selected metadata. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 25/80

26 When several metadata are selected the MetaInfo, the form allows to set for all the selected metadata the following attributes: GTS category and priority, data policy. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 26/80

27 Edit Category By clicking the Edit category button you can change the metadata category of one or all the metadata selected. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 27/80

28 Remove It s possible to remove one or all the selected metadata by clicking the Remove button Export OpenWIS provide a metadata record export facility. You can export metadata records selected in XML format, as WMO Core Profile 1.1 (conformant records, provided a conversion XSLT is available for the native profile of the harvested/imported metadata) or in Metadata Export Format (MEF) XML format Select the metadata to export, click on Export/As XML. The XML file represented the metadata is displayed in another window of the navigator. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 28/80

29 As WMO Core Profile When available, this exports the selected metadata as WMO Core profile representation As MEF Select one or more metadata and click on Export/As MEF. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 29/80

30 You can open or save the MEF file. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 30/80

31 2.2.6 Catalogue statistics OpenWIS provide a statistics page for the Catalogue, including the following information : the Catalogue size the total number of metadata a table showing the volume of metadata harvested, synchronized or locally created per day and per source You can filter the information displayed by using the source search field Templates OpenWIS provide a page to administrate the templates Add template To add a template select the template format in the list: Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 31/80

32 Duplicate You can duplicate the selected template with the Duplicate button. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 32/80

33 Edit To edit the selected template click the Edit button. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 33/80

34 Remove To remove the selected template click the Remove button. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 34/80

35 Sort template Use the buttons Up and Down to sort the displayed templates, confirm by clicking Save Order Index OpenWIS provide a page to administrate the index, allowing to rebuild or optimise it Rebuild Optimize Thesauri management OpenWIS provide a page to administrate the Thesauri. Important note: All thesauri are stored as RDF files in <WEBAPP_LOCATION>/xml/codelist. When a modification is done to the thesauri list (on the Administration portal), the impacted files needs to be propagated to all the User portals. This can be a manually or via a periodic automated task (using rsync). Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 35/80

36 You can view the thesauri by expanding the thesauri type : Add a local thesauri To Add a new thesauri click, and then fill the form : Click Create to valid Upload a thesauri To upload an external thesauri, fill the form and click Upload : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 36/80

37 Download a thesauri Select the thesauri you want to download and click Download : Delete thesauri Select the thesaurus you want to remove and click Delete : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 37/80

38 View/Edit Thesauri Depending on the thesauri type you can view or edit a thesaurus Edit a local thesauri You can edit a thesauri if local, click Edit : The thesauri dialog opens. You can now manage the keywords attached to this thesaurus, as well as the relations where terms are related as broader / narrower Search a keyword To search a keyword fill the keyword search form and click search (let empty for all): Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 38/80

39 Add a keyword To add a keyword click Add : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 39/80

40 Fill the keyword form and Submit : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 40/80

41 Delete a keyword Select the keyword a click Delete : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 41/80

42 Modify a keyword To modify a keyword, select the keyword and click Edit : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 42/80

43 View an external thesauri You can view a thesaurus if external, click View : The thesauri dialog opens Search a keyword To search a keyword fill the keyword search form and click search (let empty for all): Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 43/80

44 View a keyword To view a keyword, select it and click View : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 44/80

45 Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 45/80

46 Category management The category management allows to create/edit/remove categories. Edit and Remove buttons are available when a category is selected. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 46/80

47 Create Category Enter the category name and save. The category is created Edit Category When you edit a category, you can only change the category name. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 47/80

48 Remove Category When you remove a category, you have to confirm this action. 2.3 DATA SERVICE Monitor current requests The page Monitor Current Requests allows user to list: all the current ad-hoc requests and requests generated as instances of a subscription request all the subscription It s possible to filter the list of requests and subscription by a selection of user groups, which will result in showing the requests (ad-hoc and subscription) issued by users belonging to the selected groups Current requests You can view details and discard an ad-hoc request View request Select a request and click View Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 48/80

49 The view request dialog opens : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 49/80

50 Discard a request To discard a selected request, click Discard : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 50/80

51 Current subscriptions You can edit, suspend/resume and discard a subscription View subscription Select a subscription and click View The view subscription dialog opens : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 51/80

52 Suspend/Resume a subscription To suspend or resume a subscription, select the subscription and click Suspend or Resume. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 52/80

53 Discard a subscription To discard a selected subscription, click Discard : Requests statistics OpenWIS provide a statistics page for the Requests, including the following information: Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 53/80

54 a table showing the volume of data disseminated per day and per user a table showing the volume of data disseminated and extracted per day It s possible to filter the list of data disseminated per day and per user by a user name. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 54/80

55 2.3.3 Cache configuration The Cache Configuration page allows enabling and disabling the different data services, as well as creating and removing filters for those services. Unchecking one of the checkboxes labelled Enable ingestion, Enable feeding, Enable replication or Enable dissemination will suspend those services until resetting the appropriate checkbox again. To create a new filter (ingestion, feeding or replication), click on the appropriate New button and one of the following three boxes will be shown. Just fill out the fields and click Save to save the new filter, or Cancel to discard it. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 55/80

56 To remove a filter, just select it in the appropriate table and click on the Remove button afterwards. Apart from adding or removing, replication filters can also be suspended. To suspend or reactivate a replication filter, select it in the replication filter table and click on the Activate or Deactivate button afterwards. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 56/80

57 2.3.4 Browse content The Browse content page provides a table showing the current content of the Cache. The table can be sorted on each column. For each file, the following information are shown: - The file name - The checksume of the file - The origin - The ID of the metadata (potentially several metadata) - The date when the file was inserted Cache statistics Volume of data ingested per day This is equivalent to the one described under , except there is no filtering on the date Overall volume of data replicated per source and per day This is equivalent to the one described under , except there is no filtering on the date. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 57/80

58 2.3.6 Blacklisting The purpose of blacklisting a user is to react to an excessive use of OpenWIS regarding retrieved data, or to prevent activity in contravention of IPR, regulatory or legislative constraints or a site s acceptable use policy, such as using observations to track ships for the purposes of piracy. OpenWIS must automatically detect exceeded thresholds for the volume of data and/or number of files indicators when a user requests data. Individual thresholds may be set for each user. When thresholds are exceeded, a warning is sent to the operator and the user. OpenWIS provide a Web interface to the operator to blacklist a user that has exceeded thresholds or more generally violated other terms of OpenWIS use. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 58/80

59 It s possible to filter the list by user name : You can remove users from blacklist, and to edit user thresholds. Select the user and click Edit : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 59/80

60 The edit blacklist dialog opens : Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 60/80

61 2.4 SECURITY SERVICE SSO Management The link for access to OpenAM is displayed User management The User management allows to add/edit/remove users. Users may be filtered on user group (local groups and additional groups) and/or on username, last name and first name Add User Three tabs must be filled: The personal Information: o User name o Last Name o First Name Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 61/80

62 o o o o o o o Password Address City State Zip Country Contact The privileges o Profile o Groups o Class of Services o Need user account o Backup Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 62/80

63 The favorites with RMDCN and Public FTP or . o RMDCDN and Public FTP: Host (mandatory) Path (mandatory) Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 63/80

64 User (mandatory) Password (mandatory) Port Passive Check File Size File Name o RMDCN and Public Address (mandatory) Header Line TO/CC/BCC Subject Attachment mode : As Attachment or Embedded in body File Name Edit User The same GUI like in the previous chapter Add User is showed. All fields may be updated except the username. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 64/80

65 Remove User Select one or several users into the user management list and click on remove Import User The function Import user allows to import users who belongs to other centre of the circle of trust. Users may be filtered on username, last name and first name. When a user is importing, he is automatically added to the DEFAULT group of the deployment Group management The group management allows to create/edit/remove/synchronize groups. Edit and Remove buttons are available when a group is selected. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 65/80

66 Create Group Enter the group name and check the box if the group is global and save. The group is created Edit Group When you edit a group, you can only change the group name. You can t change the fact that a group is defined as global or local Remove Group When you remove a local group, you have to confirm this action. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 66/80

67 When you remove a global group, a message is displayed and warns the user that this modification will impact all other deployments of the circle of trust Synchronize Group Synchronize group allows to synchronize the database of the administrated Centre with the LDAP, which can be shared among several Centres. This feature is useful to propagate a change that has been made on a Global group in one Centre to the other Centres. When you click on synchronize: If there is no modification, this message is displayed. If there are modifications, the list of modifications are displayed : Clicking on Yes will proceed with the described changes Data policy management The data policy management allows to create/edit/remove/export data policy. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 67/80

68 Create Data Policy Enter the data policy name, the description, the aliases and all operations allowed for each groups and save. The data policy is created. When you click on Add Alias, this dialog box is displayed. You have to enter the name of alias of Data policy. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 68/80

69 You can remove alias Edit Data Policy The same GUI like in the previous chapter Create Data Policy is showed. All fields may be updated except the name of the data policy Remove Data Policy When you remove a data policy, you have to confirm this action Export Data Policy When you export the selected data policy, the XML file represented the data policy is displayed in another window of the navigator. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 69/80

70 Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 70/80

71 2.5 BACKUP Availability of local system This page shows a summarised view of the availability of the OpenWIS system components for the local Centre. The availability of metadata service: User portal: o UP: the user portal is enabled o DOWN: the user portal is unreachable o STOPPED: the user portal is disabled : see System configuration in section o UNKNOWN: URL of User portal is not configured Synchronization / Harvesting: status of the harvesting/synchronization tasks o UP: all the tasks are up without error o WARN: some tasks are in error o DOWN: the number of tasks in error is beyond a given threshold, the task is considered in error o ALL SUSPENDED: all tasks are suspended o NONE : no tasks defined Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 71/80

72 Indexing: o UP: SOLR is running o DOWN: SOLR is stopped or unreachable The availability of data service: Replication, Ingestion, Subscription processing, Dissemination: o UP: the process is active o WARN: the process runs in a degraded mode o STOPPED: the process has been stopped o UNKNOWN: the status could not be determined The availability of security service: Security Service: o UP: the security service is enabled and accessible o DOWN: the security service is in error or unreachable SSO Service: o UP: OpenAM is enable and accessible. o DOWN: OpenAM is in error or unreachable Availability of remote system The first step for know the availability of a remote system is to select this system on the combo box. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 72/80

73 Then, the availabilities of metadata, data and security services are displayed like in the previous section. The difference is that, you can t start/stop services. Backup mode When the remote monitored Centre is in trouble, an Administrator may decide to switch to backup mode for this Centre. This means that the local Centre will assume some functions of the backup GISC. To activate the backup mode for the monitored Centre, click on Turn ON backup mode. To deactivate the backup mode for the monitored Centre, click on Turn OFF backup mode. When activating the backup mode, a retro-processing of backed-up subscriptions will be managed by the local Centre, to handle the blackout period (trouble detection + turn on of backup mode). 2.6 SYSTEM System configuration Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 73/80

74 The System configuration page allows to configure the following settings: User Portal: Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 74/80

75 o o Host: the host name of the user portal (as seen from outside, used in XML services like OAI- PMH and CSW) Port: the port of the user portal Index Optimizer: o o o enable: true means that the index optimizer is activated Run at: the hour of the day (hour + minutes) Will run again every : task frequency z Configuration about Z39.50 protocol (and SRU): o o enable: true means that the z3950 / SRU server component is running port: internal port number to use to listen for incoming Z39.50 requests xlink resolver: Configuration about xlink resolver o enable: true means that the xlink resolver is activate CSW ISO Profile: CSW service configuration o o o o o Inspire: o enable: true means that the CSW server is activate title: Information retrieve by the GetCapabilities operation abstract: Information retrieve by the GetCapabilities operation fees: Information retrieve by the GetCapabilities operation Access constraints: Information retrieve by the GetCapabilities operation enable: true means that the inspire is activated Proxy: HTTP Proxy configuration o o o o o use: true means that the proxy is used when connecting to external nodes host: Proxy s server host port: Proxy s server port username: Proxy s credentials password: Proxy s credentials Feedback: A container for feedback information o o o o Authentication: o Administrator s address mailserver: server to use to send feedback host: s host address port: s port to use in host address enable: true means that the self-registration is activated (Restart of User portals is required) Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 75/80

76 2.7 PERSONAL INFORMATION User information This page allows you to edit your own user information. To modify an information, set the text field and click on Save. It also provides a way to manage your favourites of dissemination. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 76/80

77 Favourites are used when requesting/subscribing to a product, to save and retrieve FTP or configuration. This page allows you create/edit/remove configurations for FTP or Change my password Enter and confirm your new password and click on the Change Password button. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 77/80

78 3 APPLICABLE AND REFERENCE DOCUMENTS (A/R) A/R Reference Title A1 SSD-OPENWIS-001 Software Specification Dossier A2 DD-OpenWIS-1 Design Dossier Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 78/80

79 4 GLOSSARY AND ACRONYMS 4.1 GLOSSARY Term Definition Alarm Additional Data Centre Circle Of Trust (COT) Data Policy Dataset Essential Data Global Data Local Data Product instance Site Staging Post Virtual GISC Virtual Organisation An alarm is a warning message raised as a result of a predefined event. An event is what has happened, and the alarm is the warning to the operator. Additional Data are Global data, which must be accessible all around the world via GISC Systems on conditions. They are subject to specific data policies imposed by the producer NC or DCPC Deployment of OpenWIS assuming one WIS role. Set of systems that trust each other and can exchange authentication and authorization information to enable Single Sign-On and Federation defines a set of privileges related to products for locally defined user groups A dataset is a collection of geo-referenced spatial data (or products) Essential Data are Global data, which must be publicly accessible all around the world via GISC Systems The Global Data are composed of Essential Data and Additional Data. Global Data must be replicated all around the world thanks to Replication mechanism between GISCs Local Data are not accessible around the world via GISC systems. They are accessible at their producer NC or DCPC, and may be subject to specific data policies Individual occurrence of a data or product Set of several OpenWIS deployments (Centres) alternatively sharing resources (including Security Service) Accessible file repository used to distribute requested products 2 GISCs (Météo-France and UKMO) that proposes a common view of mutual services and a set of common users. In OpenWIS, a Virtual GISC implies Backup scenario and Single Sign-On capacity between the two involved GISCs Deployment of several roles (GISC, DCPC, NC) on one Site or across Sites, as described above. Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 79/80

80 4.2 ABBREVIATIONS Abbreviation DAR DCPC DISS FNC FTP GISC GTS GUI IdP MEF MSS/FSS NC RMDCN SLA SSO URN WIS WMO XML XSL Description Discovery Access Retrieval Data Collection and Production Centre Dissemination System File Naming Convention File Transfer Protocol Global Information System Centre Global Telecommunication System Graphical User Interface Identity Provider Metadata Export Format Message or File Switching System that allows Partners to exchange data via a private resilient network, the Global Telecommunication System (GTS). National Centre Existing private Wide Area Network on which all Meteorological Centre are connected Software Level Agreement Single Sign-On Uniform Resource Name WMO Information System World Meteorological Organization extensible Mark-up Language extensible Style sheet Language Ref.: UGA-OpenWIS-1 Vers.: 01.2 Date: 26/04/2012 Page : 80/80