Starting the DITA CMS for the first time
on a user workstation
This document describes how to start the DITA CMS for the first time on a user workstation and perform
the initial configuration. To start the DITA CMS in a remote solution, see Starting the DITA CMS for the
first time in a remote solution.
Specify the workspace
To start the DITA CMS and specify your workspace:
1. Double-click the DITA CMS icon on your desktop.
The following message is displayed:
1
2. Use the default as the workspace and select Use this as the default and do not ask again.
3. Click OK.
Welcome to Eclipse window
When you first start the DITA CMS, the Welcome to Eclipse window is displayed:
Note to DITA CMS administrator: If you are using an update site to deploy the DITA CMS Eclipse
Client, send the bookmarks files that you have created and ask users to import them using the
following procedure.
If you are using dropins, delete this procedure.
Remove this note when done.
Import bookmarks and install the DITA CMS
The DITA CMS software is installed as Eclipse plug-ins that are updated periodically. To install the DITA
CMS and make sure that you always get the latest version of the plug-ins, install the bookmarks files
provided by your CMS administrator, as follows:
1. From the Eclipse menu, click Help > Install New Software....
The Available Software dialog appears.
2
2. Click Available Software Sites.
3. Click Import.
4. Browse to the directory where you saved the bookmarks file.
5. Select the file and click Open.
The bookmarks are imported. If you received more than one bookmarks file, repeat this
procedure from step 3 for each file.
6. Click OK.
7. In the Work with: box, click the drop-down arrow and select --All Available Sites--:
All available sites are listed.
8. Make sure that Group items by category is checked.
3
9. Select the following sites:
Note to DITA CMS administrator: Remove from the following list the plug-ins that do not apply,
otherwise users will not be able to perform the procedure. Add any other plug-ins that must be
installed.
Some plug-ins have dependencies on other plug-ins. These required plug-ins must already be installed,
or they must be installed at the same time, otherwise installation will fail. See the DITA CMS
Installation Guide, section “Packaging and deploying the DITA CMS Eclipse Client” for more
information.
Remove this note when done.

IXIASOFT DITA CMS
 Collaborative Reviewer
 Darwin Information Typing Architecture (DITA) Version 1.2
 DITA CMS Administration
 DITA Content Management System
 HyperSTE Plugin
 Oxygen Extention (Author)
 Oxygen Extension (Editor)
 XMetaL Editor Extension
 Dynamic Release Management Feature (if available, requires special license)

TEXTML Server Administration (if available, applies to CMS administrators only)

Business Intelligence, Reporting and Charting (if available)

oXygen XML Author for Eclipse 3.4 -> 3.7, 4.2, 4.3 (if available)

oXygen XML Editor for Eclipse 3.4 -> 3.7, 4.2, 4.3 (if available)
10. Click Next.
The list of plug-ins to install is displayed.
11. Click Next.
The Review Licenses dialog appears.
12. Click I accept the terms of the license agreements and click Finish.
Software installation begins. You may get the following security warning:
4
Warning: You are installing software that contains unsigned
content. The authenticity or validity or this software cannot be
established. Do you want to continue with the installation?
This is normal behavior with Eclipse. If you get this message, click OK.
13. When installation is completed, you are asked to restart Eclipse. Click Yes.
The DITA CMS is installed.
Enter the oXygen license
Note to DITA CMS administrator: If you are using oXygen as the XML Editor, provide the procedure
for registering the oXygen license in this section, otherwise your users won’t be able to use the DITA
CMS.
Remove this note when done.
If you are using the oXygen Author or Editor XML editor, you need to register your license. Contact your
system administrator for more information.
Connect to the DITA CMS servers
The first time that you open DITA CMS, or if you are working in a new workspace, you must enter your
access information. If you are unable to log in, contact your CMS administrator.
Note: Depending on your confirmation, once the information is validated, you may be logged in
automatically whenever you open DITA CMS from your workstation. If the CMS administrator
has disabled auto-login, you will need to connect to the servers every time that you log in.
To connect to the DITA CMS servers:
1. From the Eclipse menu, select Window-->Preferences.
2. In the Preferences window, select DITA CMS.
The DITA CMS configuration panel is displayed:
5
Enter the following information:

Domain, Username, Password: Enter your system domain name, username, and
password. By default, your username and password for DITA CMS are the same as your
system username and password.
 TEXTML Server Connection:
o Hostname: Enter Click here to enter text.
o Port: Keep the default value (2500).
o Document base: Enter Click here to enter text.
 Output Generator:
o Hostname: Enter Click here to enter text.
o Port: Keep the default value (1500).
o Monitor Port: Enter 0.
3. Click Apply.
Note: You need to click Apply to connect to the TEXTML Server. If you click OK without
clicking Apply, you are not connected to the TEXTML Server.
The DITA CMS tries to connect to the TEXTML Server. When it has connected successfully, the
following message is displayed:
Login was done successfully.
4. Click OK to close the Login message.
5. Click OK to close the Preferences window.
Configure your workspace
1. From the Eclipse menu, select Window-->Open Perspective-->Other...
6
The Open Perspective window is displayed.
2. Select DITA and click OK.
3. The DITA - Eclipse SDK now displays the DITA perspective.
4. The following steps will clean up the view so that you can better see DITA CMS functionality.
a. To close the Welcome tab, click X.
b. To close the Java perspective, right-click the word Java and select Close.
To configure a DITA CMS workstation so that you are automatically alerted when updates are available:
1. Select Window > Preferences and expand Install/Update.
2. Select Automatic Updates.
3. Select Automatically find new updates and notify me.
4. Click OK.
You might also want to perform the following tasks, available from the DITA CMS documentation:

Associate file extensions with applications
7

Add the root-catalog.xml catalog to the Oxygen editor (if using oXygen)
Note to DITA CMS administrator:
Add any additional configuration that you want your users to perform.
Remove this note when done.
For more information, see the DITA CMS Documentation.
DITA CMS Documentation
The DITA CMS Eclipse Client includes the following documentation:

DITA CMS User Guide: Describes how to use the DITA CMS.

DITA 1.2 Specification: Provides the specification for DITA 1.2
To access these documents:
1. From the Eclipse menu, select Help-->Help contents.
The Eclipse Help is displayed.
2. Expand the document that you want to read. You can also use the Search box to search the
whole Eclipse documentation, including the DITA CMS documentation.
8