Data Admin 25.4
Data Admin Administration Guide

# Install Data Admin

You install Data Admin by using the installation zip package.

NOTE: To upgrade to Data Admin 25.4 from an earlier version, you must delete your existing configuration file before you install the new version. See Upgrade Data Admin.

The zip package contains a `.jar` file, and an `install` directory that contains the individual installation files.

To install Data Admin on Ubuntu Linux

1. Ensure that all the software listed in Required Knowledge Discovery Components is installed, running, and available.

2. Create a user and group to run Data Admin as. OpenText recommends that you use `dataadmin` as both the user name and the group name:

   `$ useradd dataadmin`

3. Create a directory in which to install Data Admin. OpenText recommends that you use `/opt/dataadmin` as the installation directory.

   `$ mkdir /opt/dataadmin`

4. Create a directory to serve as the home directory for Data Admin. OpenText recommends that you use `/opt/dataadmin/home` as the home directory.

   `$ mkdir /opt/dataadmin/home`

5. Copy the Data Admin `dataadmin.jar` file into the installation directory:

   `$ cp dataadmin.jar /opt/dataadmin/`

6. Recursively change the ownership of the installation directory:

   `$ chown -R dataadmin:dataadmin /opt/dataadmin`

7. Deploy the startup script.

   - System V:

         $ cp install/linux/sysv/dataadmin.sh /etc/init.d/dataadmin
         $ chmod +x /etc/init.d/dataadmin
         $ update-rc.d dataadmin defaults 99

   - Systemd

         $ cp install/linux/systemd/dataadmin.service /etc/systemd/system/

8. If you have used any non-default paths and so on during installation, edit the startup script to contain the values that you used.

9. Start the application.

   - System V:

         $ sudo /etc/init.d/dataadmin start

   - Systemd

         $ sudo systemctl start dataadmin

To install Data Admin as a Windows Service

1. Download a copy of the Windows service wrapper from https://github.com/winsw/winsw/releases, and change the name of the `winsw.exe` executable file to `dataadmin.exe`.
2. The `install` directory in the Data Admin installation zip package includes a `Windows` folder. This folder contains a `winsw` folder, which in turn contains a `dataadmin.xml` file. Move the `dataadmin.exe` file into this folder.
3. Ensure that the Data Admin home directory and port are correctly configured in the `dataadmin.xml` configuration file. You must also ensure that `dataadmin.exe`, `dataadmin.xml`, and `dataadmin.jar` are all in the same directory.

4. Run the following command from the Windows command line to install Data Admin as a service:

   `dataadmin.exe install`

NOTE: You can also use the following commands with `dataadmin.exe`:

- `uninstall`
- `start`
- `stop`
- `status`

For more information, see https://github.com/winsw/winsw/releases.

Before you start Data Admin, follow the steps in Run Initial Data Admin Configuration, and ensure that you have set up the required user roles in Community. A user must be a member of one of these roles to log into Data Admin. See User Roles for more information.

Copyright 2015-2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Data Admin 25.4

Topic Title: Install Data Admin