Using the Egeria Ecosystem UI¶

With the simple environment we have set up, we can now start exploring the Egeria Ecosystem UI.

Setting up connectivity to the UI¶

To use the Ecosystem UI you will need to forward a port so that the browser can communicate with the Egeria Ecosystem UI application.

At a Terminal run:

kubectl port-forward service/base-presentation 8091:8091

Using the UI¶

IMPORTANT Use an up to date Chrome browser.

• In the browser go to https://localhost:8091/org/login

You should now see a screen like this

• login with userid garygeeke and password admin

Note the login details here are hard-coded for demonstration purposes.

You should now see a screen like this:

Type Explorer¶

Egeria has a rich set of open types that are used by the OMRS . These types can be for entities, relationships and classifications. In order to write connectors, work with the internals of Egeria or just to understand the scope of Egeria, you may want to familiarise yourself with the types. There are hundreds of open types. The Type Explorer allows you to explore the types on a server. More information can be found in the Type Explorer User Guide

Using the Type Explorer¶

• Click on the Type Explorer in the left navigation pane.
• You will see one server called mds1. Click that and you should see:

The screen shows a horizontal tree showing the entity hierarchy.

• You may want to know more about a particular entity type. You do this by setting the focus on that type by:
• clicking a node on the canvas. or
• selecting an entity type from the dropdown Once an entity type has focus, it will be coloured blue and its properties will be displayed. The properties of an entity type include attributes and its relationships.
• For this dojo try choosing an entity type - for example Asset.
• You can toggle the view to neighbourhood view. After changing the view, you should see The neighbourhood view centers around an entity type (in this case Asset) and shows it's possible relationships and the type of the entity at the other end of the relationship.

There is a checkbox called Enterprise. When checked this shows an enterprise view of the types i.e. the selected servers view of all the types it can see, including types from other servers in its cohorts .

Over time new releases of Egeria deprecate types. The deprecated types can still be used, but in time may be removed. Most of the time it is not useful to see the deprecated types. It is possible to use Type Explorer to explore deprecated types and attributes. There is a checkbox called Include deprecated types to include deprecated types. There is a checkbox called Include deprecated attributes to include deprecated attributes.

Dino¶

Dino allows you to explore the operational environment of the Egeria ecosystem. More information can be found in the Dino User Guide

Using Dino¶

• Click on the Dino in the left navigation pane.
• Choose platform and mds1. As you open sections on the left navigation pane, the operational landscape picture is updated. Here is an example after I opened some sections.

Glossary Author¶

More information can be found in the Glossary Author User Guide

Using the Glossary Author¶

• Click on the Glossary Author in the left navigation pane. You should see:
• Glossaries contain Terms and Categories. This initial screen shows the list of all glossaries, in a system with no glossaries, we expect this screen to be empty.
• To create a glossary press the +, follow the wizard - call it "testglossary1" on the first screen, and press the Create when finished.
• You should now see
• toggle to see the table view
• toggle back to card view and select the glossary
• you will notice that some action buttons have appeared at the top of the screen.
• the first is to quickly create terms; quickly putting in names and descriptions of terms is something that is useful as part of innovation/ planning sessions to get terms defined quickly.

The green ticks indicate that the terms have been created where there was a name.

• Back on the glossary card screen, you will notice that there are other icons to the right of the quick terms, respectively they are:

• Children icon shows the children of the glossary, any Terms or Categories. if you click on this you will see there are no Categories. Switch to the Terms tab and there should be no terms.

  • you can create terms using the + button.
• edit allows you to update the glossary
• canvas - this shows a canvas view of the glossary
• delete - this allows the glossary to be deleted- this will only work if there is no active content in the glossary.
• Create 4 terms in the glossary,
• Create terms called term1 and term2 in the Glossary children terms view using the +.
• Press the breadcrumb Glossaries switch to the Terms tab and use the +. Create terms called term3 and term4.
• You should see

• Navigate to the glossary children and select a term (term4) in my example. Press the canvas button. You will notice that there is a node on the canvas that is selected and it's properties are displayed.

• On the canvas press the Explore
  This screen shows you the relationships and nodes that this term is directly connected to. In this case the Term is connected to a glossary via the TermAnchor relationship. Select all and should see

• In this canvas view, you cannot delete the starting node, but you can use the other buttons to explore, create, update content.
• Try pressing "Create Node", to create a term called term5. This will be added to the canvas - you may need to scroll down to see this new Term. You can drag content around the canvas as required.

• Notice that you can use the breadcrumb to navigate back to previous screens
• Notice on the card and table views there are paging controls to allow you to alter the number of elements displayed on the screen.
• You can use the + button on the category tab to create a new category, and optionally specify a parent category. In this way you can author a category hierarchy.

Repository Explorer¶

The Repository Explorer allows the user to explore Open Metadata Instances If you know the guid of an entity you can enter it and start exploring. More usefully you can start your exploration using a text search restricted by types. More information can be found in the Repository Explorer User Guide

Using the Repository Explorer¶

• Click on the Repository Explorer in the left navigation pane.
• You will see one server called mds1. Click that and you should see:

If you have are running this UI on an empty system, there will be no entities in the system. If this is the case then you can either run some of the notebooks to create Egeria content or use the glossary author user interface to create glossary content you can then explore. The following assumes you have created glossary with terms named term1 term2 term3 and term4, also a category called cat1 with a child category cat2 using the Glossary Author

• select the server mds1 search for '.*' with type Glossary
• Click Search for instances You will see the search list showing one glossary
• Select all and press OK
• you will see that there is now a selected node on the canvas
• Click Explore you should see a pre-traversal screen showing the relationships and related entities with their type and the number of them in brackets.
• Click Select All and OK. Select Cat1. You will see a screen like this:
• Click Cat1 then Explore in the pre traversal popup, Select all and OK. You should see:
• click on a TermAnchor to give it focus and you should see the properties of that relationship

Note that

• only the additional relationship was added (existing content is augmented, not replaced).
• you can press Undo to undo the last traversal
• you can press History to see the history.
• by default later content is added down the canvas with the Time-based layout. You can toggle the layout to Proximity-based; to see a layout based on proximity only.
• Nodes on the canvas can be dragged and pinned.
• There is an Enterprise flag, when not set, only entities in a particular repository are shown, otherwise an enterprise view is used.

Server Author¶

The Server Author is an authoring UI to create new server configurations. This is currently being developed and will support all the server types. In this dojo you will create a Access Store Server.

More information will be found in the Server Author User Guide , but this documentation is still in the process of being written.

Using the Server Author¶

• Click on the Server author in the left navigation pane.
• You will see the existing servers
• Click Create New and choose Access Store Server from the dropdown
• Click Process to Basic. Call the new server (Server Name) dojo1 and add a Local user Id of dojo1.
• Click Process to Repository and choose Non-temporal local Graph (Janus) from the dropdown.
• Click Proceed to Event Bus . This currently defaults, but will be customisable in the near future.
• Click Proceed to Cohorts and add a name for the cohort you will use.
• You will now see a list of cohorts this server will be part of.
  
• Click Proceed to Access Services and select all
• Click Proceed to Archives, then Proceed to Audit Log
• There is no need to add an audit log as there is a default, but here we will add a second json style audit log. Press Create new Then change the name to be json and the type from the dropdown to be Json. You can click which severity messages should go to this audit log as well.
• Press Issue add You will see the default console audit log and your new audit log destination. You can select an audit log and update it or delete it.
• Click Proceed To Configured then Finished You will not see your server in the list, as the Dojo is running on release 3.4, this issue is fixed in the latest Egeria Ecosystem UI code .
• to see your server in the list, choose 'Repository Explorer' , then 'Server Author' in the left navigation pane and you should see the new server

Next Step¶

We will now continue looking at Configuring and operating an Egeria server

Raise an issue or comment below