How Do I Install A Solaris Rule Engine?


Use the Solaris installation package pkgadd and do the following:

  1. Logon to the SunOS machine as ‘root‘.
  2. If this is a fresh install, go to step 6.
  3. If an older version is installed, stop the daemon by running:

    ag_re -stop

  4. Verify the Unix Rule Engine stops by checking:

    ps -e | grep ag_re

  5. Use pkgrm to remove the existing installation. Enter:

    pkgrm ARGTre

  6. Ensure the installation path is in the environment variable PATH

    PATH=”${PATH}:/opt/Argent/UNIX”

    export PATH

    Do this in /etc/profile to ensure the PATH is correctly defined.

  7. Place the compressed package file in the root directory ‘/
  8. Change to the root directory ‘/‘. Enter:

    cd /

  9. Uncompress by running:

    uncompress ARGENT_UNIX_RULE_ENGINE_yymm_SUNOS_PKG.TAR.Z

  10. Untar the file:

    tar xf ARGENT_UNIX_RULE_ENGINE_yymm_SUNOS_PKG.TAR

  11. Use pkgadd to install the package. Enter:

    pkgadd ARGTre

    When prompted, select the ARGTre package, and enter the IP address or fully qualified domain name of the main engine.

  12. If this Unix Rule Engine only monitors itself, go to step 22.
  13. If this machine does not have OpenSSH installed, install it. The monitored Unix machines need to have OpenSSH installed as well.
  14. See Also: How Do I Set Up SSH Equivalence to configure an account that can SSH into other Unix machines without a password.
  15. Edit /opt/Argent/UNIX/ag_re.opt to specify the SSH binary path in the section “SSH bin path” if the binaries are not in the PATH.
  16. Create group ‘argentguardian‘ and add the su account to the group. For more information about creating groups, See Also: How Do I Create A Unix Group
  17. Create the logs directory in /opt/Argent/UNIX.
  18. To make all the files and directories belong to group ‘argentguardian‘, Run:

    chgrp -R argentguardian /opt/Argent

  19. Run:

    chmod 0770 /opt/Argent

    chmod -R 0770 /opt/Argent/UNIX

    chmod 0660 /opt/Argent/UNIX/ag_re.opt

  20. Each directory under /opt/Argent should also have the “group sticky-bit” set to ensure that all files created are members of the group ‘argentguardian‘. This is done using:

    find /opt/Argent -type d -exec chmod g+t {} \;

  21. During the package installation, a startup/shutdown file named ArgentRuleEngine is created in /etc/init.d.

    This file is symbolically linked to /etc/rc2.d/S09ArgentRuleEngine and /etc/rc0.d/K09ArgentRuleEngine.

    If this Unix Rule Engine will be used to monitor other systems, the file must be edited to provide the proper credentials for the su account.

    Change the line in the “start” section that reads /opt/Argent/UNIX/ag_re -start to this:

    su – USERNAME -c “/opt/Argent/UNIX/ag_re -start”

    Replace USERNAME with the su account name.

  22. Start the Unix Rule Engine:

    /etc/init.d/ArgentRuleEngine start

    If the Unix Rule Engine will only monitor itself, enter:

    ag_re -start

  23. Verify ag_re and ag_re_main start up by running:

    ps -e | grep ag_re

  24. Check the /opt/Argent/UNIX/logs/log.txt to verify the communication is successful.

If the Unix Rule Engine will be used to monitor other systems, this file must be edited prior to starting the Unix Rule Engine. See step 21 above for details.

After installing the package, the daemon service for the Unix Rule Engine is already configured to start automatically when the system boots. The package installs ArgentRuleEngine in /etc/init.d.

When the production schedule permits, reboot the machine to verify that the Unix Rule Engine starts successfully.


#!/bin/sh

#

#

# Copyright (c) 2007 ArgSoft Intellectual Property Holdings, Limited

#

# All Rights Reserved.

#

# ArgSoft Intellectual Property Holdings, Limited

# Canon's Court

# 22 Victoria Street

# Hamilton

# Bermuda HM12

#

#

# This is PROPRIETARY SOURCE CODE of ArgSoft Intellectual Property Holdings, Limited.

#

# The contents of this file may not be disclosed to third parties, copied or

# duplicated in any form, in whole or in part, without the prior written

# permission of ArgSoft Intellectual Property Holdings, Limited.

#

# RESTRICTED RIGHTS LEGEND:

# Use, duplication or disclosure by the Government is subject to restrictions

# as set forth in subdivision (c)(1)(ii) of the Rights in Technical Data

# and Computer Software clause at DFARS 252.227-7013, and/or in similar or

# successor clauses in the FAR, DOD or NASA FAR Supplement.

#

# Unpublished - rights reserved under the Copyright Laws of the United States

# and other countries.

#



PATH="$PATH:/opt/Argent/UNIX"

export PATH



case "$1" in

'start')

        if [ -f  "/opt/Argent/UNIX/ag_re" ]; then

                echo 'Argent Unix Rule Engine service starting.'

                su - USERNAME -c "/opt/Argent/UNIX/ag_re -start"

        fi

        ;;

'stop')

        if [ -f  "/opt/Argent/UNIX/ag_re" ]; then

                echo 'Argent Unix Rule Engine service stopping.'

                /opt/Argent/UNIX/ag_re -stop

        fi

        ;;

*)

        echo "Usage: $0 { start | stop }"

        exit 1

        ;;

esac