Version Migration - Revision history

Antti Villberg: /* The release process */

2011-11-03T05:19:33Z

The release process

← Older revision		Revision as of 05:19, 3 November 2011
Line 60:		Line 60:
	*# Increment the software version number of models		*# Increment the software version number of models
	* '''During modelling when ontology is first modified''' (before this the working ontology was exactly some frozen ontology)		* '''During modelling when ontology is first modified''' (before this the working ontology was exactly some frozen ontology)
	*# Increment ontology version number. (Include the corresponding frozen ontology into product dependencies to enable migration)		*# Increment ontology version number. (Include the corresponding frozen ontology into product dependencies to enable migration).

	[[Category: Ontology Development]]		[[Category: Ontology Development]]
	[[Category: Database Development]]		[[Category: Database Development]]

Antti Villberg: /* The release process */

2011-11-03T05:19:13Z

The release process

← Older revision		Revision as of 05:19, 3 November 2011
Line 59:		Line 59:
	*# For all working ontologies which do not correspond to a frozen version : freeze ontology plugin and store as a tag		*# For all working ontologies which do not correspond to a frozen version : freeze ontology plugin and store as a tag
	*# Increment the software version number of models		*# Increment the software version number of models
	* '''During modelling when ontology is first modified'''		* '''During modelling when ontology is first modified''' (before this the working ontology was exactly some frozen ontology)
	*# (before this the working ontology was exactly some frozen ontology)
	*# Increment ontology version number. (Include the corresponding frozen ontology into product dependencies to enable migration)		*# Increment ontology version number. (Include the corresponding frozen ontology into product dependencies to enable migration)

	[[Category: Ontology Development]]		[[Category: Ontology Development]]
	[[Category: Database Development]]		[[Category: Database Development]]

Antti Villberg: /* The release process */

2011-11-03T05:18:59Z

The release process

← Older revision		Revision as of 05:18, 3 November 2011
Line 59:		Line 59:
	*# For all working ontologies which do not correspond to a frozen version : freeze ontology plugin and store as a tag		*# For all working ontologies which do not correspond to a frozen version : freeze ontology plugin and store as a tag
	*# Increment the software version number of models		*# Increment the software version number of models

	* '''During modelling when ontology is first modified'''		* '''During modelling when ontology is first modified'''
	* # (before this the working ontology was exactly some frozen ontology)		*# (before this the working ontology was exactly some frozen ontology)
	* # Increment ontology version number. (Include the corresponding frozen ontology into product dependencies to enable migration)		*# Increment ontology version number. (Include the corresponding frozen ontology into product dependencies to enable migration)

	[[Category: Ontology Development]]		[[Category: Ontology Development]]
	[[Category: Database Development]]		[[Category: Database Development]]

Antti Villberg: /* The release process */

2011-11-03T05:18:01Z

The release process

← Older revision		Revision as of 05:18, 3 November 2011
Line 56:		Line 56:
	* '''Before the build'''		* '''Before the build'''
	*# Make usual tagging and branching of all released plugins in Subversion		*# Make usual tagging and branching of all released plugins in Subversion
	* '''Right after the build''		* '''Right after the build'''
	*# For all working ontologies which do not correspond to a frozen version : freeze ontology plugin and store as a tag		*# For all working ontologies which do not correspond to a frozen version : freeze ontology plugin and store as a tag
	*# Increment the software version number of models		*# Increment the software version number of models

Antti Villberg: /* The release process */

2011-11-03T05:17:53Z

The release process

← Older revision		Revision as of 05:17, 3 November 2011
Line 56:		Line 56:
	* '''Before the build'''		* '''Before the build'''
	*# Make usual tagging and branching of all released plugins in Subversion		*# Make usual tagging and branching of all released plugins in Subversion

	* '''Right after the build''		* '''Right after the build''
	*# For all working ontologies which do not correspond to a frozen version : freeze ontology plugin and store as a tag		*# For all working ontologies which do not correspond to a frozen version : freeze ontology plugin and store as a tag

Antti Villberg: /* The release process */

2011-11-03T05:17:32Z

The release process

← Older revision		Revision as of 05:17, 3 November 2011
Line 55:		Line 55:

	* '''Before the build'''		* '''Before the build'''
	*# Make ~~copies~~ of all ~~referenced ''working ontology'' bundles~~ in Subversion ~~with frozen ids.~~		*# Make usual tagging and branching of all released plugins in Subversion
	*# Change the OSGi dependencies to refer to frozen ontologies accordingly.
	* '''~~After~~ the build'''		* '''Right after the build''
	*# ~~Move back into~~ working ontologies as ~~things change. Increase the version number.~~		*# For all working ontologies which do not correspond to a frozen version : freeze ontology plugin and store as a tag
	*# Increment the software version number of models		*# Increment the software version number of models

			* '''During modelling when ontology is first modified'''
			* # (before this the working ontology was exactly some frozen ontology)
			* # Increment ontology version number. (Include the corresponding frozen ontology into product dependencies to enable migration)

	[[Category: Ontology Development]]		[[Category: Ontology Development]]
	[[Category: Database Development]]		[[Category: Database Development]]

Antti Villberg at 05:10, 3 November 2011

2011-11-03T05:10:02Z

← Older revision		Revision as of 05:10, 3 November 2011
Line 33:		Line 33:
	# All ontology versions shall be completely self-contained. All concepts are declared in all versions of an ontology.		# All ontology versions shall be completely self-contained. All concepts are declared in all versions of an ontology.
	# There shall be exactly one ontology (L0.Ontology) defined in each ontology bundle.		# There shall be exactly one ontology (L0.Ontology) defined in each ontology bundle.
	# The '''Bundle-Name''' of an ontology shall be the unversioned URI of the ontology without the '-0.0' suffix e.g. ''http://www.simantics.org/Simulation''		# The '''Bundle-Name''' of an ontology shall be the unversioned URI of the ontology without the '-0.0' suffix e.g. <nowiki>http://www.simantics.org/Simulation</nowiki>
	# The first two digits of the '''Bundle-Version''' of an ontology shall be the ontology version as specified in the ontology URI e.g. '1.2'		# The first two digits of the '''Bundle-Version''' of an ontology shall be the ontology version as specified in the ontology URI e.g. '1.2'
	# The '''Bundle-SymbolicName''' (bundle id) of a working ontology is unchanged when versions grow (e.g. org.simantics.simulation.ontology)		# The '''Bundle-SymbolicName''' (bundle id) of a working ontology is unchanged when versions grow (e.g. org.simantics.simulation.ontology)
Line 44:		Line 44:
	The database can host multiple versions of ontologies which enables old models to exist and to be imported in the database. A typical software feature can only manipulate models defined with the latest versions of some ontologies.		The database can host multiple versions of ontologies which enables old models to exist and to be imported in the database. A typical software feature can only manipulate models defined with the latest versions of some ontologies.

	Software features can make model migration from models created with previous versions of the software. Each model is ''associated in the database with a single software feature version'', which then can be used to determine the actions needed for migrating models to the latest ontological definitions.		Software features can make model migration from models created with previous versions of the software. Each model is ''associated in the database with a single software feature version'', which then can be used to determine the actions needed for migrating models to the latest ontological definitions. The version modelling is defined in '''org.simantics.softwareconfiguration.ontology'''.

	The user can browse the old and new models contained in the database and perform model migration at will.		The user can browse the old and new models contained in the database and perform model migration at will.

Antti Villberg: /* Ontology Migration */

2011-11-03T05:07:49Z

Ontology Migration

← Older revision		Revision as of 05:07, 3 November 2011
Line 24:		Line 24:
	Additionally we define		Additionally we define

	'''working ontology''' as an ontology bundle which ~~is under development~~		* '''working ontology''' as an ontology bundle which contains the '''latest''' version of the ontology e.g. ''org.simantics.simulation.ontology''
			* '''released ontology''' as an ontology bundle which is frozen, renamed and never again changed e.g. ''org.simantics.simulation.ontology-1.1''
	'''released ontology''' as an ontology bundle which is frozen and never again changed

	The following simple rules for ontology development are defined to enable version migration		The following simple rules for ontology development are defined to enable version migration
Line 33:		Line 32:

	# All ontology versions shall be completely self-contained. All concepts are declared in all versions of an ontology.		# All ontology versions shall be completely self-contained. All concepts are declared in all versions of an ontology.
	# There shall be exactly one ontology in each ontology bundle.		# There shall be exactly one ontology (L0.Ontology) defined in each ontology bundle.
	# The '''Bundle-Name''' of an ontology shall be the unversioned URI of the ontology		# The '''Bundle-Name''' of an ontology shall be the unversioned URI of the ontology without the '-0.0' suffix e.g. ''http://www.simantics.org/Simulation''
	# The '''Bundle-Version''' of an ontology shall be the ontology version as specified in the ontology URI		# The first two digits of the '''Bundle-Version''' of an ontology shall be the ontology version as specified in the ontology URI e.g. '1.2'
	# The '''Bundle-SymbolicName''' (bundle id) of a working ontology is unchanged when versions grow (e.g. org.simantics.~~layer0~~.ontology)		# The '''Bundle-SymbolicName''' (bundle id) of a working ontology is unchanged when versions grow (e.g. org.simantics.simulation.ontology)
	# The '''Bundle-SymbolicName''' (bundle id) of a frozen ontology is a version-dependent derivative of the id from the working ontology (e.g. org.simantics.~~layer0~~.ontology-1.1)		# The '''Bundle-SymbolicName''' (bundle id) of a frozen ontology is a version-dependent derivative of the id from the working ontology (e.g. org.simantics.simulation.ontology-1.1)

	==Model Migration==		==Model Migration==

Antti Villberg: /* Ontology Migration */

2011-11-03T04:59:42Z

Ontology Migration

← Older revision		Revision as of 04:59, 3 November 2011
Line 17:		Line 17:
	All shared concepts contained in the ontology are accordingly versioned along with the ontology and the version number is visible in the URI. For ontological concepts we define		All shared concepts contained in the ontology are accordingly versioned along with the ontology and the version number is visible in the URI. For ontological concepts we define

	'''versioned URI''' as the proper URI of the resource e.g. <nowiki>http://www.simantics.org/Layer0-1.0/ConsistsOf</nowiki>		* '''versioned URI''' as the proper URI of the resource e.g. <nowiki>http://www.simantics.org/Layer0-1.0/ConsistsOf</nowiki>
			* '''unversioned URI''' where version information is omitted e.g. <nowiki>http://www.simantics.org/Layer0-0.0/ConsistsOf</nowiki>
	'''unversioned URI''' where version information is omitted e.g. <nowiki>http://www.simantics.org/Layer0-0.0/ConsistsOf</nowiki>

	Ontologies are deployed as OSGi bundles. Declarations in Simantics software may use the unversioned URI to refer to concepts in the ''latest'' version on an ontology (or the version found from OSGi dependencies). An utility class for converting between '''versioned URI''' and '''unversioned URI''' is defined in class '''org.simantics.scl.reflection.OntologyVersions'''.		Ontologies are deployed as OSGi bundles. Declarations in Simantics software may use the unversioned URI to refer to concepts in the ''latest'' version on an ontology (or the version found from OSGi dependencies). An utility class for converting between '''versioned URI''' and '''unversioned URI''' is defined in class '''org.simantics.scl.reflection.OntologyVersions'''.

Antti Villberg: /* Ontology Migration */

2011-11-03T04:54:49Z

Ontology Migration

← Older revision		Revision as of 04:54, 3 November 2011
Line 21:		Line 21:
	'''unversioned URI''' where version information is omitted e.g. <nowiki>http://www.simantics.org/Layer0-0.0/ConsistsOf</nowiki>		'''unversioned URI''' where version information is omitted e.g. <nowiki>http://www.simantics.org/Layer0-0.0/ConsistsOf</nowiki>

	Ontologies are deployed as OSGi bundles. Declarations in Simantics software may use the unversioned URI to refer to concepts in the ''latest'' version on an ontology (or the version found from OSGi dependencies). We define		Ontologies are deployed as OSGi bundles. Declarations in Simantics software may use the unversioned URI to refer to concepts in the ''latest'' version on an ontology (or the version found from OSGi dependencies). An utility class for converting between '''versioned URI''' and '''unversioned URI''' is defined in class '''org.simantics.scl.reflection.OntologyVersions'''.

			Additionally we define

	'''working ontology''' as an ontology bundle which is under development		'''working ontology''' as an ontology bundle which is under development
Line 37:		Line 39:
	# The '''Bundle-SymbolicName''' (bundle id) of a working ontology is unchanged when versions grow (e.g. org.simantics.layer0.ontology)		# The '''Bundle-SymbolicName''' (bundle id) of a working ontology is unchanged when versions grow (e.g. org.simantics.layer0.ontology)
	# The '''Bundle-SymbolicName''' (bundle id) of a frozen ontology is a version-dependent derivative of the id from the working ontology (e.g. org.simantics.layer0.ontology-1.1)		# The '''Bundle-SymbolicName''' (bundle id) of a frozen ontology is a version-dependent derivative of the id from the working ontology (e.g. org.simantics.layer0.ontology-1.1)


	==Model Migration==		==Model Migration==