Requirements.

Salvora requires at least a Java 11 or 12 runtime. Due to jaxb library removal on java SE an issue has been found on jdk 13 and above.

Frequent Questions and answers.

Can the server be accessed from external computers ?

Yes, this is a small utility intended for occasional use. Write access is prevented for any other folder outside the data folder. The continuous usage in production machines is discouraged.

Can I open two instances on the same machine ?

Yes, you can configure different ports on different routes at the same time in the same machine.

Troubleshooting.

Address already bind.

This message indicates that the port number is in use. Choose a different port number or shutdown the other process and restart.

Wrong Java Version. "Class file version XX".

Salvora requires at least a Jdk 12 or newer. The following message indicates that a previous version of the Jdk is being used or configured. Review the Jdk configuration and try again.

Stack trace message:

java.lang.UnsupportedClassVersionError: net/vionta/xfserver/Salvora has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0

JAXB schema binding limitations:

The current version of the JAXB implementation has issues with the configuration file format and the way the schemas are referenced.

This schema reference will FAIL

	<?xml version="1.0" encoding="UTF-8"?>
	<salvora-application
	  xmlns="net:vionta:schemas:salvora:mapping:v1.0"
	  >
	  <collection
	    name="configuration" base-path="configuration"
	    write-allowed="false" file-list="false" >
	    <description>Configuration path</description>
	  </collection>
	  ...
	</salvora-application>
      

This schema reference WORKS

	<?xml version="1.0" encoding="UTF-8"?>
	<sal:salvora-application
	  xmlns:sal="net:vionta:schemas:salvora:mapping:v1.0"
	  >
	  <collection
	    name="configuration" base-path="configuration"
	    write-allowed="false" file-list="false" >
	    <description>Configuration path</description>
	  </collection>
	  ...
	</salvora-application>
      

We recommend you to use the supplied config xml files as templates and repport every problem you find and it does not figure on this documentation.