Introduction

Skedler v3.0.1 is now available in the Docker repository. It simplifies the installation process and shortens the time to get Skedler up and running.   


Pre-requisites

System Requirements

  • Minimum of 4 CPU cores and 8 GB of RAM is recommended for deploying Skedler.
  • Docker version greater than 1.8.0 should be installed.
  • Skedler v3.0 or higher is only supported.


Step-by-Step Instruction

Step 1: Pull Skedler from a Docker Repository

  • Obtaining Skedler for Docker is a simple as issuing a docker pull command.
  • The Docker image for Skedler 3.0 can be retrieved with the following command 

            sudo docker pull skedler/reports:latest


Step 2: Run Skedler as a Container

  • To run skedler image use the following command 

            sudo docker run --name skedler -t -d -v skedlerdata:/data -p 0.0.0.0:3001:3000 skedler/reports bin/bash

Note: skedler_home inside the container is /opt/skedler

Note: 0.0.0.0 is the bind address in which Skedler runs, 3001 is the Host IP port which Skedler uses and 3000 is the Docker IP port


Step 3: Basic Skedler configurations using reporting.yml

Configure Skedler configurations like port, kibana_index, Elasticsearch URL, Kibana URL and skedler_index in  /opt/skedler/config/reporting.yml. 

To edit the configuration file sudo docker exec -it skedler nano  /opt/skedler/config/reporting.yml

  • port - The port in which skedler runs. Default port is 3000
  • elasticsearch_url - Elasticsearch URL with the port (even if the port is 80) in the following format <protocol>://<server>:<port>

  • Kibana_url - Kibana URL with the port in the following format <protocol>://<server>:<port>

  • kibana_index - Kibana uses an index in Elasticsearch to all data. Configure Kibana index here. skedler will use this index to auto discover dashboards. Skedler will not create this index. Default kibana_index is .kibana
  • skedler_index - Skedler index which will be created in Elasticsearch. It will create a new index if it doesn't already exist. Default skedler_index is .skedler
  • Kibana_version - Skedler to identify Kibana configurations

Note: For more configuration options kindly refer the article Reporting.yml and ReportEngineOptions Configuration

Note: The following folders are persisted

  • Reports -  reports_dir: Persist generated report information in /data/reports folder.
  • Log files -  log_dir: Persist log information in /data/logs folder.
  • Custom images, images and custom CSS - ui_files_location: Persist UI information in /data/uifiles folder


Step 4: Start Skedler 

  • To run skedler as service sudo docker exec skedler service skedler start (or) 
  • To start skedler manually, 
    • >sudo docker exec skedler opt/skedler/bin/skedler


Step 5: Accessing Skedler

  • Skedler can be accessed from the following URL if it is using the port 3001. http://<hostIP>:3001
  • For example, if the HostIP: 192.168.0.101 and Docker IP: 172.17.0.1 respectively. Skedler runs in 172.17.0.1 and you can access skedler using HostIP in the browser. http://192.168.0.101:3001


Step 6: Configure Email, Timezone and Logo

When you launch Skedler for the first time, the Email Configuration page is displayed.


Email Settings


1. Set the Email Setting field to:

   • On: If you want to email distribution of reports

   • Off: if you do not want to email the reports. The reports will be generated and stored in the server reports folder.

2. By default Supported Service is set to Others.  Choose one of the following email services

  • If you use a standard SMTP server, choose Others.
    • Enter the outgoing email server in the Outgoing Server field.
    • Enter the Port for the email server
    • Check Use SSL to enable Skedler to use SSL to connect to email server. 
    • Enter the email id of the sender in the Sender’s Email ID field (this is the email id from which all the reports are sent) to configure the outgoing mail settings.
    • Select the Enable Password checkbox if the SMTP server has authentication.
    • Enter the password in the Password field.
  • If you use Gmail, choose Gmail Service
    • Enter the email id of the sender in the Sender’s Email ID field (this is the email id from which all the reports are sent) to configure the outgoing mail settings.
    • Enter the password in the Password field.
  • If you use Amazon SES, choose Amazon SES Service
    • Enter the email id of the sender in the Sender’s Email ID field (this is the email id from which all the reports are sent) to configure the outgoing mail settings
    • Enter the username in the Username field.
    • Enter the password in the Password field.

3. Enter an email address for the Admin Email field.  This is the email to which a warning message will be sent if the reports are empty.  

4. Click Save to save the configuration.


Timezone Settings

1. Enter the time zone to be used for scheduling the reports in the Time zone field.

2. Click Save to save the time zone settings for the schedule report.


Other Settings

Optionally, you can configure a default logo for the scheduled reports.  This logo will be used in the PDF reports. 

1. Click Select image from the Logo field to upload the logo. 

2. Click Save to save the uploaded image.


1. To reset the image, click Reset.


Step 7: 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 an 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.

  • Click Activate License.

  • The License Activation page is displayed.

  • Enter the required values in the Name, Email, and Company field.
  • By default, a trial license key is an 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.


You have now completed the email, timezone configuration of Skedler and ready to schedule reports.  


Next Steps