IDOL Data Admin 12.12

# Use the Zip Package

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

To install IDOL Data Admin on Ubuntu Linux

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

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

   `$ useradd dataadmin`

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

   `$ mkdir /opt/dataadmin`

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

   `$ mkdir /opt/dataadmin/home`

5. Copy the IDOL 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

   - Upstart:

         $ cp install/linux/upstart/dataadmin.conf /etc/init/
         $ chmod +x /etc/init/dataadmin.conf

   - 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

   - Upstart:

         $ sudo service dataadmin start

   - Systemd

         $ sudo systemctl start dataadmin

To install IDOL Data Admin as a Windows Service

1. Download a copy of the Windows service wrapper from https://github.com/microfocus-idol/winsw, and change the name of the `winsw.exe` executable file to `dataadmin.exe`.
2. The `install` directory in the IDOL 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 IDOL 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 IDOL 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/microfocus-idol/winsw.

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

© Copyright 2015-2022 Micro Focus or one of its affiliates
Version 12.12 | Last updated June 2022

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 swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Data Admin 12.12

Topic Title: Use the Zip Package