Starting the DITA CMS for the first time in a remote solution

This document describes how to start the DITA CMS for the first time in a remote solution and perform the initial configuration. To start the DITA CMS on a user workstation, see Starting the DITA CMS for the first time on a user workstation.

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 start the DITA CMS:

  1. Double-click the DITA CMS icon.
  2. From the Eclipse menu, select Window-->Preferences.
  3. In the Preferences window, select DITA CMS.

The DITA CMS configuration panel is displayed:

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.

  1. 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.

  1. Click OK to close the Login message.
  2. Click OK to close the Preferences window.

Enter the oXygen license

If you are using the oXygen Author or Editor XML editor, you need to register your license. Contact your system administrator for more information.

Configure your workspace

  1. From the Eclipse menu, select Window-->Open Perspective-->Other...

The Open Perspective window is displayed.

  1. Select DITA and click OK.
  2. The DITA - Eclipse SDK now displays the DITA perspective.
  3. The following steps will clean up the view so that you can better see DITA CMS functionality.

  1. To close the Welcome tab, click X.
  2. 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

·  Add the root-catalog.xml catalog to the Oxygen editor (if using oXygen)

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.

3