9 Running the Oracle GoldenGate Veridata Programs

This chapter explains how to run the Oracle GoldenGate Veridata programs, such as the agents and Java components.

This chapter includes the following sections:

Section 9.1, "Starting and Stopping the C-agent and Manager"
Section 9.2, "Starting and Stopping the Java-Based Components"
Section 9.3, "Reloading Log Information"
Section 9.4, "Connecting to Oracle GoldenGate Veridata Web"

9.1 Starting and Stopping the C-agent and Manager

The C-agent starts automatically at the request of Oracle GoldenGate Veridata Server when initiating comparisons. However, for Oracle GoldenGate Veridata 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 an automatic process, you can stop the Manager process that controls the agent. Stopping Manager prevents Oracle GoldenGate Veridata 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 on all platforms

From the Oracle GoldenGate Veridata Agent installation location, run GGSCI.
In GGSCI, issue the appropriate command as follows to stop or start the Manager.
```
START MANAGER
```
Or...
```
STOP MANAGER
```

To control the C-agent Manager as a Windows service

If Manager is installed as a Windows service, it either starts at system boot time or must be started manually, depending on how the service is configured. The installation default is to start automatically at system boot time. To start the service manually, use the START MANAGER command in GGSCI or start the service in the Services control panel applet.

To change the startup behavior of the service, right click the name in the Services control panel, and then select Properties.

When Manager is installed as a Windows service, you can stop it in the Services control panel applet or with the STOP MANAGER command in GGSCI.

9.2 Starting and Stopping the Java-Based Components

The Oracle GoldenGate Veridata Server and Oracle GoldenGate Veridata Web components are Java-based programs. The Oracle GoldenGate Veridata 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.

9.2.1 Controlling the Java-Based Components from the Command Line

To control the agent component, change directories to its installation directory and issue the appropriate command as follows:

UNIX and Linux	Windows
agent.sh {start \| run} Or... agent.sh stop	agent.bat {start \| run} Or... agent.bat stop

UNIX and Linux

Windows

agent.sh {start | run}

Or...

agent.sh stop

agent.bat {start | run}

Or...

agent.bat stop

Where:

run starts the agent in the same command window from which 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 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.

To control the web component, change directories to the web/bin directory of the installation directory, and issue the appropriate command as follows:

UNIX and Linux	Windows
veridata_web.sh start Or... veridata_web.sh stop	veridata_web.bat start Or... veridata_web.bat stop

UNIX and Linux

Windows

veridata_web.sh start

Or...

veridata_web.sh stop

veridata_web.bat start

Or...

veridata_web.bat stop

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

9.2.2 Controlling the Java-Based Components as Windows Services

An Oracle GoldenGate Veridata Windows service either starts at system boot time or must be started manually, depending on how it is configured. The installation default is to start automatically at system boot time. Windows services are controlled from the Services control panel applet or the Start menu. To change the startup behavior of a service, right click the name in the Services control panel, and then select Properties.

When installed as a service, an Oracle GoldenGate Veridata Java component can be stopped from the Services control panel, from the Start menu, or from the command console.

To control the Java components from the Windows Start Menu

In the Start menu, select Programs, and then navigate to the folder that contains the Oracle GoldenGate Veridata shortcuts.
- To start the web component, select Application, then Start Veridata Web
- To stop the web component, select Application, then Stop Veridata Web.
- To start the agent component, select Application, then Start Veridata Agent
- To stop the agent component, select Application, then Stop Veridata Agent

9.3 Reloading Log Information

You can reload logging information from the log4j. properties file to a running agent. The changes in the log4j. properties file are put into effect on the agent. The agent must be running for this command to work.

Use the following command:

UNIX and Linux	Windows
agent.sh reloadlog	agent.bat reloadlog

9.4 Connecting to Oracle GoldenGate Veridata Web

You can connect to Oracle GoldenGate Veridata Web in either of the following ways.

If there is a Start menu shortcut for Oracle GoldenGate Veridata on the system where the server and web components are installed, navigate to it and select Launch Oracle GoldenGate Veridata Web.
Run a web browser on any system in your network and type the following address:
```
http://hostname:port/veridata
```
Where:

hostname is the name of the system where Oracle GoldenGate Veridata Server is installed and port is the port number where it is running (default is 8830). Use localhost as the host name if connecting on the system that is local to the server installation.

Examples:
```
http://localhost:8830/veridata
http://sysa:8830/veridata
```

The Oracle GoldenGate Veridata Web login page is displayed upon successful connection. Log in with your user name and password. For full instructions on using Oracle GoldenGate Veridata Web, see the online help.