Store and Forward Resources

Windows

By default, program files are installed in the following location:

<Program Files>\Micro Focus\Universal Discovery\<VersionNumber>\Store and Forward

By default, data files, log files, and scan files that are in transit are stored in the following location:

<ALLUSERSPROFILE>\Application Data\Micro Focus\Universal Discovery S&F

 

In addition, the following directories are created after installation.

Subdirectory Description
bin Contains the Apache web server executable files, DLL files, and the Store and Forward server executable files
conf

Contains the configuration files, including httpd.conf (the configuration file for the Apache web server)

Note The httpd.conf file contains parameters that control bandwidth throttling

modules Contains the Apache web server modules
Logs Contains the logs for the Apache web server and the Store and Forward server
Incoming Contains incoming scan files
InProgress Contains the files that the server is processing
Status Contains status files
Resume Contains scan files that are partially uploaded

The Windows service is registered with the following parameters:

Service attribute Value
Apache Service Name ovedApacheSF
Apache Display Name Universal Discovery Store and Forward Web Server
Apache Startup Type Automatic
Store and Forward Service Name ovedStoreAndForward
Store and Forward Display Name Universal Discovery Store and Forward Server
Store and Forward Startup Type Automatic

Linux

The following directories are created in the installation folder after installation.

File name Comment
bin Contains the Apache web server executable files, DLL files, and the Store and Forward server executable files.
conf

Contains the configuration files, including httpd.conf (the configuration file for the Apache web server).

Note The httpd.conf file contains parameters that control bandwidth throttling.

data Parent data directory.
data/Logs Contains Apache web server and Store and Forward server log files.
data/Incoming Contains incoming scan files.
data/InProgress Contains the files that the server is processing.
data/Status Contains status files.
data/Resume Contains scan files that are partially uploaded.
modules Contains the Apache web server modules.

The Linux service is registered with the following parameters:

Service attribute Value
Linux Service Name StoreNForward
Apache Service Name httpd

Status Information XML File Printout

In addition to using web-based methods to access status file information, data that is contained in this file can also be accessed by external programs or scripts. The file resembles the following:

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="server_status.xsl"?>
<StoreAndForwardStatus version="1.0">
<statusDirBytes>0</statusDirBytes>
<incomingDirBytes>0</incomingDirBytes>
<inProgressDirBytes>0</inProgressDirBytes>
<resumeDirBytes>0</resumeDirBytes>
<freeDiskSpaceBytes>50882215936</freeDiskSpaceBytes>
<numIncomingFiles>0</numIncomingFiles>
<numInProgressFiles>0</numInProgressFiles>
<numResumeFiles>0</numResumeFiles>
<modifiedTime>12/22/10 08:23:30</modifiedTime>
</StoreAndForwardStatus>

Configuration File

The structure of the config.ini file is as follows.

Section Name Parameter Name Description
Log filterLevel Type default or debug. When debug is specified, detailed logging is enabled.
rotateSizeMB Specifies the size of each log file. The Store and Forward server can store the log information in several log files.
rotationFileCount Specifies the number of log files to keep. When the parameter value is reached, the oldest log file is discarded.
[BaseDirectories] dataDir Specifies the location of the data directory. Normally, it is not necessary to modify this setting because it is configured automatically by the installer.
incomingDir Specifies the location of the Incoming directory. Normally, it is not necessary to modify this setting, as it is configured automatically by the installer.
[Channels] channelX Specifies the name for each channel. Channel names are used to name the top level directory of the Store and Forward server. The corresponding physical directory is created under the Incoming directory of the Store and Forward server.
[UpstreamProviders] providerX

Specifies the URLs for upstream Store and Forward servers. The URL should include the HTTP username and password required to access the URL. When the HTTPS protocol is used, the host name of the Store and Forward server supplied in this URL must match the host name given during the installation of that Store and Forward server, as this host name is encoded in the HTTPS certificate.

When configuring a Store and Forward server that is installed together with the Data Flow Probe, use the following configuration:

This key specifies the full path to a local directory. In this case, the received file is copied to that directory, or moved if the channel is mapped to only one upstream provider. The only provider that is listed should be the incoming directory of the XML Enricher, as all files received by this Store and Forward server will be moved automatically to the Incoming directory of the XML Enricher.

[ChannelMapping] channelX Specifies how the files arriving to this channel will be forwarded. One or more upstream Store and Forward servers from the [UpstreamProviders] section should be specified. Multiple servers are separated with commas.
[StatusPage] updateFrequencyMins

Specifies how frequently (in minutes) the status page is updated.

The default is 20. If the setting is set to 0, the status page is not updated.

Sample Configuration File

The following is a sample config.ini file that has two upstream Store and Forward servers configured, two channels, and three providers:

[Log]
filterLevel=default
rotateSizeMB=10
rotationFileCount=5
[BaseDirectories]
dataDir=C:\ProgramData\Micro Focus\DDMI S&F\
incomingDir=C:\ProgramData\Micro Focus\DDMI S&F\Incoming\
[Channels]
channel0=ddmi
channel1=hpca
[UpstreamProviders]
provider0=http://ddmi:ddm1passw0rd@ForwardS&Fserver1:5005/ddmi/
provider1=http://ddmi:ddm1passw0rd@ForwardS&Fserver2:5005/hpca/
provider2=http://ddmi:ddm1passw0rd@ForwardS&Fserver3>:5005/ddmi/
[ChannelMappings]
channel0=provider0,provider2
channel1=provider1
[StatusPage]
updateFrequencyMins=20