Hi Keith,

Thank you for sending the detailed logs, they have helped us identify a bug when using on Windows for which we have developed a fix. We're just progressing through testing and packing so hope to have this out tomorrow.

Thanks

Neil

Hi Keith, We've done a bunch of testing here with repositories with many special characters in multiple languages to see if we can replicate this but so far everything seems to be as expected. Is it possible this is just a typo problem? The Viewer WAR file should be called " essential_viewer_61...

Hi Keith,

Can I ask if you've tried a restart of Tomcat to fix this?

Cheers

Neil

This sounds like either Tomcat isn't running or the Viewer web app can't be found. Does the name of the Viewer web app match the URL? For example, if your web app is called essential_viewer then the URL in Protege would be http://localhost/essential_viewer however if your web app is called essential...

Hi Keith, Essential Viewer makes an external call to check if there are any updates to Essential. It looks like from the trace that Viewer couldn't make that call. If you're working in an offline situation then you can edit the common/core_footer.xsl file to disable this feature. Comment out the fol...

Hi Tshitshi,

It should be the top of the list. Perhaps you have a browser cache problem?

See screenshot attached.

Maybe try a private browsing tab?

Cheers

Neil

Hi Tshitshi,

We have replied to your original post regarding this here....

https://www.enterprise-architecture.org ... =21&t=2426

Cheers

Neil

Hi Tshitshi, We have identified the issue which you are experiencing and have just released two updates which should resolve this for you. The updates are for the meta-model and the import utility. You will need to apply both updates to fix the issue. The release notes can be found here https://www....

Hi Tshitshi,

We have a fix for that in the next release. I've attached the file here which goes in the "common" folder.

Thanks for bringing this to our attention.

Cheers

Neil

Making a contribution You can submit any contributions directly on this forum as a ZIP file attachment or for the more technically inclined, on GitHub by branching and issuing a pull-request. https://github.com/essentialproject/essential-contributions. Don't forget to include some form of readme.tx...

Hi John, Thanks for sharing your repository. That helped identify the issue. In a previous upgrade of Essential we replaced an older version of the Application Reference Model with a newer version (the older version can be found by editing the URL to show application/core_al_app_ref_model_v1.xsl). A...

Hi John, The ext folder should not be there in open-source. That's a bug but not one which would cause this issue. Would you be willing to share a copy of your repository to allow us to diagnose the problem? If so, you may wish to sanitise any especially sensitive information before doing so. We wil...

Hi John,

The footer of the penultimate screenshot suggests that you're still on 6.10.1. Has the v6.10.2 not deployed correctly for you or perhaps you need to changes the URL?

Cheers

Neil

Thanks for these. Can I ask you to look in the browser console and let me know if there are any errors shown.

In Chrome you can get to the console by clicking on the Menu icon > More tools > Developer tools.
In Edge you can click F12

Thanks

Neil

Can you post a screenshot of the error

Hi John,
Pretty sure you’ll find that fixed in 6.10.2
Cheers,
Neil

Hi John, Thanks for raising this. This is a bug and we have just pushed a point release for Viewer (v6.10.2) which address this as well as some minor issues for handling special characters in Views. You can either download the latest version or if you'd rather just address the log issue in the versi...

Hi,

It's possible that you have an problem WAR file. I do recall a packaging issue with the 6.9 release at some point which we resolved.

Can I suggest you try downloading again from the website?
https://www.enterprise-architecture.org/os_download.php

Neil

Hi, We would strongly recommend using the WAR file from the website which is packaged to use as a web app. The GitHub download is a ZIP which must be unzipped and repackaged to use in Tomcat so we wouldn't recommend that unless you know what you're doing there. I'd recommend downloaded the 6.9 WAR f...

Hi, Thanks for the feedback. We really welcome the input but have no immediate plans to implement this specifically given the wide variance of SAML solutions (ADFS, Okta, Ping, etc) our customers currently use. We will keep this under review and let you know if we have anything more to share in this...

Hi Tshitshi, We've been unable to reproduce the errors you've listed which suggests there is something particular about your data that is causing these issues. Would it be ok if my colleague Jason Powell contacted you directly to discuss these so we are able to identify the root cause of the problem...

Hi Keith, The log file you will need to look at is called catalina.out (or catalina.somedate.log). Can you take a look in there and let us know if you see any errors there. One minor thing to consider is that the Viewer download is called essential_viewer_692.war which will deploy as an application ...

Hi Tshitshi,

Apologies, there was a typo in the link for the meta-model download. This is fixed now.

Cheers

Neil

Hi Francois, We're working on a proper solution to address this however in the interim, you could try the following. Install Protege 3.5 with built in java https://essential-cdn.s3.eu-west-2.amazonaws.com/protege/install_protege_3.5-Win64-JVM.exe During the install process, Protege will ask you to c...

Hi,

Can you send an email to [email protected] and we'll raise a ticket to investigate this further.

Just reference the URL
posting.php?mode=reply&f=23&t=2334

Thanks

Neil

Hi, It looks like you have an error in your dates which is causing the problem You have set the extended support date (2025) after the end of life (2022). This is an invalid pattern and the view is filtering this out. You don't have to fill in all the dates but they should follow in sequence BETA > ...

Hi Rajaraman, I can see from the screenshot you shared with us the View is called "abc/core_bl_bus_cap_list_as_table_" - is that correct? That means it's some kind of custom view? When we have slower views, we do seek out opportunities to optimise the queries to help the perform more quick...

Hi Rajaraman, Thanks for the detailed numbers, can you let me know which specific Business Capability view you're looking at as we have a few different ones. My first thought is that 4000+ business capabilities sounds like quite a lot. We typically see several hundred capabilities and then lower lev...

Great stuff. Thanks for the contribution. We'll roll this into the next release.

Hi, Sorry to hear you are having trouble getting this set up. You mentioned you are using Essential 6.2b. We have moved to a more component based install as we believe this will be more transparent for our users. The latest versions for all components can be found here https://www.enterprise-archite...

That’s great to hear
Thanks for letting us know

Thanks for posting back. I suspect the issue may be related to the version of Java you are running. Java 13 was only released about 8 weeks ago and we haven’t tested against that version. Java 8 is the current recommended version and has long term support from Oracle. It is a mainstream version whic...

Hi Tim, The application name used in the browser (e.g. essential_viewer in http://localhost:8080/ essential_viewer[/b]) is based on the name of the WAR file itself. If you download the latest 6.7 WAR file from our site on this page https://www.enterprise-architecture.org/os_download.php you will see...

Hi,

You need to apply an update pack

https://enterprise-architecture.org/downloads.php and select Update Packs

These allow you update the meta-model to the latest version. Do take care to apply them in the correct order.

Thanks

Neil

Hi,

700000000 is too small. That's 700mb. We'd suggest a value of 2048000000 (2GB)

Thanks

Neil

The error shows you’ve run out of memory whilst opening the project or applying the update. Protege will need at least 1.5 GB or ideally 2 GB or more to run correctly. You can find out more about setting the correct memory values for Essential here… https://www.enterprise-architecture.org/docs/essen...

Thanks. Really appreciate you bringing this to our attention.

Cheers

Neil

All, I've attached an updated core_footer.xsl file which disables the version check feature. We'll look to handle this better in a future release. If you prefer to makes the changes manually you can make the following updates to the core_footer.xsl file yourself. Comment out the following lines Line...

I can answer this but unfortunately I’m away from my machine for a couple of days. I’ll try and post ASAP.

On a wider note, we’ll review the implementation of this feature to minimise impact in a future release.

I’ll update soon

Neil

Hi, The mostly like cause of this will be the outbound callback from Essential Viewer to the version update checker service. Viewer makes a call to see if there is a later version available and displays a notification in the footer of the Viewer application. You can disable this by commenting out or...

Hi David, We have done some work to improve the install guide and improve the downloads for open source users. The GitHub downloads by default can't just be renamed from ZIP to WAR as they wrap the content in a folder. This is a likely cause of the issue you are experiencing. You can now however dow...

Hi Alex, Apologies for the delay, this was somewhat of a mystery for us. What we think is happening is that you are all connecting your local Protege installs directly to the database rather than connecting to Protege Server (which in turn connects to the DB backend). This has the effect of everyone...

Hi Tshitshi, We've release version 6.7 today which has lots of improvements around the handling of JSON in views as well as many other features and updates. I can't guarantee it will fix all your issues but it should provide an improved experience. https://www.enterprise-architecture.org/os_download...

Hi,

Meta model 6.6 is available however 6.6 Viewer is not yet ready.

Cheers,

Neil

Hi Alex,

That's not a scenario we've heard of before.

Can you provide some technical details on your install. Specifically, the version of all the components you''re using and which DB you're using as a backend.

Thanks

Neil

Hi Tshitshi,

The code Jonathan shared here has an extra line which will only work with a forthcoming release. I've removed the problem lines and reattached zip here.

Let us know how you get one with these

Cheers

Neil

We haven't done any testing yet with Java 11 and we are already aware of issues with Java 9. We're hopping to address this in the next month or two.

In the meantime, you can install Java 8 alongside Java 11 if you need to have 11 installed but Java 8 remains our recommended version at the moment.

Hi,

You need to rename the file from .install to .jar

Cheers

Neil

Hi,

It looks like the Essential Widgets haven't been installed. You'll need to download and run the Essential Installer and ensure Widgets and Tabs are selected from the list of available items.

Cheers

Neil

I'm still not sure I fully understand where you're going with this but this will probably work for most summary views. You can then click on the icons to show the content for the various sections. <script> $(document).ready(function(){ $('.content-section').hide(); $('.content-section:first').show()...

Hi Tshitshi,

That's a rather unusual request. What is it you are ultimately trying to achieve?

Let me know and I'll see if we can find a way to help

Cheers

Neil

Unfortunately, the Protege team dropped support for the Frames-based ontologies that Essential uses in version 4+ which includes WebProtege. Protege 3.5 will be used in the Essential open-source platform for the foreseeable future. I don't think there's any technical limitation with regards to using...

Duplicate post
Answered here viewtopic.php?f=21&t=2126

Hi,

It looks like you're currently running Java 7 and you'll need Java 8 to run the Import Utility hence the Maj/Min version error being thrown.

Cheers

Neil

Thanks Jean-Marie, I'll feed your comments here back to the team

Cheers

Neil

Hi, Just to follow up on John's comment. Matomo (formerly Piwik) is a robust analytics package you can install either on the same machine as Viewer or one within the same network. Matomo isn't too hard to set up though like all analytics software, it does require a database. Once you have your analy...

This would certainly be on our review list for Viewer 7.0. Is there any specific use-case or motivation from your perspective to moving to XSL 3.0?

Better to post in the forum. For now at least, the Github repo is intended to be a read-only archive of our open-source Viewer releases though we may evolve this over time.

If you have anything you'd like to share them feel free to post on here

Cheers

Neil

Great stuff. Nice way to end the week

Hi, Have you upgrade the Viewer application fully from 6.2 > 6.4? The EUP upgrade file only updates the meta-model but not the actual Viewer application. If not, then that's probably the best place to start. You can find the 6.4 release on our Github account https://github.com/essentialproject/essen...

Hi Julian,

So if I understand correctly, you can print from our demo site ok using the same browser and OS but not from your local version?

Are there any errors in the Browser console?

Open using F12 or Control+Shift+I

Neil

Hi Julian,

I just tested PDFing this view on our demo site https://essentialviewer.com/demo and it worked fine for me there.

Which version of Essential you running?
Which OS / Browser?
What are you using to generate the PDF?

Let me know and I'll look into it

Thanks

Neil

Hi, You can submit any contributions directly on this forum as attachments. If your view has additional dependencies, e.g. 3rd party libraries, please provide links to the appropriate sites so they can be reviewed and downloaded separately. This allows any users to download and explore your submissi...

Hi Julian, For Essential Open Source, the description box should support basic line breaks and is what we would recommend although the description boxes also support basic HTML formatting. This should be applied with great care however as even minor typos can cause the entire viewer to fail and tryi...

Hi Richard, I've done some digging here and there are two issues at play. The first is that the feature John described earlier does indeed show a link but the feature which renders the image inline is not yet rolled out and will be available in the next release, early in 2019. Once you come to use t...

Hi Keith, Have you installed Graphviz as mentioned in the installation guide? See installation pre-requisites here... https://www.enterprise-architecture.org/downloads/ Some older views such as this use a library called PlantUML which depends on Graphviz. We're in the process of updating these views...

Duplicate post. See here viewtopic.php?f=21&t=2014

Hi Brett, All the views are indeed possible but we don't provide explicit Views out of the box for these specific requirements. Some of the information you're looking for can be found in other views. For example, in an Actor Summary, you would see the roles and skills for that specific actor. Howeve...

Hi Brett, In Protege, go to File > Export to Format > HTML There are a bunch of options for customising the layout and what's exported too. We tend to make sure we've selected EA Class, EA Relation and EA Graph Relation in addition to :THING in the Root Classes box. We also check all on the Slots an...

Hi Will, Apologies for the delay, did you manage to resolve this already? If not, here's a couple of things that will help to move this forward. Which version of Tomcat are you using? We recommend Tomcat 8.5. The current version of the Import Utility hasn't been tested with v9 yet. We have a new ver...

Hi Rajaraman, The Data Management pack views are designed to extend an existing Viewer application rather than function as a standalone application. Maybe if you could describe your motivation/requirements in a bit more detail, we could advise on the best approach but let me give you a few things to...

Quick follow up... Here are a couple of links to other forums posts which have explored the same or similar type issue. https://enterprise-architecture.org/forums/viewtopic.php?f=21&t=1959 https://enterprise-architecture.org/forums/viewtopic.php?f=21&t=1951 If you are still having issues the...

Hi Robert,

Can post some details of your setup?

Which versions of
Protege
Java
Tomcat
MySQL

Thanks

Neil

Just a quick note to say we've moved this project to a new account on GitHub. It's now at

https://github.com/essentialproject/essential_viewer

Apologies for any inconvenience

Neil

Hi Karen, Thanks for spotting this bug. We've just done a fix on this and it will make it into the next release. If you want to manually update your own Viewer it's pretty easy to do. Open the files core_bl_bus_cap_model.xsl and core_bl_bus_cap_2_change_footprint.xsl . Both of these are located in t...

Thanks for your work on this. We're hoping to get an "official" Docker at some point but it's not made it's way to the top of our list yet. This might be a good way for some users to take a look at Essential in a non-production setting.

Cheers

Neil

Running in headless mode can always be challenging so it's great to hear you've finally got it working.

Cheers

Neil

Hi Rick,

This is a memory allocation issue. Take a read of this blog article which will give you guidelines for allocation memory to the various components

https://www.enterprise-architecture.org ... essential/

Cheers

Neil

Hi Julian, You certainly don't require a separate physical machine for the database. You can quite comfortably run the multi-user stack on a single laptop. You'll need plenty of RAM in the machine but most modern computers have 8GB+. We'd recommend running MySQL as the database as it's the most stra...

Hi, We've created a blog post which tackles many of the memory setting for setting up Essential. This includes a section on memory settings for Protege (or lack thereof) which I imagine is the likely cause of the issue. Take a look and let me know if this resolves the issue for you https://www.enter...

Hi Tudor, We have some things in the pipeline to support this and I'll definitely add your feedback to the feature requests list. In addition to the understanding which Viewer you're looking at we think know which repository you've published might be useful too. For example, you've published the &qu...

Hi, You should try to avoid editing the PONT file directly as this could have unintended consequences for the integrity of the meta-model. If you need to change the meta-model for any reason we recommend that you extend the meta-model via the Protege UI (enable the classes and slots tabs via Project...

Hi Jason, There haven't been any changes to the security model in the Open Source version of Essential and my previous post below describes the current capabilities well. It's just read, read/write and admin at a repository level (not an entity level). There are unlikely to be any significant change...

Thanks, I've logged this for investigation

Our Meta-Model documentation will likely contain the information you're looking for

https://www.enterprise-architecture.org ... meta-model

Thanks

Neil

Hi, In the example shown, we would model the parent object as a Capability and we typically model multiple layers of Business Capability until we reach a lowest level Business process. In practice, this results in a more robust model and lends itself to the definition of a multi level Business Capab...

Hi,

This sounds like it could be a bug in the latest release.

We'll investigate and report back

Thanks

Neil

Hi David, Your "Technology Applications" are what we call "Technology Products". A Technology Product can be defined as a commercially available Technology product that an organisation can buy in order to provide Technology Components. We have some OOTB views to what you're looki...

Hi, In the install guide at... https://www.enterprise-architecture.org/documentation/doc-installation/148-installer-multi-user ... you need to copy the appropriate JDBC driver file for your chosen database to the Protege install location and rename the driver file to driver0.jar The actual location ...

I've just check this and on the flow diagram the role is populated by the slot "business_process_owned_by_business_role".

Cheers

Neil

Hi,

Have you enabled the "Collaboration Panel" from the Collaboration menu at the top of the screen?

There's also a Collaboration User Guide here and some configuration options. Have you had a look at these?

Cheers

Neil

Hi, To date, we haven't created any views for Activities as most users have used Processes and sub-Processes to model. I'll feed this back to the team and discuss options for extending support to Business Activities in the Viewer. Given the inherited nature of the Process / Activity relationship thi...

Hi,

It shouldn't

It's for internal use by Essential Cloud, our new hosted subscription version of Essential. This is in the open source release because we're committed to keeping the meta-models aligned.

Cheers

Neil

Hi Martin, 1.) between the slot "Performed by Organisations" and "Business Process Performed By Business Role" I understand the confusion here and perhaps we could have labeled these slots slightly better. Business Process Performed By Business Role - this slot looks for a logica...

Hi, Graphviz is used to support the PlantUML library which provides UML style rendering for some views, most notably the business process model. We have recently become aware ourselves that a vulnerability has been identified with Graphviz in version 2.34 and have updated the website to recommend ve...

Hi Tshitshi, Thanks for spotting this. It's a small bug in the view that's easy to fix. The view is in the "business" folder of the Essential Viewer webapp and is called core_bl_bus_obj_summary.xsl. To fix this you can change line 28 from <xsl:variable name="linkClasses" select=&...

Hi Keith, We discovered a similar issue very shortly after release. We've just released a minor update which addresses this and some other issues with Viewer. You can find it on the downloads page http://www.enterprise-architecture.org/downloads/ The release notes for this release can be found here ...

Essential Version 6 is the latest release from EAS of the world’s most popular open-source EA toolset. It is available to download for new users and as an upgrade for existing users. It is a truly major release and represents thousands of hours of effort, more than a quarter of a million lines of co...

Hi Keith, Just a quick follow up to say we're planning to release a new version of Essential in the next few days and this will contain an updated version of the Business Process Model which is a lot more tolerant of different modelling approaches. Perhaps you can post back if you get the chance to ...

Hi Keith, Can you check you have a folder called "uml" under the graph_images folder in the Viewer web app. If you haven't, then create the folder and try to access the diagram once again. The error relating to the "D:\tomcat\webapps\essential_viewer\language\.xml" line can be sa...