System Requirements

 

ON THIS PAGE      Show

 

 

 

 

Configuration Dashboard

The configuration dashboard works with the Web browser versions listed below. If you do not have these versions installed, please upgrade.

  • MS Windows. The latest version of Google Chrome, Mozilla Firefox or Microsoft Internet Explorer.

  • Mac OS X. The latest version of Google Chrome, Apple Safari or Mozilla Firefox.

  • Linux. The latest version of Google Chrome or Mozilla Firefox.

 

  Important

 

To access the dashboard, you must connect to AP Newsroom using HTTPS (not HTTP).

 

 

 

AP Media Agent

Supported Platforms

A recent major Windows, Mac OS or Linux platform that supports the latest version of Java Runtime Environment (JRE).

Java Runtime Environment (JRE)

Running the agent requires a compatible Java Runtime Environment (JRE) installation on the computer where you will run the agent. There are many compatible Java versions on many operating systems, and you should choose the one that is the most appropriate for your needs. It is always recommended that you use the newest available release version of the JRE you chose and keep it up to date with the latest security patches and bug fixes. If you are unsure of which JRE to choose for your installation, you can use Oracle’s Open JDK (https://jdk.java.net/), which is free for all commercial use under the GNU General Public License. Oracle also now offers a paid licensed version with support and more frequent updates (https://www.java.com/en/). Mac OS X users can install the latest Java version via Software Update.

Administrator Rights on the Machine Running the Agent

Your account must be able to install applications and create/delete files and folders.

  • Running the agent as Administrator on a Windows system that has User Access Control (UAC). If you are running the agent on a Windows system that has UAC; for example, Windows 10 or Windows Server 2012, you must run the agent as Administrator or disable UAC. The recommended method for running as Administrator is to launch a command prompt as Administrator and then launch the agent jar file from that command prompt; for example:

    java -Xms512M -Xmx1G -jar agent.jar

  • Running the agent as root user on Linux. On Linux, if your distribution by default does not allow the root user login, you must run the agent from the Terminal as root user; for example:

sudo java -Xms512M -Xmx1G -jar agent.jar

 

  Note

 

The -Xms512M -Xmx1G parameters specify the default recommended Java heap size, which is 512 MB - 1 GB. To allocate more memory, you can increase the Java heap size by changing the maximum value; for example to 2 GB or 4 GB. The 512 MB is the minimum base value and must not be modified.

 

 

 

 

  Important

 

To run the agent as a service:

  • You must have admin privileges on Windows or root privileges on Mac or Linux.

  • The JAVA_HOME environment variable must be set (defining the path to your JAVA folder).

 

 

 

Accessible Ports and Sites

Your system must allow:

  • Access to port 443 (HTTPS) and 80 (HTTP; not required if only HTTPS is used) for api.ap.org and mapi.associatedpress.com

  • Redirects (302) from api.ap.org to mapi.associatedpress.com

  • GET, POST and PUT access to keystoneapi-prod-associatedpressproduction-us-east-1-agentlogs.s3.amazonaws.com

  • HTTPS connection to AP Newsroom for access to configuration dashboard

Checking Your Agent's Connectivity Status

To check if your agent is connected to AP Media API, specify the statusCheckOnly:true parameter when starting the agent from the command line; for example:

java -jar agent.jar statusCheckOnly:true

You will get the Agent Connectivity Scan Report that you can send to AP Customer Support for troubleshooting if necessary.