Getting Started

 

ON THIS PAGE      Show

 

 

 

 

Video Tutorial

 Getting Started Video
Getting Started (03:12)

Quick Steps

System Requirements

Review the system requirements for the agent and configuration dashboard to check if your system is compatible or if you need to upgrade.

Sign In

  1. Go to AP Newsroom at https://newsroom.ap.org/, enter your AP Newsroom user name and password, and then click Sign In.

  2. Click at top left and choose AP Media API  from the menu to display the configuration dashboard.

Create a Content Profile

  1. On the dashboard, click Create Content Profile, and then click New Profile.

  2. On the Create Content Profile page, type the name of the profile in the Profile Name box.

  3. On the Select Content tab, select the check box next to each entitlement that you want to download. Learn more >>

  4. On the Content Options tab, select the file types and formats for downloading content; for example, you can choose to download specific video renditions or NITF-formatted stories. Learn more >>

  5. On the Content Save Options tab, you can customize the directory for saving content, folder structure, file naming format and duplicate settings. Learn more >>

 

  Tip

 

The settings that you specify on the Content Options and Content Save Options tabs are the default settings for downloading content for all entitlements. You can customize these settings for each entitlement by clicking Edit Settings on the Select Content tab. Learn more >>

 

 

 

  1. Click Save at the bottom of the page to save your profile.

Get API Key

On the dashboard, click See My API Keys (you may need to confirm your password to display your API key).

Download and Register Agent

  1. On the dashboard, click Download Agent and save the agent jar file to a folder on your machine.

      Tips

     

    • When choosing the folder for saving the jar file, consider that this folder will be your <Agent Directory> below which the agent will be saving files by default when you start ingesting content.

    • It is strongly recommended not to save content in any system folders.

    • It is not recommended to run the agent from your Desktop.

    • Renaming the agent jar file is not recommended.

    • If you are planning to run multiple agents on the same machine, each agent jar file must be in its own folder.

     

     

     

 

  1. Do one of the following to run the agent:

    • Option 1 (Command line):

      1. Open an elevated/admin command prompt on Windows or use sudo on Mac or Linux.

      2. Change to the directory where the agent jar file is located; for example, on Windows:

        cd LOCATION_OF_AGENT

      3. Run the following command to register and run your agent:

        java -Xms512M -Xmx1G -jar agent.jar key:API_KEY

    • Option 2 (Double-clicking the agent jar file):

      1. Make sure you have Oracle Java installed, and you are logged in as admin/root.

      2. From your desktop environment, browse to the folder where you saved the agent jar file and double-click the file name. The Register Agent page opens in your browser prompting you for an API key.

      3. To register your agent with the portal, enter your API key in the API Key box and click Register. If registration is successful, you will receive this message: "Success you've verified your API Key".


  Tip

 

Check your browser's Address box to determine where the Agent Management page is located on your local machine. For example, if your agent registration address is localhost:8087/register, you can manage your agent from your local machine at localhost:8087/agent.

 

 

 

  1. Click Go to Admin Portal to assign a content profile to your agent.

Assign the Profile to the Agent

  1. On the Manage Ingest Agent page, enter the agent name of your choice in the Agent Name box. The agent name allows you to identify this agent on the configuration dashboard and must be unique.

  2. Select your content profile from the Content Profile list.

  3. If you are using Monitoring and Notifications for your agent, select your monitor from the Assigned Monitor menu.

  4. Make sure that the default access mode is selected from the Access Mode list.

  5. Click Save Agent.

Start Ingesting Content

On the Manage Ingest Agent page, click Start Ingestion.