APMonitor Server for Linux

The APMonitor server is installed in three steps including (1) Apache web server installation, (2) PHP installation, and (3) APMonitor server files. Below are installation instructions for Linux. Windows web server instructions are also available.

Step 1: Apache Web Server

  • Update and Install Apache on Ubuntu, Debian Linux
 sudo apt-get update
 sudo apt-get install apache2
  • Update and Install Apache on Redhat, CentOS Linux
 sudo yum update
 sudo yum install apache2

Step 2: PHP Installation and Configuration

  • Install PHP7 with Apache Module
 sudo apt-get install php7 libapache2-mod-php7.0 
  • Edit PHP7 ini file
 sudo gedit /etc/php/7.0/apache2/php.ini
  • Increase max execution time (requires sudo editing permission of php.ini)
 max_execution_time = 100000000
  • Save php.ini file and restart Apache server
 sudo apachectl restart

Step 3: APMonitor Installation

The APMonitor server is designed for large-scale optimization and accesses solvers of constrained, unconstrained, continuous, and discrete problems. Problems in linear programming, quadratic programming, integer programming, nonlinear optimization, systems of dynamic nonlinear equations, and multi-objective optimization can be solved. The platform can find optimal solutions, perform trade-off analyses, balance multiple design alternatives, and incorporate optimization methods into external modeling and analysis software. It is freely available for academic and commercial use. It is the same service available on the public servers but does not require an Internet connection.
  • Change directory to web root folder
 cd /var/www/html
  • Change directory permission for Ubuntu, Debian
 sudo chmod -R www-data:www-data /var/www/html/*
  • Change directory permission for Redhat, CentOS
 sudo chmod -R apache:apache /var/www/html/*
  • Change web root directory to be owned by Apache group:user as www-data:www-data
 sudo chown -R www-data:www-data /var/www/html/*
  • Obtain APMonitor server files
 git clone https://github.com/APMonitor/apm_server.git
  • Put the binary in the path and libraries in the library path
 cd apm_server
 sudo cp -n apm_linux/bin/apmonitor /usr/bin/apmonitor
 sudo chmod 4775 /usr/bin/apmonitor

If shared libraries are part of the install (needed only for APMonitor binaries that include IPOPT), copy the apm folder to /usr/lib/ and make the library folder discoverable with ldconfig.

 sudo mv apm_linux/lib/apm /usr/lib/
 sudo echo "/usr/lib/apm" > /etc/ld.so.conf.d/apmonitor.conf
 sudo ldconfig

The next step is to verify installation. Navigate to a web-browser and visit the following addresses. The address 'https://127.0.0.1' or 'https://localhost' should work.

The home page for the web server is now accessible at the following address:

 https://127.0.0.1

Open a web browser and type the following address to verify that PHP is working:

 https://127.0.0.1/ip.php

A number of test applications are also included in Python, MATLAB, and Julia. Point to the localhost server versus the public server for the server name.

  • Run scripts in test_* to test MATLAB, Python, or Julia with the APMonitor Optimization Suite