Managing content ingestion

ON THIS PAGE          HideON THIS PAGE          Show Starting ingestion Viewing agent status Stopping content ingestion Restarting content ingestion Restarting ingestion when your agent is idle Restarting ingestion when your agent is off Starting ingestion from a specific point in time

Starting ingestion

Click Start Ingestion on the Manage Ingest Agent page.

 

Note
If you have set a default profile, the agent starts ingesting content automatically right away after you register it with the configuration dashboard.

See also Restarting ingestion.

Viewing agent status

The agent status is displayed in the list of Contest Ingest Agents on the dashboard and on the Manage Ingest Agent page:

 

Status: On / Ingesting
The agent is currently ingesting content.

 

Status: Idle
The agent is running, but is not ingesting content. A status of "Idle" is normal if no new content has been published to your selected entitlements. However, if your agent has stopped ingesting content, or has been idle for an extended period of time, see Restarting ingestion when your agent is idle.

 

Status: Off
The agent has not communicated with the AP Media API server for a significant amount of time, which indicates that the agent may not be running. See Restarting ingestion when your agent is off.

Stopping content ingestion

To stop ingesting from the configuration dashboard:

Click Stop Ingestion on the Manage Ingest Agent page.

To stop ingesting from the Agent Management page on the local host:

1. Access the Agent Management page on the local host; for example, localhost:8087/agent.

2. Click Stop Ingesting.

Restarting content ingestion

Restarting ingestion when your agent is idle

A status of "Idle" is normal if no new content has been published to your selected entitlements. However, if your agent has stopped ingesting content, or has been idle for an extended period of time, do one of the following to restart ingestion:

To restart ingesting from the configuration dashboard:

1. On the dashboard, click an agent name to display the Manage Ingest Agent page.

2. Make sure a profile is assigned to the agent.

3. Click Start Ingestion.

To restart ingesting from the Agent Management page on the local host:

1. Access the Agent Management page on the local host; for example, localhost:8087/agent.

2. Click Start Ingesting.

Restarting ingestion when your agent is off

If the agent process is no longer running, do one of the following to restart ingestion:

From your desktop environment:

1. Browse to the folder where you saved the agent jar file and double-click the file name.

2. Restart ingestion either from the configuration dashboard or from the Agent Management page on the local host.

From the command prompt on Windows or with sudo on Mac or Linux:

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

   cd LOCATION_OF_AGENT

2. Run the following command:

   java -Xms512M -Xmx1G -jar agent.jar

3. Restart ingestion either from the configuration dashboard or from the Agent Management page on the local host.

Starting ingestion from a specific point in time

By default, the agent begins ingesting content from the present time. If you stop content ingestion, or if it is interrupted for any reason, the agent saves the last ingestion time for each entitlement to maintain continuity, that is, to avoid any gaps and/or overlaps in content ingestion. When you restart content ingestion, the agent begins ingesting content for each entitlement from the last ingestion time. If more than three days have passed since the last ingestion time, the agent starts ingesting from the oldest content available.

In some cases, you might want to change the starting time for content ingestion; for example, if you added more entitlements or if there is not enough time to ingest all content since the last ingestion time before the newspaper's release deadline.

To change the starting time for content ingestion:

1. On the dashboard, click an agent name to display the Manage Ingest Agent page.

2. Make sure a profile is assigned to the agent.

3. Select an option from the Reset Ingestion list to specify a timeframe to reset the ingestion time for this agent, and then click the Reset Ingestion icon:

4. If the agent is currently ingesting, the ingestion will continue from the specified time. If the agent is currently not ingesting, click Save Agent, and then click Start Ingestion to start ingesting content.