How to install the WiKID Strong Authentication System on Ubuntu

How-to Install WiKID Strong Authentication Server on Ubuntu Server JeOS 8.04.1

NB:We will be making changes to the RPMs to accommodate some of these changes. This document applies to versions 3.1 or earlier.

1. Install Ubuntu JeOS 8.04.1
- also: Run:

# apt-get dist-upgrade

 # apt-get install ssh

2. Install the Java SDK

# apt-get install sun-java6-jdk

# ln -s /usr/lib/jvm/java-6-sun /opt/java

3. Install prerequisites

# apt-get install postgresql-8.3 libpg-java libpg-perl libwww-perl ntp alien wget iptables

4. Download the WiKID Enterprise RPMs to /root

5. Convert the RPMs to DEBs and install them

# cd /root

 # alien -d wikid*.rpm

  # dpkg -i wikid*.deb

6. Create /sbin/service with the following contents:

#!/bin/sh

/etc/init.d/$1 $2

# ln -s /etc/init.d/postgresql-8.3 /etc/init.d/postgresql

# chmod +x /sbin/service

7. Create /sbin/runuser with the following contents:

#!/bin/sh

OPTIONS=$( getopt -o 'l:c:' -- "$@" )
eval set -- "$OPTIONS"

while true; do
        case "$1" in
                '-l')
                        USER=$2
                        shift 2
                        ;;
                '-c')
                        CMD=$2
                        shift 2
                        ;;
                '--')
                        shift
                        break
                        ;;
                *)
                        echo "Unknown parameter $1"
                        exit 1
                        ;;
        esac
done

[ -z "$USER" ] && USER=root
[ -z "$CMD" ] && (echo "Specify a command" ; exit 1)

sudo -u $USER $CMD

# chmod +x /sbin/runuser

8. Edit /opt/WiKID/sbin/postgresql_config.pl.
- Change line 31 to read:

$pgroot = '/etc/postgresql/8.3/main';

9. Edit /opt/WiKID/sbin/wikid.pl

- Change line 64: replace "postmaster" with "/usr/lib/postgresql/8.3/bin/postgres"

- Change line 1345: replace "is running" with "online"

10. Configure WiKID
- Run:

# /opt/WiKID/sbin/wikidserver_config.sh

11. Reboot

12. Run the first boot script.
- Run:

# /opt/WiKID/conf/templates/wikid-firstboot.sh

13. Run setup.
- Run:

# /opt/WiKID/bin/wikidctl setup

14. Fix /bin/sh and webapps
- Run:

# rm /bin/sh && ln -s /bin/bash /bin/sh

 cp -af /opt/WiKID/webapps/* /opt/WiKID/tomcat/webapps

15. Start WiKID
- Run:

# /opt/WiKID/bin/wikidctl start

From this point, you can follow the documents on configuring WiKID. NOTE: HTTPS may take a short period of time to start once the certificates are installed.

Special thanks to Steve McMaster at Hurricane Labs for this document!