Installation Guide

Brief overview

  • All the 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. The directory you choose can either be a directory or a filesystem.
  • An environment variable named 'SADMIN' containing the installation directory you have chosen, is critical for all the tools to work.
    To make sure that this environment variable is defined after a reboot, the installation process will create a script name (/etc/profile.d/sadmin.sh) and will modify the file (/etc/environment).
  • The directory '$SADMIN/bin' and $SADMIN/usr/bin will be added to your PATH to ease the use of the SADMIN tools.
  • The installation process MUST be executed by the 'root' user.
  • 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

  1. Change directory to /opt
    # cd /opt

  2. Create a filesystem or directory where you want SADMIN to be install
    # mkdir /opt/sadmin

  3. Copy the latest version of SADMIN file you have downloaded from our download page in '/opt' directory.
    # cp sadmin_xx.xx.xx.tgz /opt

  4. Change directory to '/opt/sadmin' directory
    # cd /opt/sadmin

  5. Untar the file
    # tar -xvzf ../sadmin_xx.xx.xx.tgz

  6. Run the setup program (CentOS installation example)
    # /opt/sadmin/setup/setup.sh

    • Setup program 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.

  7. You need to log out and log back in before using SADMIN Tools, or type the following command (The dot and the space are important) :
    # . /etc/profile.d/sadmin.sh
    This will make sure "SADMIN" environment variable is define.

  8. When a new release become available, you can update your system using the sadm_updater.
    Consult the procedure for running the SADMIN updater (sadm_updater.sh).
    It is really simple. Take a look at this sample screenshot.
    We have a dedicated section for the updater in our manual, take a look at it.



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 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