/sar2html

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

SAR2HTML 3.2.1

Plotting tools, sar2html and index.php only run on Linux server. HPUX 11.11, 11.23, 11,31, Redhat 3, 4, 5, 6, 7, Suse 8, 9, 10, 11, 12, Ubuntu 18 and Solaris 5.9, 5.10, 5.11 are supported for reporting.

RUNNING THE DOCKER IMAGE

ON DOCKER

If you want your performance data to be persistent you need to create directory for them in your host:

mkdir /var/sarDATA
docker run -p 80:80 -v /tmp/data:/var/www/html/sarDATA cemtan/sar2html:v3.2.1 

Otherwise you may directly run the image:

docker run -p 80:80 cemtan/sar2html:v3.2.1 

ON KUBERNETES

  • Download repository and enter the directory
git clone https://github.com/cemtan/sar2html.git
cd sar2html/config/kubernetes
  • Deploy docker image
  • If you want your performance data to be persistent you need to create directory for them in your host:
kubectl apply -f sar2html-pvc.yaml
kubectl apply -f sar2html-deploy-persistent.yaml
  • Otherwise you may directly run the image:
kubectl apply -f sar2html-deploy-ephemeral.yaml
  • Expose your pod.
  • For local installation of kubernetes (like minikube, microk8s...):
kubectl apply -f sar2html-service-nodeport.yaml
  • For kubernetes which is able to use loadbalancer:
kubectl apply -f sar2html-service-loadbalancer.yaml

ON OPENSHIFT CONTAINER PLATFORM

Download template file of sar2html from git repository

wget https://github.com/cemtan/sar2html/blob/master/config/ocp/sar2html.yaml

On master node create template from the sar2html.yaml

oc create -f sar2html.yaml 

Now you may search for "SAR Database and Plotter" in Service Catalog and you may deploy sar2html through web-console.

CREATING THE DOCKER IMAGE

  • Download repository and enter the directory
git clone https://github.com/cemtan/sar2html.git
cd sar2html/www
  • If you are behind proxy edit 3 lines regarding proxy in bin/webserver/Dockerile
ENV http_proxy <YOUR HTTP PROXY>
ENV https_proxy <YOUR HTTPS PROXY>
RUN pear config-set http_proxy <YOUR HTTP PROXY>
  • Build the image by docker-compose and run the container
cd sar2html
docker build -t sar2html:v3.2.1 .

INSTALLATION ON PHYSICAL OR VIRTUAL MACHINE


Apache2, php5, sar, gnuplot v4.0+, libpng, gawk, grep, sed, libpng-devel v1.2.7+, coreutils, expect, php5-openssl must be installed

  • Edit php.ini file and set:
upload_max_filesize=2GB
post_max_size=80MB
./sar2html -s

or

./sar2html -c
  • Open http://<ip_address_of_your_webserver>/index.php
  • Now it is ready to work.

RECENT CHANGES

3.2.1

  • sar2html supports Ubuntu 18 now.
  • fixed some coding problems.

3.1.1

  • sar2html supports SLES 12 now.

3.0.1

  • Fixed some configuring and capturing issues (thanks to James Kenney)

3.0.0

  • New user interface is available.
  • Added navigation tab.

2.4.3

  • Added Redhat 7 support.
  • Fixed rare SA_DATE parsing issue (thanks to feistypenguin)
  • Fixed merging new and old sar data errors caused by device removal (patched by feistypenguin)
  • Fixed plotting errors caused by device removal (patched by James Kenney)

2.4.2

  • Solaris 11 is supported now.
  • Fixed HP-UX related issues.

2.4.1

  • Changed timeout settings and dependencies.

2.4.0

  • sar2html is able to connect servers to capture report now.

2.3.3

  • Error: If a server has performed a restart recently, it puts a "LINUX RESTART" entry in sar logs. When sar2ascii tries to grep out the date for a day using sar output it keys on the word "Linux". Ignoring case... so the "LINUX RESTART" entry will get globbed in with the date entry.
  • Error: Wrong argument is provided for SA_Redhat_3_b.

2.3.2

-Added bookmarks to PDF file.

2.3.1

  • Reformatted PDF file.

2.3.0

  • sar2html generates PDF formatted report now.

2.2.2

  • Fixed bug causing "Argument list too long" error while too many devices exist.
  • Added show/hide devices option to web interface. Clicking device headers hides or shows device list.

2.2.1

  • Make-up

2.2.0

  • Added delete option

2.1.2

  • Fixed bugs

2.1.1

  • Added installation note

2.1.0

  • Added Redhat 6 Support
  • Fixed issues regarding Sles 11 Hosts