Importing an existing model into Knowledge Model Management

If you already have an existing Semaphore installation (or a system supporting “SKOS”, see below) and you wish to copy that model into another system then you will need to export it from the existing installation and import it onto the new system.

Exporting existing models

Using the standard Knowledge Model Management importer functionality the model data can be in any of the following formats:

• SKOS - The model data can be any of the “Turtle”, “RDF/XML” or “N-Triple” file formats for SKOS models.
• Spreadsheet - The model data can also be present in a spreadsheet format (comma-separated files - “*.csv” or “*.tsv” - or Excel formats - “*.xls” and “*.xlsx”) with model information laid out in the spreadsheet in either “Hierarchy” or “Flat List” formats. Many spreadsheet data formats in these general categories are supported.

If your model is managed using an existing application then there are some considerations that need to be made in order for it to be imported into Knowledge Model Management. The preferred method is to use the “SKOS” format to import as much data as possible though if this is not practical or proves impossible a spreadsheet format (as above) can be used).

If you wish to use the SKOS export/import format then there are some aspects that should be considered:

• If using Semaphore 3 Ontology Manager and wish to export a model for use in Semaphore 5 Knowledge Model Management it is first strongly advised to upgrade to the latest version of Ontology Manager, 3.7.4 then use the “Tools”->“Export”->“SKOS” menu option which has a “Semaphore 4 Export” format that should be used.
• If using Semaphore 5 Knowledge Model Management use the “Export” option to generate a version of the model that can be imported into any version of Knowledge Model Management. Note that this will not import any of the existing model history (to see how this might be done, please see Using the KMM- Client tool to carry out administrative functions.
• If using a third party tool that generates model exports in SKOS format be aware that there are specific extensions to the format which may require your SKOS to be manually adjusted. Contact Progress for further details.

Importing a model into Knowledge Model Management

Importing a model into Knowledge Model Management consists of simply creating a new model and using the “Import” menu option to import the file. If importing a spreadsheet you will be walked through the process of mapping spreadsheet elements into Semaphore model elements.

Migrate MarkLogic triple store to a different MarkLogic server

If you are using MarkLogic as a triple store for your Semaphore installation and you simply want to move all of your models from one MarkLogic server into another then the simplest and most reliable method to do this is as follows:

1. When connected to the old MarkLogic triple store, use the “Backup Models” option from the “Tools” menu when using a user assigned the “SemaphoreSuperAdministrators” role to backup all models and configuration
2. Login to the installation server
3. Stop the Semaphore \<Version\> - Studio (kmm) Windows service
4. Ensure the new MarkLogic is configured with a new database to store the model data (as per the old instance)
5. Update the SEMAPHORE_MARKLOGIC_CONFIG Windows environment variable with the new MarkLogic instance information
6. Wipe the workspace\SemaphoreData subdirectory in the KMM data directory (<Data directory specified during installation>\kmm). The default data directory for Studio is C:\ProgramData\Smartlogic\Studio\.
7. Start the Semaphore \<Version\> - Studio (kmm) Windows service
8. After Knowledge Model Management starts use the “Restore Models” option from the “Tools” menu (again, using a user with the “SemaphoreSuperAdministrators” role assigned), ensuring you set the options to overwrite any existing models and configuration from what is in the backup.

There are other more technical options that have an element of risk. Both of these options require you to have previously copied the MarkLogic database onto the new server and stopped the “Semaphore <Version> - Studio (kmm)” Windows service:

1. Manually alter the “connector” files (those files with names \<MODELNAME\>.marklogic and \<MODELNAME\>.tch.marklogic) for every one of your models in the workspace/SemaphoreData sub-folder of your KMM data directory with the relevant MarkLogic connection information for the new MarkLogic server then restart the Semaphore \<Version\> - Studio (kmm) Windows service, OR
2. Wipe all files in the workspace\SemaphoreData subdirectory of the KMM data directory, update the value of the SEMAPHORE_MARKLOGIC_CONFIG Windows environment variable, then start the Semaphore \<Version\> - Studio (kmm) Windows service and re-create all models with the same URI as the instance they were copied from (this will have the effect of “magically finding” the model data in MarkLogic using the previous URI).