Components and Services¶

A MetaMiner installation has one server process, a database, a web apps process and two desktop applications; this page names each one and where it lives.

How it works¶

flowchart LR
  subgraph Workstation
    MMC[MetaMiner Client]
  end
  subgraph MetaMiner server host
    MMA[MetaMiner Administrator]
    MMS[metaminer service]
    WA[MetaMinerWebApps service]
    PG[(InfolytikPostgres service)]
  end
  MMC -->|49714| MMS
  MMA --> MMS
  MMS --> PG
  MMS -->|local only| WA
  WA --> PG

The MetaMiner Server (MMS) is the only process clients and browsers talk to. It owns the pulls, the MetaMiner Database (MMDB) schema and the Web Console relay.

Windows services¶

Service name	What it is	Started by
`metaminer`	MetaMiner Server (`server\MetaMinerServer.exe`), shown as "Infolytik MetaMiner 5.2"	Start Server in the MetaMiner Administrator, or Windows
`InfolytikPostgres`	Embedded MetaMiner Database (PostgreSQL). Created by the server on its first start when you use the embedded database.	The MetaMiner Server, when it starts. The server never stops this service.
`MetaMinerWebApps`	MetaMiner Web Apps: the Web Console back end. Accepts only local connections; browsers reach it through the MetaMiner Server.	Started together with the MetaMiner Server from the MetaMiner Administrator
`MetaMinerFSS`	Flow scheduler used only by MetaMiner for Tableau	Not used with BusinessObjects; leave it stopped

The installer never starts services

Full and update installers register the services but do not start them. Start the server from the MetaMiner Administrator after installing.

TODO: confirm the startup type of the metaminer service after a fresh install

The installer does not set it explicitly. Confirm whether it registers as Automatic or Manual and state the recommended setting.

Desktop applications¶

Application	File	Runs on	Purpose
MetaMiner Administrator (MMA)	`server\MetaMinerAdmin.exe`	The MetaMiner server host (requires Windows administrator rights)	Configure environments, database, license and settings; start and stop the server
MetaMiner Client (MMC)	`client\MetaMiner.exe`	Any workstation that can reach the server on TCP 49714	Explore, analyze and act on BusinessObjects content

Helper processes¶

The server starts these on demand; you do not manage them.

Process	Purpose
`MetaMinerQueryAgent.exe`	Runs Meta Query SQL against the MetaMiner Database outside the main server process
Lineage engine (Java child process)	Builds SQL lineage for impact analysis after BusinessObjects pulls

Installation folder¶

Default root: C:\Program Files\Infolytik\MetaMiner\

Path	Contents	Kept on upgrade
`jre\`	Bundled Java 17 runtime used by every MetaMiner process	Replaced by the full installer
`server\config\config.json`	Server configuration written by the MMA	Yes
`server\MetaMinerServer.properties`	Optional server system properties you create (template: `MetaMinerServer.properties.customize`)	Yes
`server\licenses\`	License files	Yes
`server\logs\`	`server.start.log`, `slc.log`, `server.log`, `admin.log` and others	Yes
`server\data\mmdb\`	Embedded MetaMiner Database data	Yes
`server\lib\`	Server program libraries	No - replaced by the full installer
`client\MetaMiner.ini`	Client launcher settings (memory, `-D` options)	Memory and `-D` lines are carried over
`client\lib\`	Client program libraries	No - replaced by the full installer

Client logs are written per user under %APPDATA%\metaminer\logs\.

Do not put your own files in lib folders

The full installer deletes server\lib and client\lib before it installs the new release. Anything you added there is lost.