1 System Requirements and Installation #

1.1 System Requirements
1.2 Installation

This chapter covers the following topics:

Hardware requirements for running DAPS
Installing DAPS on openSUSE and SUSE Linux Enterprise
Building and installing DAPS on other Linux* distributions

1.1 System Requirements #

DAPS itself is a lean solution that does not require a lot of system resources. However, it does use components that may need a stronger processor and more RAM, for example, for creating PDF output files. Although not required, DAPS benefits from multi-core processors.

1.1.1 Hardware Requirements #

RAM: The required amount of RAM mostly depends on the volume of your documentation projects. For creation of PDF output, at least 2 GB of RAM are recommended.
CPU: If you have multiple or very large documentation projects, a machine with multiple cores is recommended.
Hard Disk Space: The disk space consumed mostly depends on the amount of your documentation sources and the number of output formats you want to generate.

1.1.2 Software Requirements #

DAPS runs on any modern Linux system. It has not been attempted to port DAPS to Windows* or Mac OS X* yet.

When installing DAPS as an RPM package (on any SUSE-based system), dependencies on other software packages are automatically resolved during installation. No additional action is required.

1.1.3 Additional Software #

In addition to DAPS, you need the following software:

An XML (or text) editor of your choice.
For generating PDF output: an FO formatter, like FOP (http://projects.apache.org/projects/fop.html) or XEP (http://www.renderx.com). The FO formatter Antenna House Formatter (http://www.antennahouse.com) is currently not supported. Whereas FOP is an open source product, both XEP and Antenna House are commercial products.

To add further components like version management or a workflow mechanism for your projects, use DAPS in combination with the following software:

Any version management system, like CVS, Subversion, Mercurial or Git.

Together with the software components mentioned above, DAPS can be used as a fully-fledged authoring and content management system for documentation projects based on DocBook.

1.2 Installation #

The DocBook Authoring and Publishing Suite can be installed and used on any Linux distribution. Currently, DAPS is available as an RPM package for the openSUSE distribution and for SUSE Linux Enterprise products. Eventually, packages for other distributions may become available. For the latest status update and installation instructions, refer to https://github.com/openSUSE/daps/blob/main/INSTALL.adoc.

1.2.1 Installing DAPS on openSUSE #

There are a few ways to install DAPS on openSUSE. To always stay up-to-date with the latest version of DAPS install the daps package from the Documentation:Tools repository as outlined below.

You may also use the daps package that shipped with your version of openSUSE. However, you then might miss the latest features and bug fixes in DAPS.

The quickest way to install DAPS is using the zypper command.

Procedure 1.1: Installing DAPS via Zypper From Documentation:Tools #

Open a browser and enter the following URL: http://download.opensuse.org/repositories/Documentation:/Tools
Select your distribution and product number to make the browser show the URL for the respective repository.
Copy the URL from the address bar.
Open a terminal.
Add the repository with the following zypper command:
```
root # zypper ar -f URL Documentation:Tools
```
Replace URL with the URL you pasted from your browser.
Install DAPS with the following zypper command:
```
root # zypper in --from Documentation:Tools daps
```
In order to install DAPS you have to trust the Documentation:Tools repository.

1.2.2 Installing DAPS on SUSE Linux Enterprise #

Starting with SUSE Linux Enterprise 12, DAPS is also available for SUSE Linux Enterprise. The DAPS package is provided by the SUSE Software Development Kit (SDK), a free extension for SUSE Linux Enterprise. You need to install it as add-on (or extension). You can install the SDK (without any physical media) as an extension after the registration of your system at SUSE Customer Center. If you prefer to install from a physical medium, proceed as follows:

Download the installation media for the SDK from http://download.suse.com/.
Install the SDK as an add-on product to SUSE Linux Enterprise.
For details on how to install add-on products (with or without physical media), see the SUSE Linux Enterprise 12 Deployment Guide, available at http://www.suse.com/documentation/. Refer to chapter Installing Add-On Products, https://www.suse.com/documentation/sles-12/book_sle_deployment/data/cha_add-ons.html.
Install the daps package, using either the YaST Software Management module or the following command:
```
root # zypper in daps
```
Dependencies on other software packages are automatically resolved during installation.

1.2.3 Installing DAPS on Other Linux Distributions #

For the latest status update and installation instructions, refer to https://github.com/openSUSE/daps/blob/main/INSTALL.adoc.

Print this page