Requirements to Export Reports as PDF

    PhantomJs is a third party tool that is used for generating PDF reports in Firewall Analyzer. The phantomjs.org link suggests the following requirement to use their tool.

    For Linux

    First, install the development packages of the following tools and libraries: gcc, bison, flex, gperf, Perl, Ruby, SQLite, FreeType, Fontconfig, OpenSSL, and ICU. The actual package names may vary from one distribution to another.

    1. If PDF not generated in Linux machine then execute the following commands:

    • On Debian-based distro (tested on Ubuntu 14.04 and Debian 7.0), run:
      • sudo apt-get install build-essential g++ flex bison gperf ruby perl \
      libsqlite3-dev libfontconfig1-dev libicu-dev libfreetype6 libssl-dev \
      libpng-dev libjpeg-dev python libx11-dev libxext-dev ttf-mscorefonts-installer
    • If Debian 6.0 follow the steps in below link also:

      www.dangtrinh.com/2017/04/apt-get-update-error-in-vyos-116-debian.html

      1. Add the following line to /etc/apt/sources.list file:

        deb http://archive.debian.org/debian/ squeeze main non-free contrib

      2. Comment out all other lines & save
      3. Run "sudo apt-get update"
      4. Install the packages that I want.
    • On Fedora-based distro (tested on CentOS 6, 7.6), run:

      • sudo yum -y install gcc gcc-c++ make flex bison gperf ruby \
      openssl-devel freetype-devel fontconfig-devel libicu-devel sqlite-devel \
      libpng-devel libjpeg-devel

    2. If PDF generated with garbled characters then try the following command:

      Note: For font issues, it is also recommended to install ttf-mscorefonts-installer package.

    • For CentOS:

      • sudo yum install libXext libXrender xorg-x11-fonts-Type1 xorg-x11-fonts-75dpi
    • For Chinese:

      • sudo yum groupinstall "Chinese Support"
      sudo yum install cjkuni-ukai-fonts
    • For Japanese:

      • sudo yum groupinstall "Japanese Support"
      sudo yum install cjkuni-fonts-common cjkuni-ukai-fonts cjkuni-uming-fonts

    For Windows

    • Check if the phantomJs process is running.
    • Check Administrator privilege is given for "/OpManager/Export" folder.
    • Give Full access privilege to the user.
    • If product has been started as a service, then try the below steps:
      1. Stop the service.
      2. Right click the ManageEngine OpManager service.
      3. Go to properties → Log On.
      4. Click log on as This account and enter credential (Administrator privilege) and apply the changes done.
      5. Start the service.

    For SSL issues:

    • Open "/OpManager/Export/script/config.json" file.
    • Set, "ignoreSslErrors":true

    Other troubleshooting steps:

    • Check whether "/OpManager/Export/phantomJs/phantomjs" file is available or not. In the case of the file being unavailable, kindly contact support.
    • Connect the web GUI using <protocol>://localhost:<port> and verify if it is working fine in the installation server.
    • In Linux,
      1. If 'java.lang.RuntimeException: Error, PhantomJS could not start CUSTOM_EXPORT_SERVER_PORT=9990' error is found in logs (stderr_0.txt / phantomlog_0.txt), and Firewall Analyzer service is running in https port or SSL is enabled, then go to /OpManager/Export/phantomJs directory and try connecting phantomJS using the following command: ./phantomjs
      2. If it shows 'Auto configuration failed' error, then do the following:
        1. Open the '/etc/environment' file
        2. Add a new entry: OPENSSL_CONF="/etc/ssl/"
        3. export OPENSSL_CONF=/etc/ssl/
        4. Restart the Firewall Analyzer service.