Skip to main content

ImageMagick integration in Enterprise Server 10

Documentation Team
  • Updated

Integrating ImageMagick in Enterprise Server 10 is a 3-step process:

Step 1. Checking the compatibility of ImageMagick with Enterprise Server

Step 2. Installing ImageMagick

Step 3. Configuring Enterprise Server

1. Checking compatibility

For details about which version of ImageMagick is compatible with which version of Enterprise Server 10, please check the Compatibility Matrix.

2. ImageMagick installation

On Mac OS

Installation

Use one of the following methods:

  • Download and install ImageMagick for example from the following location:

https://www.imagemagick.org/script/download.php#macosx

  • Download the ImageMagick source file from the following location and then compile and install it yourself:

https://www.imagemagick.org/download/

Setting environment variables

Make the settings below in one of the following locations:

  • For the current user: ~/.profile
  • For all users: /etc/profile

PATH - Add the ImageMagick bin folder to the 'PATH' setting.

Note: The ImageMagick bin folder is where you can find 'identify', 'convert' binary executable files.

Example: export PATH="$PATH:/usr/local/bin"

MAGICK_HOME - Add the 'home directory' of ImageMagick to the 'MAGICK_HOME' setting.

Example: export MAGICK_HOME="/usr/local"

LD_LIBRARY_PATH - Add the lib folder of ImageMagick to the 'LD_LIBRARY_PATH' setting.

Note: This is identical to setting the ImageMagick bin folder, but now use 'lib' instead of 'bin'.

Example: If the ImageMagick bin folder is '/usr/local/bin', the LD_LIBRARY_PATH would be '/usr/local/lib' (do make sure that this path really exists in your system):

export LD_LIBRARY_PATH="/usr/local/lib"
On Windows

Installation

Download and install ImageMagick for example from the following location:

https://www.imagemagick.org/script/download.php#windows

Setting environment variables

The installation process will update the PATH setting. Once the installation is completed, reboot the system to use the modified PATH setting.

On Linux

Use one of the following methods:

  • Download and install ImageMagick for example from the following location:

https://www.imagemagick.org/script/download.php#unix

  • Download the ImageMagick source file from the following location and then compile and install it yourself:

https://www.imagemagick.org/download/

3. Enterprise Server configuration

Step 1. Define the path where ImageMagick is installed:

  • File: configserver.php
  • Name of option: IMAGE_MAGICK_APP_PATH
  • Values: The full path to the folder of the ImageMagick application.

Note: Use forward slashes and do NOT end with a slash.

  • Example:
  • For Linux/Mac:

define( 'IMAGE_MAGICK_APP_PATH', '/usr/local/bin' );

  • For Windows:

define( 'IMAGE_MAGICK_APP_PATH', 'C:/Program Files/ImageMagick-6.6.3-Q16' );

Step 2. Configure the preview and thumbnail quality:

  • File: configserver.php file
  • Name of option: IMAGE_MAGICK_OPTIONS
  • Possible values: Any value mentioned on the ImageMagick Help page Command Line Options.

Note: The size (-size) is set by Enterprise Server and must not be set here.

  • Default values used:
  • -colorspace Sets the colorspace of the image. See ImageMagick Help.
  • -quality Sets the compression level for the images. See ImageMagick Help.
  • -sharpen Sharpens the image. See ImageMagick Help.
  • -layers Handles multiple image as a set of image layers or animation frames. See ImageMagick Help.
  • -depth Sets the number of bits in a color sample within a pixel. See ImageMagick Help.
  • -strip Strips the image of any profiles or comments. See ImageMagick Help.
  • -density Sets the horizontal and vertical resolution of an image for rendering to devices. See ImageMagick Help.
  • Default setting: -colorspace sRGB -quality 100 -sharpen 5 -layers merge -depth 8 -strip -density
  • Example:

define ('IMAGE_MAGICK_OPTIONS', '-colorspace sRGB -quality 92 -sharpen 5 -layers merge -depth 8 -strip -density 72x72');

Document history

  • 27 February 2018: Updated the installation instructions.
  • 21 February 2018: Added section 'Checking compatibility'.
  • 9 February 2017 - Changed to ftp://ftp.nluug.nl/pub/ImageMagick URL to https://www.imagemagick.org/script/download.php.

Related articles

Comments

Do you have corrections or additional information about this article? Leave a comment!

Do you have a question about what is described in this article? Please contact support here.


0 comments

Please sign in to leave a comment.