/ Installation  

See how easily you can install CARS

Hi there AppWorks fans,

Welcome to a new installment of AppWorks tips.

This guide will help you to install ‘Cordys Administration Repository Server’ (CARS/OpenLDAP) on the TomEE and PostgreSQL supported RHEL VM image. AppWorks requires a system to store information about all kinds of created objects by the system or by the user. CARS in the supported and required system to store all this information.

This post is part of the series for ‘AppWorks installation in 10 great steps’.

This is the list of ingredients we are going to use:

  • The already installed ‘Oracle Virtual Box’ software from the previous post
  • Our supported RHEL VM image from the previous posts
  • OpenText Appworks Platform (will be downloaded from OpenText support)
    • Includes the OpenText documentation
  • MobaXterm (X server and SSH client). Downloaded from: mobatek.net

Let get right into it…

First things first…That will be downloading the correct software package from the OpenText support site on your local machine. So, login to OpenText support

In the central search box, just search for #AppWorks23.4 or use this quick link! The results will show 3 types of downloads:

  1. AppWorks Suite (We go for this one as it’s the full suite. The platform incl. the OpenTextDirectoryServices, Intelligent viewing (the Brava! future), and Gateway installation files)
  2. AppWorks Platform (This is only the platform…without other relative installation files)
  3. AppWorks Containerization (It’s for the cloud…If you know me, you also know why I don’t go for this option)

From here you can download the file opentext-appworks-suite-23.4-linux.zip. Extract it to your local machine and upload it to the VM with WinSCP or MobaXTerm using the already available ‘sysadmin’ account (and just use the home folder /home/sysadmin).


Before we start the installation, we will do some pre-checks and pre-setup

Get yourself the installation PDF ‘AppWorks Platform 23.4 Installation Guide for Linux’ and open it.

  1. Make sure to meet the system requirements as mentioned in chapter 2. You should be fine on a laptop with 16Gb of memory, 8 cores CPU and 320Gb SSD.
  2. Meet the checklist on chapter 3.
    1. We have the ‘sysadmin’ user as our administrator account.
    2. The server has a Fully Qualified Domain Name like: appworks.mydomain.com. Check this with: hostname --fqdn
  3. Correct Java version is available: java -version. Should be fine if you followed the ‘Java installation…’ post on the series.
  4. Correct database version, and it’s running: sudo -u postgres psql. Should be fine if you followed the ‘PostgreSQL installation…’ post on the series.
  5. Correct TomEE version, and it’s running: ps aux | grep tomee. Should be fine if you followed the ‘TomEE installation…’ post on the series.

It’s fine to have TomEE running on port 8080. The documentation is telling you to change it to post 81, but the first 1024 ports on Linux have a reservation to the ‘root’ account.


Now let’s get ready to rumble with the installation of AppWorks…Finally! 😊

For this one we really need to make connection with MobaXterm because this tool has a build in X-server that is needed to run a GUI from an installer. You can test this by running the xterm command that will give you a small terminal app:

general_001

Make sure to send it to the correct DISPLAY variable: export DISPLAY=IP:0.0

Example: export DISPLAY=192.168.56.1:0.0

The IP can be found on top of your SSH session

general_002

Also, this can be done to enable a GUI to your X11 Server:

  • cd /etc/ssh
  • sudo vi sshd_config
  • Uncomment and update line with the <Insert>-key: X11Uselocalhost no
  • Save and close with :wq
  • Restart sshd service: systemctl restart sshd
  • Login again, and start an application xterm / xclock
  • Other notes:
    • Install xauth: sudo yum install -y xorg-x11-xauth
    • Make sure to make a new MobaX-session after this which creates the file ~/.Xauthority!
    • Check for a xauth entry: xauth list
    • Copy the Xauthority to ‘root’ to make it also work for sudo commands: sudo cp ~/.Xauthority /root/
    • I also found a command like this one helpful: sudo xauth add $(xauth -f ~/.Xauthority list|tail -1)

Now you go to your uploaded installation files: cd ~/opentext-appworks-suite-23.4-linux/OpenTextAppWorksPlatform/

Update the execution option in the .bin files:

  • chmod +x OpenText_CARS_2.8.bin
  • chmod +x OpenText_AppWorks_Platform_23.4.bin

Now you are really, really ready to start with the installation of … Now, first we install the required CARS: sudo ./OpenText_CARS_2.8.bin

install_cars_001

Hit ‘Next’

install_cars_002

Accept the license and hit ‘Next’

install_cars_003

Leave the default instance name and click ‘Next’

install_cars_004

Leave the (default) folder location, and click ‘Next’

install_cars_005

Again…Leave the basic setting and hit ‘Next’…How easy!? 😊

install_cars_006

Leave the username as is and provide it with a password for example ‘admin’. Hit ‘Next’.

install_cars_006_1

Use ‘admin’ (or your own password) as password. Hit ‘Next’.

install_cars_007

Hit the bright and shining ‘Install’ button to let the magic start doing its thing…

install_cars_008

Hit ‘Done’ to finalize and to get back to your terminal session.

To see what was done to the system check the log files:

cat /tmp/cars_custom_log.log

cat /opt/opentext/cars/defaultInst/install_log/OpenText_CARS_2.8_{DATE}.log

DATE is the date of your installation!

To see if CARS is running fine: ps aux | grep cars

1
root      4883  0.0  0.1 499372 10284 ?        Ssl  10:59   0:00 /opt/opentext/cars/defaultInst/sbin/slapd -f /opt/opentext/cars/defaultInst/sbin/slapd.conf -h ldaps://appworks.23.4.com:6366

To stop and start CARS you can use these commands:

/etc/init.d/cars-slapddefaultInst stop or systemctl stop cars-slapddefaultInst.service

/etc/init.d/cars-slapddefaultInst start or systemctl start cars-slapddefaultInst.service

The status call can be done with systemctl status cars-slapddefaultInst.service

This “status” view gives me an error sometimes:

1
2
unable to dlopen /opt/opentext/cars/defaultInst/lib/pw-sha2.so:
/opt/opentext/cars/defaultInst/lib/pw-sha2.so: undefined symbol: lutil_entropy

It doesn’t interfere the platform installation itself, and I even don’t see the error anymore after the installation for some reason!?
!!UPDATE!!
With a small tweak I managed to solve it for once and for all on my VM…It looks like a dependency with TomEE for some reason, so I just wait for 15s before CARS starts (when TomEE is up):

1
2
3
4
5
6
7
sudo vi /etc/rc.d/init.d/cars-slapddefaultInst
doStart() {
...
sleep 15s
echo -n $"Starting $Prog "
...
}

For extra logging, you need to pass extra parameters (-d -1) to the service startup: sudo vi /etc/init.d/cars-slapddefaultInst

1
OPTIONS="-f /opt/opentext/cars/defaultInst/sbin/slapd.conf -h ldaps://appworks.23.4.com:6366 -d -1"

Reload the daemon systemctl daemon-reload and restart CARS.

Monitor the debug logging with: tail -f /opt/opentext/cars/defaultInst/sbin/openldap.log


That’s a ‘DONE’ for the first step on the AppWorks installation itself. Great stuff, and you see how smooth it went. Have a nice day, and we’ll continue our journey with the series of ‘AppWorks installation in 10 great steps’. The next step in the installation of AppWorks itself.