Troubleshooting

System Start

[Not present from version 12] When running for the first time Semantic Turkey, strange errors are logged on the console

After the first installation and run, the system might log some errors on the console. These errors are non-deterministic (they depend on non-synchronic factors, which vary from machine to machine) but are usually related to installation of bundles/web bundles. Examples are: 

Failed to install artifact: C:\TEMP\semanticturkey-6.0\deploy\vocbench3-6.0.0.war
java.lang.IllegalStateException: Unknown protocol: webbundle
	at org.apache.felix.framework.URLHandlersStreamHandlerProxy.toExternalForm(URLHandlersStreamHandlerProxy.java:482)
	at org.apache.felix.framework.URLHandlersStreamHandlerProxy.toExternalForm(URLHandlersStreamHandlerProxy.java:474)
	at java.net.URL.toExternalForm(URL.java:929)
	at java.net.URL.toString(URL.java:915)
	….

or

18:57:40.185 ERROR [fileinstall-C:\TEMP\semanticturkey-6.0/deploy] Registration exception. Skipping.
org.osgi.service.http.NamespaceException: alias: '/vocbench3' is already in use in this or another context
	at org.ops4j.pax.web.service.spi.model.ServerModel.addServletModel(ServerModel.java:124)
	at org.ops4j.pax.web.service.internal.HttpServiceStarted.registerServlet(HttpServiceStarted.java:243)
	at org.ops4j.pax.web.service.internal.HttpServiceStarted.registerResources(HttpServiceStarted.java:307)
	at org.ops4j.pax.web.service.internal.HttpServiceProxy.registerResources(HttpServiceProxy.java:76)

In that case, ignore the error, wait for the various procedures to complete and when they are finished, close the system and restart. Since the second time the system is started, they do not usually appear anymore, because the bundles have been installed and they are all available at system start.

[Not present from version 12] After stating the system, I do not see the expected VocBench page when I access its address on the browser

This may happen because the OSGi environment has not yet loaded all of the required components for providing the client application, but it is already able to reply if its address is being accessed

If you happen to see the karaf login prompt:

karaf login on slow start

it means that KARAF, the OSGi container hosting VocBench, has not yet loaded the user interface.

If you see an error dialog with the "not found" message shown in VocBench, as in figure below:

not found error on system start

the client has been loaded, but the services are not yet responding. This can happen always (depending on how fast and powerful the server is, how many projects are present, if it is the first start, if there are updates being done, etc...

If you are running VocBench locally on your machine or, in any case, can monitor the messages being logged at startup, you should look for the "ST Started" message being logged. When that message is logged, the application should be up. If it is not, there might still be some asynchronous procedures being finalized, but it should be ready soon

If you cannot access the console or logs of VB, grab a cup of coffee and come back soon ;-)

Project Creation

Q. Why after trying to create a project I get an error message such as the following?

classPanel

This happens when the user is trying to create a project connecting to a remote triple store, using the history and/or validation features, and the remote triple store does not contain the change-tracking sail component.

Please check that the change-tracking sail component has been deployed on the remote triple store, as per the instructions here.

Editing

Q.Deprecated concepts cannot be edited anymore?

By default, VB restricts to edit any deprecated concepts. In order to enable editing, The Administrator can:

  1. go to Group management page
  2. Select the desired group which will be allowed to edit deprecated concepts
  3. Select group action (TERM-EDIT)
  4. Click [+] button from the Group actions box
  5. Tick the checkbox with the ‘Deprecated' status, and click the [Add] button.

This will enable editing of deprecated terms. After editing, term’s status will be change ‘Revised' and after validation to ‘Published'.

Bugs and Issues

Q. When reconnecting to VB3, I cannot see the effects of the last changes I brought to my dataset

This happens in old versions of VB3. If your project uses a local repository backed by NativeStore, then most probably this is due to a bug in RDF4J for which NativeStore repositories might not be properly persisted if the server is closed abruptly, without closing the project holding the repository first.

As we suggest in the installation instructions, it is better for your stable projects to adopt a separate triple store, as described in the system administrator manual.

In any case, projects with local repositories using in-memory store are not affected by this issue.