Installation Guide

Brief overview

  • The installation process MUST be executed by the 'root' user.
  • All components of the SADMIN tools reside in one directory.
    We recommend using '/opt/sadmin', but you can install it in the directory of your choice.
  • At least 2Gb of free space is recommended for the server installation and 1Gb for the client.
  • The instructions below are assuming you have chosen to install it in '/opt/sadmin' directory.

  • Environment variable 'SADMIN' contain the installation directory path and is critical for all the tools to work.
    To make sure that this environment variable is defined after each reboot, the setup process will create or modify the file (/etc/environment).
    Also the directory '$SADMIN/bin' and $SADMIN/usr/bin will be added to your PATH to ease the use of the SADMIN tools (/etc/profile.d/sadmin.sh).

  • IMPORTANT :
    • You need to have an internet access on the system you are installing.
    • Some of the packages needed by SADMIN, may not be present on your system and will need to be downloaded.
      • On Redhat and CentOS the "EPEL repository" is activated only for the installation time.
      • On other distributions the packages needed are available in the distribution repository.

 

Easy installation steps

    Method 1: Install using the github repository (Recommended)

    • Change directory to /opt
      # cd /opt
    • Clone the SADMIN repository from GitHub
      # git clone https://github.com/jadupl2/sadmin.git
    • Run the setup program
      # /opt/sadmin/setup/setup.sh

    Method 2: Install using the downloaded 'tgz' file.

    • Copy the latest version of SADMIN file you have downloaded from our download page in '/opt' directory.
      # cp sadmin_xx.xx.xx.tgz /opt
    • Create a filesystem or directory where you want SADMIN to be install
      # mkdir /opt/sadmin
    • Change directory to '/opt/sadmin' directory
      # cd /opt/sadmin
    • Untar the file
      # tar -xvzf ../sadmin_xx.xx.xx.tgz
    • Run the setup program
      # /opt/sadmin/setup/setup.sh
  • The setup script will ask questions regarding your environment and store your answers in the SADMIN configuration file ($SADMIN/cfg/sadmin.cfg).
    This file is used by the web interface, the SADMIN libraries, the scripts you will create and add flexibility to your SADMIN environment.
    The configuration can be modified afterward if you need to.

  • The setup program can be run more than once, so don't worry if you made a mistake, just run it again.
    If there are missing packages, the setup program will install them for you.
    You will be asked what type of installation you want, a 'SADM server' or a 'SADMIN client'.

  • If you are installing a 'SADMIN server', the setup program will install and configure for you the 'Mariadb' (Database) and the Apache Web Server.
    When installation is finished you will have a working Web SADMIN environment.

    Update to the latest release

    Method 1: Use the 'git pull' command (Recommended)

    • To always get the latest version of SADMIN, use the 'git pull' command (recommended).
    •         # cd $SADMIN
              /opt/sadmin# git pull origin master
              From https://github.com/jadupl2/sadmin
              * branch            master     -> FETCH_HEAD
              Updating 1f8e79d..38034ee
              Fast-forward
              bin/sadm_uninstall.sh | 16 +++++++++-------
              1 file changed, 9 insertions(+), 7 deletions(-)
              .opt/sadmin# 
              

    Method 2: Use SADMIN updater.



    SADMIN Support

    Should you ran into problem while installing or running the SADMIN tools, please run the 'sadm_support_request.sh', attach the resulting log to an email with a description of your problem or question and sent it to support@sadmin.ca.
    We will get back to you as soon as possible.


Copyright © 2015-2019 - www.sadmin.ca - Suggestions, Questions or Report a problem at support@sadmin.ca