The Metadata Server
The Metadata Server is the interface between the Metadata Analyzer component and the database/repository where the Metadata Analyzer stores collected entities. After installing DevEnterprise, the Metadata Server administrator must configure the Metadata Server before the Metadata Analyzer can be used.
The Metadata Server must be running before clients can access the repository. After verifying that the Metadata Server is running, no further action is required unless you want to change the download directory or set up additional Metadata Servers.
Verify that the Metadata Server is running
To verify that the Metadata Server is running, view the MetadataServer_portxxx.log file and look for the text Ready to accept metadata clients.
If you do not see the Ready to accept metadata clients message, see the troubleshooting topic.
Whenever the Metadata Server starts, a process verifies that the repository and the Metadata Server are at the same release level and upgrades the repository if necessary. The syntax of the release level is shown below:
Starting the Metadata Server
The Metadata Server can be started as a service (default) or from a Command Prompt.
To start the Metadata Server as a service
- From the Control Panel, double-click Administrative Tools, then Services.
- Right-click Metadata Server and select Start.
To start the Metadata Server from a Command Prompt
- Open a Command Prompt window and type the following:
runMDServer <name of .cfg file>
Stopping the Metadata Server
The Metadata Server can be stopped from the Control Panel if the Metadata Server is running as a service, or from a Command Prompt if started from a Command Prompt.
To stop the Metadata Server service from the Control Panel
- From the Control Panel, double-click Administrative Tools, then Services.
- Right-click Metadata Server and select Stop.
To stop the Metadata Server from a Command Prompt
- Find the Metadata Server that you want to stop in the associated Command Prompt window and type the following:
Ctrl+C
Changing the download directory
If you change the download directory to a directory that is remote to the machine running the Metadata Server, the Metadata Server service must be assigned a user account that has authority to read the download directory or the Learning Process will not work properly. This is because the Metadata Server runs as a service and this service must have Read access to the download directory so the Learning Process can learn COBOL and PL/I source.
Setting up and running an additional Metadata Server
You may want to set up an additional database to distribute the load, or you may choose to have separate databases for different work groups or different applications. Since each database is accessed by its own Metadata Server, you must set up an additional Metadata Server if you want to use the additional database. Each Metadata Server must have its own .CFG file that contains information about the database it accesses. Therefore, to access an additional database, you must create an additional .CFG file for it.
The Metadata Analyzer Configuration dialog box, which is used to edit configuration settings, can only edit a file named server.cfg. Therefore, copy the existing server.cfg file and rename it (for example, to server_original). Then use the Metadata Analyzer Configuration dialog box to edit the file named server.cfg to contain information about the additional database. To run each server, be sure that the correct configuration file is pointed to when specifying runMDServer.