Migrate CCMS Output Generator configuration for 1.x DITA-OT versions
Now that you installed the latest version of [Output_Generator], the final task is to migrate your configuration to the new version. Follow this procedure if your CCMS Output Generatoruses a DITA Open Toolkit in the DITA-OT 1.x family.
About this task
To migrate the configuration for 1.x versions:
Procedure
-
Copy the contents of the %OutputGenDir%/conf/client/ folder from your previous version to
the folder in the new version.
For example, copy the contents of the following folder:
C:\ixiasoft\OutputGenerators\Prod_[previous version]\conf\client\
to this folder:
C:\ixiasoft\OutputGenerators\Prod_[new version]\conf\client\
-
Copy the contents of the %OutputGenDir%/data/resources/client/ folder from your previous
version to the folder in the new version.
For example, copy the contents of the following folder:
C:\ixiasoft\OutputGenerators\Prod_[previous version]\data\resources\client\
to this folder:
C:\ixiasoft\OutputGenerators\Prod_[new version]\data\resources\client\
-
Copy the contents of the %OutputGenDir%/libs/client/ folder from your previous version to
the folder in the new version.
For example, copy the contents of this folder:
C:\ixiasoft\OutputGenerators\Prod_[previous version]\libs\client\
to this folder:
C:\ixiasoft\OutputGenerators\Prod_[new version]\libs\client\
- Copy all your custom transformation scenarios (e.g., conductor-acme.xml) from the %OutputGenDir%/data/ folder to the folder in the new version.
-
Copy all the *-client.xml files from the %OutputGenDir%/data/ folder to the folder in the new
version.
For example, copy the following files:
- bmanifest-extension-client.xml
- bmanifest-init-client.xml
- commontargets-client.xml
- conductor-client.xml
- outgen-init-client.xml
- Copy the outgen-init.properties file from the %OutputGenDir%/data/ folder in the previous version and paste it in the same folder in the new version.
- Copy the outgen-init-cr.properties file from the %OutputGenDir%/data/ folder in the previous version and paste it in the same folder in the new version.
-
Copy the entire DITA-OT folder from your previous version of the CCMS Output Generator and paste it in the same
location in the new version of the CCMS Output Generator.
For example, paste the copy in the %OutputGenDir%/data/DITA-OTx.x.x folder.
-
Export a copy of your company's DTD plugin from the Content Store:
-
Open the TEXTML Administration perspective by clicking the TEXTML Administration shortcut on the
tool bar. If the shortcut is not displayed, follow these steps:
- In the TEXTML Administration view, double-click the server. If your server is not displayed in the view, you must add it to the view.
- When the Connect as dialog opens, type your username and password and click OK.
- Double-click the name of your docbase to open a connection to the Content Store.
-
Expand the Content Store's Repository node and browse to /system/plugins to locate your company's
DTD plugin.
For example: com.company.dita.dtd
-
Right-click the plugin and click Export.
The plugin is saved as a folder locally as Content\system\plugins\com.company.dita.dtd where company is the name of your company.
Important: DO NOT export the com.ixiasoft.dita.dtd plugin or com.ixiasoft.dita13.dtd and use it in the CCMS Output Generator.
-
Open the TEXTML Administration perspective by clicking the TEXTML Administration shortcut on the
tool bar. If the shortcut is not displayed, follow these steps:
-
Copy the com.company.dita.dtd plugin from the location
where you exported it and paste it into your
DITA-OTx.x.x/plugins folder in the new version of the
CCMS Output Generator.
For example, the %OutputGenDir%/data/DITA-OT3.1.3/plugins folder, where 3.1.3 is your DITA-OT version.
- Depending on your DITA-OT version, do the following:
Table 1. If your DITA-OT version is Do this Lower than 1.6.2 Please contact IXIA CCMS Customer Support. In the DITA-OT 1.x family and 1.6.2 or higher - Browse to the location where you extracted the installation files for the new version of the CCMS Output Generator.
- Copy the following plugins from the DITA-OT 1.8.5 folder (for example: %OutputGenDir%/data/DITA-OT1.8.5/plugins):
- com.ixiasoft.dita.dtd
- com.ixiasoft.images
- com.ixiasoft.pdf.review
- org.oasis-open.dita.mathml.doctypes
- org.w3c.mathml3
- org.w3c.svg1.0
- org.w3c.svg1.1
- Paste them into your DITA-OT/plugins folder in the new version of the CCMS Output Generator
For example, the %OutputGenDir%/data/DITA-OTx.x.x/plugins folder.