Step 1: Verify Pre-requisites for Linux Installation

System Requirements

  • We recommend installing Skedler in a separate VM or Docker container or server.
  • Linux Operating System with x86-64-bit architecture
    • Ubuntu version 12.04 and above
    • Debian version 7 and above
    • Centos version 6  and above
    • Red Hat Enterprise Linux 6 and above
  • Minimum of 2 CPU cores and 8 GB of RAM is recommended for deploying Skedler

Library Dependencies

  • GLIBCXX libraries

  1. Skedler has dependency on libstdc++ library.
    • Following are the GLIBCXX versions the code depends on
    • libstdc++.so.6 (GLIBCXX_3.4.9) => /usr/lib/x86_64-linux-gnu/libstdc++.so.6
    • libstdc++.so.6 (GLIBCXX_3.4.15) => /usr/lib/x86_64-linux-gnu/libstdc++.so.6
    • libstdc++.so.6 (GLIBCXX_3.4) => /usr/lib/x86_64-linux-gnu/libstdc++.so.6
  2. To check the versions on your server. Please run the command
    • CentOS 
      strings /usr/lib64/libstdc++.so.6 | grep GLIBCXX
    • Debian/Ubuntu
      strings /usr/lib64/libstdc++.so.6 | grep GLIBCXX 

      If the version is not available, update the GCC compiler

  • Font config libraries

Skedler requires font config library to generate report. To install the library refer the following steps:
  • Ubuntu

    sudo apt-get install libfontconfig

  • Debian 

    sudo apt-get install libfontconfig

  • Centos/Redhat

    sudo yum install fontconfig



Hostname Configuration

Skedler requires hostname of the server in which Skedler is installed to be configured in /etc/hosts. 

1.  Check hostname by giving this command: 

     $>hostname   

In reporting.yml the host parameter is the host in which skedler binds.

2.  If the host is configured as 127.0.0.1 then make sure you have an entry in /etc/hosts as mentioned below,

     127.0.0.1 localhost

     Note: If you are binding skedler to localhost you can't access it from outside.      

3. However. If the bind address is 0.0.0.0, that means skedler binds to any IP (configured for you system). In this case your entry in hosts file(/etc/hosts) should be

    <ipaddress> <hostname>

4.  If the host(IP address of server) in reporting.yml is changed other than the default value 0.0.0.0 then there should be an entry for the host in /etc.hosts like

     <ipaddress> <hostname>

 5.  Reboot the system.

       

Note: If you are using any proxy server add your hostname to a no_proxy list in the file /etc/environment add the following line,

           no_proxy="<ipaddress>,<hostname>"


Elasticssearch and Kibana version

Skedler supports Elasticsearch version from 1.7 to 5.0 and Kibana version from 4.1 to 5.0

JAVA_HOME Configuration

Skedler requires Java 7 or 8 and JAVA_HOME should be configured. Check if JAVA_HOME is configured using the following command:
> $echo JAVA_HOME 


If the result is empty, follow the below steps to configure JAVA_HOME.


  • Ubuntu/Debian in /etc/bash.bashrc and for Centos/Redhat in /etc/.bashrc ,add the JAVA_HOME variable as follows, 

    export JAVA_HOME = <your_java_path>

  • In /etc/environment file add  the line as follows: 
    JAVA_HOME = "<your_java_path>"


NOTE: Skedler user requires user home directory. To check user home directory use the following command,            > echo $HOME
Step 2: Download
  • Download the latest version of Skedler from Free Trial page.

Step 3: Extract

  • Untar the skedler.tar.gz file to the desired folder (e.g., /opt). For convenience, let us call this folder as $skedler_home.

Step 4: Configure Permissions and JAVA_HOME

  • Provide read/write permissions to the following folders, if they are configured in reporting.yml

a. Report folder configured for reports_dir parameter in reporting.yml 

                  b. UI files folder configured for the parameter ui_files_location


  • Set the value for the variable JAVA_HOME in the $skedler_home/install.sh script as follows:
    • Check JAVA_HOME using the command echo $JAVA_HOME.
    • Copy and paste the output to the install.shgq0QtGtMsPL26eihU4clHb2v0z9TsDpmnw.png
  • Save install.sh.

Step 5: Install Skedler

  • Provide the required permission to $skedler_home/install.sh script file using the command
       sudo chmod u+x install.sh
  • Install Skedler using the below command. Run install.sh as sudo user

             sudo ./install.sh


Step 6: Configure reporting.yml

  • Go to config folder using the command cd config.
  • Open reporting.yml (e.g., vi /opt/skedler/config/reporting.yml)

      ElasticSearch and Kibana  URL configuration

  • Add Elasticsearch URL with the port (even if the port is 80) and the Kibana URL with the port in the reporting.yml file in the following format <protocol>://<server>:<port>


UjokHQ7W7-G0MffXOAYKpKUOyf7J5fSTEA.png

        Proxy server basic authentication configuration

  • If you are using Nginx or SearchGuard, follow the steps below. 
    • If Kibana is configured behind Nginx, configure the Nginx username and password for Kibana in reporting.yml as shown.k7eu_10yeN7Wn4RU23RYbFjNR61iPIdKqw.png
    • If Nginx is configured as a reverse proxy for elasticsearch, configure Nginx username and password for Elasticsearch as shown:
    • 7QMiT4FB5D_sdXOGs0AKPbrhVSWWv50tOQ.png
  • Note: If you are using Shield then refer to Step-by-Step Configuration Guide for Shield.
  • Save changes to reporting.yml
For more configuration options please refer Reporting.yml and ReportEngineOptions Configuration.

Step 7: Start Skedler

You can start Skedler either as service or manually.

  • To start Skedler as a service, execute

sudo service skedler start

  • To start Skedler manually, Goto the $skedler_home directory (e.g., /opt/skedler) and execute 

bin/skedler

NOTE: If you are running skedler manually make sure that the current user running Skedler has the ownership for skedler home directory.


Step 8: Access Skedler

Skedler can be accessed from the following URL http://<yourServer>:3000.  The Email Configuration page is displayed on successful installation.


Step 9: Configure Email, Time zone and Logo

  • If you do not want your reports to be mailed, you can click Off to disable the mail settings.
  • If you want the reports to be mailed, configure the outgoing mail settings and email id (from which all the reports will be sent). If the SMTP server has authentication, select the Enable Password checkbox and enter the password in the Password field. Click Save to save the configuration details.


D6QtWtpBxFQRLxttUmYoZYPLK7yoyWBYEA.png

  • Click Time zone Settings tab to update the time zone for scheduling the report. Click Update to update the details.


4ZEFi-Bn8RRO3uvq8OK5tJGFP6q9lWJG4g.png

  • Optionally, you can upload the default logo to be used in the PDF reports in the Other Settings tab. Click Select Image to upload the logo and click Save.


Y1WdI984kLxTGg80KypKC_zm1hRpr7DP8Q.png

  • To reset the image used, click Reset.
  • To go to the Skedler Homepage, click the Home icon.


MhfkVozOVUdWNV_yLUpp9jZs79moAD1w1g.png


Step 10: Activate License Online

To activate Skedler (in Free Trial or Licensed) you must activate a valid license key.   A free license key is automatically populated in the license activation form.   If you purchase Skedler license, you will receive a license key by email.  


License keys can be activated using Online Activation or Offline Activation.  However, Free Trial license key requires Online Activation.  If your server doesn’t have internet connection, please refer to Step-by-Step Guide for Offline License Activation of Skedler.

  • To activate the license, click the About icon in Skedler Homepage.WXkVjg9L5fLbFeDfNmkiSJa3ihowVHQyUw.png
  • Click Activate License.qWM_kBnU4xOs_Kk28QISEmdWo2FyXj223w.png
  •  The License Activation page is displayed.A_QLox9NP4eaaFYlnQFJXsO2mFPAw8ee2Q.png
  • Enter the required values in the Name, Email, and Company field.ykKQcDxVKA4RHwT1GFGw4RNO0XR_tl1m3Q.png
  • By default, a trial license key is auto populated in the “License Key” field. If you received a Product license key, update the License key field.   
If the Internet connection requires a proxy server, click Proxy Setting in the License Activation page to enter the details. Specify the protocol, server name or proxy IP, and port. If the proxy setting requires user authentication, enter the username and password in the Username and Password fields.


B4jkZPERM1BhOcjsrJ3tm56j4GobuO1zKg.png

Specify the protocol, server name or proxy IP, and port. If the proxy setting requires user authentication, enter the username and password in the Username and Password fields.

  • Click Save button. The License Activation page is displayed.
  • Read and select I agree to the Terms and Conditions checkbox.
  • Click Online Activation to activate the Skedler Trial License.


E4reSxfu9FwLjoR5s9TAZHxnvimu9O4SnQ.png