Only for Stand-Alone installations it makes sense to switch the data back end from FastObjects database to EOX file. Client-server installations can only operate with FastObjects database as data back end.
To switch data back end from FastObjects DBMS to EOX file several options are provided:
- Export of the current model to a EOX file and switching the data back end to the new EOX file (recommended).
- Export of the current model to a EOX file, new installation of EEC and Import of the EOX file (recommended).
- Export of the current model to a ZIP file, new installation of EEC and Import of the ZIP file.
Since the first option is the shortest way of conversion, this is described in the next steps:
- Export the current model to an EOX file.
- Adjust the initialization file.
- Restart EEC.
Follow these steps to export the current model to an EOX file:
- Select the menu File > Export....
- Select Model > EOX File Export in the wizard.
- Confirm via [Next >].
- Enter the name of the new EOX file for the model in the EOX file field.
- Select the libraries and/or projects of the model which should be exported to the new EOX file.
- Click [Finish].
- Close EEC.
The initialization file is then adjusted to let EEC use the EOX file as data back end instead of the FastObjects database:
- Open the initialization file (e.g., ec.ini) with any editor, for example Notepad.
- Change the line
-Dorg.foederal.sn.connectionURL=fastobjects://LOCAL/db
to
-Dorg.foederal.sn.connectionURL=eox:///C:/Users/Public/EPLAN/EngineeringConfiguration/<EEC-Version>/eox/model.eox?mode=rw
Please note that the path and name of the EOX file has to match to the name of the EOX file of the previous steps. The path should not contain any German umlauts, special characters or backslashes.
After the change, the initialization file may look like follows: - Save the changes.
Example of a ec.ini file with settings for FastObjects data back end:
# Hilfe zu Einstellungen von Laufzeitoptionen finden Sie in der Dokumentation
#(\readme\EC-Dokumentation.htm) im Kapitel "Administration, Laufzeitoptionen"
#
# For additional information on runtime options, please see documentation
#(\readme\EC-Dokumentation.htm) chapter "Administration
-startup
plugins/org.eclipse.equinox.launcher_1.2.0.v20110502.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.100.v20110502
-product
de.eplan.engineeringcenter.product
-data
workspace
-configuration
configuration
-vmargs
-XX:MaxPermSize=128m
-Xmx768m
-Dorg.foederal.sn.connectionURL=fastobjects://LOCAL/db
-Dcom.mind8.global.resourcePath=
-Dosgi.configuration.cascaded=false
-Dosgi.nl=de_DE
Example of an ec.ini file with settings for EOX file data back end:
# Hilfe zu Einstellungen von Laufzeitoptionen finden Sie in der Dokumentation
#(\readme\EC-Dokumentation.htm) im Kapitel "Administration, Laufzeitoptionen"
#
# For additional information on runtime options, please see documentation
#(\readme\EC-Dokumentation.htm) chapter "Administration
-data
workspace
-configuration
configuration
-vmargs
-XX:MaxPermSize=128m
-Xmx768m
-Dorg.foederal.sn.connectionURL=eox:///C:/Users/Public/EPLAN/EngineeringConfiguration/2_4_20150527_2019/eox/model.eox?mode=rw
-Dcom.mind8.global.resourcePath=
-Dosgi.configuration.cascaded=false
-Dosgi.nl=de_DE
After the change, the EEC with the EOX file data back end should be restarted.