6.2 Managing Veridata Agent

This topic describes how to manage Veridata Agent: C-agent and Java-based components. It also includes controlling logging levels and connecting to the web user interface.

This topic includes the following sections:

• Starting and Stopping the C-Agent
  
• Managing Java-Based Components
  
• Reloading Logging Information
  
• Connecting to the Oracle GoldenGate Veridata Web Interface
  

6.2.1 Starting and Stopping the C-Agent

When the Oracle GoldenGate Veridata (server) initiates comparisons, the C-agent starts automatically. However, for Oracle GoldenGate Veridata Agent (agent) to function correctly, the following must be running:

• The database to which the agent is linked.
• The Manager process for the C-agent.

Although the agent process itself is automatic, you can stop the Manager process that controls the agent. Stopping Manager prevents the server from being able to start a new agent process, but it does not stop agents that are already running.

To control the C-agent Manager:

1. From the agent installation location, run the Oracle GoldenGate software command-line interface.
2. Stop or start the Manager.

   START MANAGER
   STOP MANAGER
   

6.2.2 Managing Java-Based Components

• Starting and Stopping the Java-Based Components
  
• Managing Bequeath Agent
  

6.2.2.1 Starting and Stopping the Java-Based Components

The server and web user interface components are Java programs. The agent component is also available as a Java program for all platforms except NonStop.

Note:

Before starting the server and web processes, start the repository database.

To start and stop the Java agent component:

1. Navigate to the AGENT_DEPLOY_HOME directory.
2. Start or stop the agent.

   Operating System

   UNIX or LINUX

   agent.sh {start | run} OR agent.sh stop

   • In these commands:
   • run starts the agent in the same command window where it is launched.
   • start starts the agent in a separate command window.

   Note:

   The run option is useful for diagnosing errors that happen during the startup process before the agent error logging is configured. When the run option is used, messages written to stdout and stderr appear in the command window. The agent normally logs its messages to the log file, so only operating system messages and logging system errors are written to stderr. When the start option is used, messages written to stdout and stderr are discarded.

Configure the host to start and stop the processes automatically. Contact your system administrator if you need assistance.

6.2.2.2 Managing Bequeath Agent

Bequeath connection works only when the Oracle database and the agent are installed on the same server. You are required to set the following two environment variables before starting the agent:

export ORACLE_HOME=<path>
export LD_LIBRARY_PATH=$ORACLE_HOME/lib

For the JDBC URL details, see Oracle OCI bequeath database connection URL:

Also, copy the ojdbc11.jar file from the installed location at $ORACLE_HOME/jdbc/lib to the <Agent_Home>/drivers directory. Then, update the agent.properties file accordingly with the following entry:

server.jdbcDriver=ojdbc11.jar

6.2.3 Reloading Logging Information

You can reload logging information from the <VERIDATA_AGENT_HOME>/config/odl.xml configuration file to a running agent.

To reload logging information, start the agent and run the UNIX/Linuz reloadLog command as follows: agent.sh reloadLog

6.2.4 Connecting to the Oracle GoldenGate Veridata Web Interface

To connect to the Oracle GoldenGate Veridata Web user interface:

1. In a Web browser, enter the following address: http://hostname:port/veridata.

   In this example, hostname is the name of the system where the server is installed and port is the port number where it is running (default is 8831). Use localhost as the host name if you are connecting on the system that is local to the server installation.

2. On the Oracle GoldenGate Veridata Web login page, enter your user name and password. For full instructions on using the Oracle GoldenGate Veridata web user interface, see the online help.