From 7f22735f4910a603a0e1c98cd3ece86b8fd626d6 Mon Sep 17 00:00:00 2001 From: David Radley Date: Thu, 24 Sep 2020 17:28:25 +0100 Subject: [PATCH 1/5] #3682 amend the presnetaion server readme for release 2.3 Signed-off-by: David Radley Signed-off-by: Nigel Jones --- .../presentation-server/README.md | 23 +++++++++++-------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/open-metadata-implementation/user-interfaces/presentation-server/README.md b/open-metadata-implementation/user-interfaces/presentation-server/README.md index 96b191bacf8..fcf60d8d7b7 100644 --- a/open-metadata-implementation/user-interfaces/presentation-server/README.md +++ b/open-metadata-implementation/user-interfaces/presentation-server/README.md @@ -14,7 +14,9 @@ the types of [Egeria OMAG Servers](../../admin-services/docs/concepts/omag-serve ## Setting up the downstream servers To run the Presentation server, you need to have correctly [configured](../../admin-services/docs/user/configuring-an-omag-server.md) and be [operating](../../admin-services/docs/user/operating-omag-server.md) the downstream servers. - For example for the Glossary Author capability, the Presentation server issues omvs calls to the [View server](../../admin-services/docs/concepts/view-server.md) + Be aware that in addition to any existing OMAG Servers, the Presentation Server requires that you have [configured the view services](../../admin-services/docs/user/configuring-the-view-services.md) on a View Server. + + For example for the Glossary Author capability, the Presentation server issues OMVS calls to the [View Server](../../admin-services/docs/concepts/view-server.md) which issues [Open Metadata Access Service (OMAS)](../../access-services/README.md) calls to the [Access Point Server](../../admin-services/docs/concepts/metadata-access-point.md). ## Configuring the presentation server @@ -39,13 +41,6 @@ the types of [Egeria OMAG Servers](../../admin-services/docs/concepts/omag-serve called .env in the same folder and amend the values as required. * Once the .env file is in place, build and start the server using `npm start`. Use other npm parameters as specified in [package.json](nodejs/package.json). -## FOR NEW DEVELOPMENT (as of 8/2/2020) - * Currently, the UI is not optimized to run in development mode. Developers must rebuild the static files every time a change is made. - * Because of this, work is currently underway to remake the client with Create React App. This will be done iteratively, and updates posted here. - * Old client code will be maintained until the cutover is complete, so developers can run the traditional way if desired. - * The new client is maintained in the cra-client directory. - * Set up your environment by running `yarn`. - * Enter `http://localhost:3000/` to access the new UI in development mode. ## Access UI using the browser. * Enter 'https://localhost:8091//' on the UI to access the tenanted UI ( is the serverName used by the presentation server). The Ui will prompt for a login; some of the @@ -53,9 +48,17 @@ the types of [Egeria OMAG Servers](../../admin-services/docs/concepts/omag-serve ` EGERIA_PRESENTATIONSERVER_SERVER_aaa={"remoteServerName":"cocoView1","remoteURL":"https://localhost:9443"}` then the browser url to use to login is `https://localhost:8091/aaa`. All browser requests for this tenant will be issued using urls starting `https://localhost:8091/aaa`. - - +## There is on-going work to enhance the development experience + * The build described a production build; meaning everything is rebuilt each time a change is made. + * There is ongoing work to allow developers to do be able to make changes and hot swap them into a running server. + * The ongoing work is being tracked in issue [Git issue 3543](https://github.com/odpi/egeria/issues/3543) + * The work involves using Create React App. This will be done iteratively, and updates posted here. + * The existing code is in the client folder which contains the latest presentation source code. + * The new work is being developed the cra-client directory. + + + ---- License: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), Copyright Contributors to the ODPi Egeria project. \ No newline at end of file From 97cb4e024fc38c0525198e8d0ec1f5c99d605be7 Mon Sep 17 00:00:00 2001 From: David Radley Date: Thu, 24 Sep 2020 17:40:35 +0100 Subject: [PATCH 2/5] #3682 add descriptions of the Ui capabilities Signed-off-by: David Radley Signed-off-by: Nigel Jones --- .../presentation-server/README.md | 24 +++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) diff --git a/open-metadata-implementation/user-interfaces/presentation-server/README.md b/open-metadata-implementation/user-interfaces/presentation-server/README.md index fcf60d8d7b7..d5005792a5a 100644 --- a/open-metadata-implementation/user-interfaces/presentation-server/README.md +++ b/open-metadata-implementation/user-interfaces/presentation-server/README.md @@ -11,6 +11,20 @@ servers. See the [Egeria Planning guide](https://github.com/odpi/egeria/tree/master/open-metadata-publication/website/planning-guide) to familiarise yourself with the types of [Egeria OMAG Servers](../../admin-services/docs/concepts/omag-server.md); Presentation Server is one of those servers. +There are 2 types of capabilities exposed in the Presentation Server. +- Integration Server capabilities +- Governance Solution capabilities + + +### Integration Server capabilities + +- Type Explorer: allowing the use to explore the Egeria open types +- Repository Explorer: allowing the user to explore Egeria instances +- Server author: allowing the user to configure a server. This is work in progress. +- Dino: allowing a user to see and work with Egeria platforms and servers operationally. + +### Governance Solution capabilities +- Glossary Author: allowing a Glossary author use to create, update and delete Glossary content. ## Setting up the downstream servers To run the Presentation server, you need to have correctly [configured](../../admin-services/docs/user/configuring-an-omag-server.md) and be [operating](../../admin-services/docs/user/operating-omag-server.md) the downstream servers. @@ -33,6 +47,8 @@ the types of [Egeria OMAG Servers](../../admin-services/docs/concepts/omag-serve ` EGERIA_PRESENTATIONSERVER_SERVER_aaa={"remoteServerName":"cocoView1","remoteURL":"https://localhost:9443"}` * To run the presentation server in production, use the presentation server assembly and specify the environment variables as required. + + ## For development * Add the presentation-server folder into [Visual Studio Code](https://code.visualstudio.com/). It will create a new workspace. * You can open a terminal in Visual Studio code to issue the npm commands @@ -50,12 +66,12 @@ the types of [Egeria OMAG Servers](../../admin-services/docs/concepts/omag-serve `https://localhost:8091/aaa`. ## There is on-going work to enhance the development experience - * The build described a production build; meaning everything is rebuilt each time a change is made. + * The build described above is a production build; meaning everything is rebuilt each time a change is made. * There is ongoing work to allow developers to do be able to make changes and hot swap them into a running server. * The ongoing work is being tracked in issue [Git issue 3543](https://github.com/odpi/egeria/issues/3543) - * The work involves using Create React App. This will be done iteratively, and updates posted here. - * The existing code is in the client folder which contains the latest presentation source code. - * The new work is being developed the cra-client directory. + * The work involves using Create React App. This will be done iteratively. + * The current latest client code is in the client folder. + * The new work is being developed the cra-client directory and may contain out of data presentation server source code. From 1c95bb85e35762d8977becd1e78d2b9fa9949e54 Mon Sep 17 00:00:00 2001 From: David Radley Date: Thu, 24 Sep 2020 17:44:16 +0100 Subject: [PATCH 3/5] #3682 correct typo Signed-off-by: David Radley Signed-off-by: Nigel Jones --- .../user-interfaces/presentation-server/README.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/open-metadata-implementation/user-interfaces/presentation-server/README.md b/open-metadata-implementation/user-interfaces/presentation-server/README.md index d5005792a5a..e48f81b736b 100644 --- a/open-metadata-implementation/user-interfaces/presentation-server/README.md +++ b/open-metadata-implementation/user-interfaces/presentation-server/README.md @@ -14,7 +14,6 @@ the types of [Egeria OMAG Servers](../../admin-services/docs/concepts/omag-serve There are 2 types of capabilities exposed in the Presentation Server. - Integration Server capabilities - Governance Solution capabilities - ### Integration Server capabilities @@ -47,8 +46,6 @@ There are 2 types of capabilities exposed in the Presentation Server. ` EGERIA_PRESENTATIONSERVER_SERVER_aaa={"remoteServerName":"cocoView1","remoteURL":"https://localhost:9443"}` * To run the presentation server in production, use the presentation server assembly and specify the environment variables as required. - - ## For development * Add the presentation-server folder into [Visual Studio Code](https://code.visualstudio.com/). It will create a new workspace. * You can open a terminal in Visual Studio code to issue the npm commands @@ -57,7 +54,6 @@ There are 2 types of capabilities exposed in the Presentation Server. called .env in the same folder and amend the values as required. * Once the .env file is in place, build and start the server using `npm start`. Use other npm parameters as specified in [package.json](nodejs/package.json). - ## Access UI using the browser. * Enter 'https://localhost:8091//' on the UI to access the tenanted UI ( is the serverName used by the presentation server). The Ui will prompt for a login; some of the Coco Pharmaceutical personnas have been enabled here - use user 'faith' and password 'admin'. If there is an environment variable : @@ -71,10 +67,8 @@ There are 2 types of capabilities exposed in the Presentation Server. * The ongoing work is being tracked in issue [Git issue 3543](https://github.com/odpi/egeria/issues/3543) * The work involves using Create React App. This will be done iteratively. * The current latest client code is in the client folder. - * The new work is being developed the cra-client directory and may contain out of data presentation server source code. + * The new work is being developed the cra-client directory and may contain out of date presentation server source code. - - ---- License: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), Copyright Contributors to the ODPi Egeria project. \ No newline at end of file From 61f781462fc2edaddd876155d6ed9d14a92c0275 Mon Sep 17 00:00:00 2001 From: Nigel Jones Date: Fri, 2 Oct 2020 10:03:17 +0100 Subject: [PATCH 4/5] #3683 additional updates for release 2.3 Signed-off-by: Nigel Jones --- .../presentation-server/README.md | 51 +++++++++++-------- 1 file changed, 31 insertions(+), 20 deletions(-) diff --git a/open-metadata-implementation/user-interfaces/presentation-server/README.md b/open-metadata-implementation/user-interfaces/presentation-server/README.md index e48f81b736b..6c4101e75e9 100644 --- a/open-metadata-implementation/user-interfaces/presentation-server/README.md +++ b/open-metadata-implementation/user-interfaces/presentation-server/README.md @@ -12,50 +12,50 @@ See the [Egeria Planning guide](https://github.com/odpi/egeria/tree/master/open- the types of [Egeria OMAG Servers](../../admin-services/docs/concepts/omag-server.md); Presentation Server is one of those servers. There are 2 types of capabilities exposed in the Presentation Server. -- Integration Server capabilities -- Governance Solution capabilities +- Integration View Services +- Governance Solution View Services -### Integration Server capabilities +### Integration View Services -- Type Explorer: allowing the use to explore the Egeria open types -- Repository Explorer: allowing the user to explore Egeria instances -- Server author: allowing the user to configure a server. This is work in progress. +- Type Explorer: allowing a user to explore the Egeria open types +- Repository Explorer: allowing a user to explore Egeria instances +- Server Author: allowing a user to configure a server. This is work in progress. - Dino: allowing a user to see and work with Egeria platforms and servers operationally. -### Governance Solution capabilities -- Glossary Author: allowing a Glossary author use to create, update and delete Glossary content. +### Governance Solution View Services +- Glossary Author: allowing a Glossary Author use to create, update and delete Glossary content. ## Setting up the downstream servers - To run the Presentation server, you need to have correctly [configured](../../admin-services/docs/user/configuring-an-omag-server.md) and be [operating](../../admin-services/docs/user/operating-omag-server.md) the downstream servers. + To run the Presentation Server, you need to have correctly [configured](../../admin-services/docs/user/configuring-an-omag-server.md) and be [operating](../../admin-services/docs/user/operating-omag-server.md) the downstream servers. Be aware that in addition to any existing OMAG Servers, the Presentation Server requires that you have [configured the view services](../../admin-services/docs/user/configuring-the-view-services.md) on a View Server. - For example for the Glossary Author capability, the Presentation server issues OMVS calls to the [View Server](../../admin-services/docs/concepts/view-server.md) + For example for the Glossary Author capability, the Presentation Server issues Open Metadata View Server (OMVS) calls to the [View Server](../../admin-services/docs/concepts/view-server.md) which issues [Open Metadata Access Service (OMAS)](../../access-services/README.md) calls to the [Access Point Server](../../admin-services/docs/concepts/metadata-access-point.md). -## Configuring the presentation server -* The presentation server supports multi-tenants. A presentation server tenant has a serverName and associated configuration. -* The configuration for the presentation server is minimal, only specifying how to access a downstream server. -* The each tenant's configuration is specified in an environment variable that contains the tenants serverName. +## Configuring the Presentation Server +* The Presentation Server supports multi-tenants. A Presentation Server tenant has a serverName and associated configuration. +* The configuration for the Presentation Server is minimal, only specifying how to access a downstream server. +* Each tenant's configuration is specified in an environment variable that contains the tenant's serverName. * The environment variable is called `EGERIA_PRESENTATIONSERVER_SERVER_` when the is the tenants serverName. * The value of the environment variable is a json payload with 2 named properties - * `remoteServerName` the remote server name - * `remoteURL` the remote url. + * `remoteServerName` the remote view server name. + * `remoteURL` the server root url for the view server. * An example of the environment variable you would specify for a UI tenant with server name `aaa` with a remote server name ` cocoView1` and remote URL of `https://localhost:9443 ` is ` EGERIA_PRESENTATIONSERVER_SERVER_aaa={"remoteServerName":"cocoView1","remoteURL":"https://localhost:9443"}` -* To run the presentation server in production, use the presentation server assembly and specify the environment variables as required. +* To run the Presentation Server in production, use the Presentation Server assembly and specify the environment variables as required. ## For development * Add the presentation-server folder into [Visual Studio Code](https://code.visualstudio.com/). It will create a new workspace. - * You can open a terminal in Visual Studio code to issue the npm commands + * You can open a terminal in Visual Studio Code to issue the npm commands * Set up your environment by running `npm install` * Developers can specify the environment variable(s) in a .env file, by copying [.env_sample](nodejs/.env_sample) to a file called .env in the same folder and amend the values as required. * Once the .env file is in place, build and start the server using `npm start`. Use other npm parameters as specified in [package.json](nodejs/package.json). ## Access UI using the browser. - * Enter 'https://localhost:8091//' on the UI to access the tenanted UI ( is the serverName used by the presentation server). The Ui will prompt for a login; some of the + * Enter 'https://localhost:8091//login' on the UI to access the tenanted UI ( is the serverName used by the presentation server). The Ui will prompt for a login; some of the Coco Pharmaceutical personnas have been enabled here - use user 'faith' and password 'admin'. If there is an environment variable : ` EGERIA_PRESENTATIONSERVER_SERVER_aaa={"remoteServerName":"cocoView1","remoteURL":"https://localhost:9443"}` then the browser url to use to login is `https://localhost:8091/aaa`. All browser requests for this tenant will be issued using urls starting @@ -67,7 +67,18 @@ There are 2 types of capabilities exposed in the Presentation Server. * The ongoing work is being tracked in issue [Git issue 3543](https://github.com/odpi/egeria/issues/3543) * The work involves using Create React App. This will be done iteratively. * The current latest client code is in the client folder. - * The new work is being developed the cra-client directory and may contain out of date presentation server source code. + * The new work is being developed in the cra-client directory and may contain out of date Presentation Server source code. + +## There is ongoing work to enhance the ability to easily run the new services in a demo environment + * The Coco Pharmaceuticals 'lab' tutorial environment will now configure the view services, and allow a user to experiment with the Presentation Server + * The 'egeria-server-config' notebook has code added to configure the view services - so once this & egeria-server-start is run, Presentation Server is available. + * The Presentation Server code is built under maven (mvn clean install) & added to a new assembly (open-metadata-distribution/open-metadata-assemblies) as part of the overall build. + * A new docker image is created as 'odpi/egeria-presentation-server' containing Presentation Server. + * Our docker-compose based tutorial now has Presentation Server included & configured via the environment variable, and accessed at https://localhost:18091/coco/login . + * The Kubernetes tutorial 'odpi-egeria-lab' has also been updated similarly, with the Presentation Server UI being acessible via port 30091 - ie access via https:</coco.login + * For the lab environment it is recommended to use user 'garygeeke' and password 'admin' since this environment has security setup, and other users including faithbroker will not have access to all capabilities. + * This is still work in progress. For example if the session times out you will need to go to the UI URL again manually. + * Contact us via Slack on odpi.slack.com to get additional guidance. ---- License: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), From 76e961ef6cc3c205ec918c7f0898c2156e90a263 Mon Sep 17 00:00:00 2001 From: Nigel Jones Date: Fri, 2 Oct 2020 10:39:28 +0100 Subject: [PATCH 5/5] #3733 add review comments Signed-off-by: Nigel Jones --- .../user-interfaces/presentation-server/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/open-metadata-implementation/user-interfaces/presentation-server/README.md b/open-metadata-implementation/user-interfaces/presentation-server/README.md index 6c4101e75e9..21af5299147 100644 --- a/open-metadata-implementation/user-interfaces/presentation-server/README.md +++ b/open-metadata-implementation/user-interfaces/presentation-server/README.md @@ -40,7 +40,7 @@ There are 2 types of capabilities exposed in the Presentation Server. serverName. * The value of the environment variable is a json payload with 2 named properties * `remoteServerName` the remote view server name. - * `remoteURL` the server root url for the view server. + * `remoteURL` the platform root url for the view server. * An example of the environment variable you would specify for a UI tenant with server name `aaa` with a remote server name ` cocoView1` and remote URL of `https://localhost:9443 ` is ` EGERIA_PRESENTATIONSERVER_SERVER_aaa={"remoteServerName":"cocoView1","remoteURL":"https://localhost:9443"}` @@ -56,7 +56,7 @@ There are 2 types of capabilities exposed in the Presentation Server. ## Access UI using the browser. * Enter 'https://localhost:8091//login' on the UI to access the tenanted UI ( is the serverName used by the presentation server). The Ui will prompt for a login; some of the - Coco Pharmaceutical personnas have been enabled here - use user 'faith' and password 'admin'. If there is an environment variable : + Coco Pharmaceutical personnas have been enabled here - use user 'faithbroker' and password 'admin'. If there is an environment variable : ` EGERIA_PRESENTATIONSERVER_SERVER_aaa={"remoteServerName":"cocoView1","remoteURL":"https://localhost:9443"}` then the browser url to use to login is `https://localhost:8091/aaa`. All browser requests for this tenant will be issued using urls starting `https://localhost:8091/aaa`. @@ -69,7 +69,7 @@ There are 2 types of capabilities exposed in the Presentation Server. * The current latest client code is in the client folder. * The new work is being developed in the cra-client directory and may contain out of date Presentation Server source code. -## There is ongoing work to enhance the ability to easily run the new services in a demo environment +## There is ongoing work to enable easy running of the new Presentation Server and view services in a demo environment * The Coco Pharmaceuticals 'lab' tutorial environment will now configure the view services, and allow a user to experiment with the Presentation Server * The 'egeria-server-config' notebook has code added to configure the view services - so once this & egeria-server-start is run, Presentation Server is available. * The Presentation Server code is built under maven (mvn clean install) & added to a new assembly (open-metadata-distribution/open-metadata-assemblies) as part of the overall build.