Table of Contents


Overview

Introduction

FileCatalyst Central is a management tool that allows FileCatalyst “nodes” to securely connect for remote monitoring and administration. It can also trigger alarms based on changes in “nodes” status. With this package, the administrator may:

  • View the status of nodes using the web-based console
  • Remotely control and administer connected FileCatalyst nodes
  • Configure alerts to be sent using SNMP and/or email.

The package includes files needed to run the application, as well as the MIBs to be used by both SNMP v1 traps and v2c notifications.

The web-based console includes the ability to view ongoing transfers in real time, see the overall health of your system, and dig into transfer history and statistics. Administrators with full privileges may configure the monitoring console service and view or make changes to connected nodes.

Deployment Diagram

FileCatalyst Central Diagram

The above illustration shows how connections are configured for a full monitoring and management scenario:

  1. FileCatalyst Central is deployed to a location reached through firewall and NAT:
    • The web interface is exposed via HTTP (port 8080 by default)
    • Administrative activities (node status, alarms, and remote management) are exchanged over TCP (port 12500 by default)
  2. Web browsers allow the administrator to view and administer the system. There is typically no need on the administrator's end to configure the required connections:
    • The FileCatalyst Central web interface is served over the HTTP port.
    • Remote administration of connected nodes is passed through Central's interface or (in the case of applets) passively over Central's TCP port.
  3. FileCatalyst Servers are available for file transfer through firewall and NAT:
    • TCP and UDP for the control connection (port 21 by default)
    • UDP for the data port range (8000–8999 by default)
  4. FileCatalyst Servers have the additional ability to report status, alarms, and other information to the console. Usually, no special configuration is needed on the server side to form this passive connection.
  5. FileCatalyst Clients typically requires no network configuration to form passive connections to the Server (for transfers), nor to the console (for reporting status, alarms, and other information).

Note: It's strongly recommeded to create either a sub domain or to purchase a dedicated domain for Central. The IP used by Central, will have to be configured on all the remote nodes including Server, HotFolder and TransferAgent. Using an IP instead of a domain name will make moving Central to a new ISP or a cloud service impossible without a manual change of the IP on all the remote nodes.

Installing FileCatalyst Central

Note: FileCatalyst Central may be deployed on the same machine as any other FileCatalyst application, but work most effectively when installed on a separate machine to independently monitor the health of all other FileCatalyst nodes.

Verify Java Version

FileCatalyst products require Java 1.8 or higher to function. Open a command prompt/terminal and type:

java –version

which will give you the version number of your Java installation.

If Java is present and sufficient, you are ready to begin installation. Otherwise, download and install Java from Java.com. Only Oracle products (HotSpot) are officially supported. OpenJDK or GNU Java are not supported.

Stop Service From Running

When upgrading, you may already have a FileCatalyst Central service running. You must stop this service before proceeding.

Windows

  1. Download the FileCatalyst Central installer (install_fc_central.exe) to your desktop
  2. Launch installer:
    • Vista and forward: you should right-click the icon and select “Run as Administrator”. You will also need to trust the installer application.
    • 2000/XP: double-click icon to launch installer
  3. Step through the wizard to choose installation directory and shortcut options
  4. At end of wizard, click “Finish”
  5. The application will automatically install as a service and start running. Changes to the configuration file (if required – see guide below) come into effect only by stopping and restarting the service.
  6. Note: FileCatalyst Central runs on Internet Explorer/Edge only from IE10 forward.

Linux, Solaris, AIX, Unix

  1. Create directory at /opt/utechsoft/central
  2. Download tarball (fc_central.tar.gz) to this directory
  3. Use GUI-based archive tool to unpack the tarball, or open a terminal and enter with the following commands:
    > cd /opt/utechsoft/central
    > gunzip fc_central.tar.gz
    > tar –xvf fc_central.tar
  4. Make a backup of the file maconfig.conf, naming it maconfig.bak or another easily identifiable name.
  5. Open README and continue following the instructions in order to complete installation
  6. FileCatalyst Central should be installed as a service. Instructions on how to accomplish this can be found in the ./service_wrapper/SERVICE_WRAPPER_README file.
  7. If you are upgrading from FileCatalyst Monitoring Agent, you can preserve your records and settings by copying the .fcdb directory and the maconfig.conf file from the Monitoring Agent directory to the Central directory before starting FileCatalyst Central.

Mac OSX

  1. Copy the Mac OSX installer (FileCatalystCentral.pkg) to your desktop.
  2. Double-click the installer to install the software.
  3. If you wish to run stand alone, double-click the application icon launch the monitoring console. A small window will appear, presenting the user with the option to stop the server:
    FileCatalyst Central Running Window
  4. If you wish to run as a service, go to the System Preferences and use the FileCatalyst Central panel there.

Upgrading FileCatalyst Central

Windows

  • Download the latest installer (contact your account representative for details)
  • Stop the FileCatalyst Central service (either from Services manager or from the shortcut found in Start menu or install path)
  • Run the installer to install "in place" of the existing FileCatalyst Central

MacOSX

  • Download the latest installer (contact your account representative for details)
  • Stop the FileCatalyst Central service
  • Run the installer to install "in place" of the existing FileCatalyst Central

Linux

If you are running FileCatalyst Central as standalone (e.g. running fc_central_start.sh or fc_central_stop.sh script), you need to first shut FileCatalyst Central down before executing an upgrade. The following commands can be used to shut the service down and verify that the processes are not running.

  • Execute the command:
    fc_central_stop.sh
  • Verify the service is down by running the command:
    ps -ef | egrep –i "filecatalystcentral"

If you are running the FileCatalyst Central as a service, you need to shut it down using the following command:

  • service fc_central stop

 

  1.     Backup configuration files

The following files & directories should be copied into an "upgrade" folder BEFORE overwriting with new files:

cd /opt/utechsoft/central/
mkdir ./upgrade 
cp maconfig.conf ./upgrade
cp -Rp .fcdb ./upgrade
cp -Rp www/Web\ Console/images/MapBackground ./upgrade

If you are upgrading a FileCatalyst Central that is version 3.7 or below, and are performing the upgrade into a different location than the original install, also run the following commands:

mkdir -p ./upgrade/images
find ./www/Web\ Console/images -maxdepth 1 -type f -exec cp {} ./upgrade/images \;

 

  1.     Unpack the software

cd /opt/utechsoft/central
gunzip fc_central.tar.gz
tar –xvf fc_central.tar

 

  1.     Copy the files overwritten by tar bundle

cp ./upgrade/maconfig.conf ./
cp -Rp ./upgrade/images ./www/Web\ Console
cp -Rp ./upgrade/MapBackground ./www/Web\ Console/images

".fcdb/" directory should not be overwritten by tar bundle.

 

  1.     Restart the FileCatalyst Central application (either as a service or standalone)

Uninstalling FileCatalyst Central

Windows

  • Click on 'Start', search for services.msc, and then run that application
  • Find the FileCatlyst Central service and stop it
  • Open ‘Control Panel’, navigate to ‘Programs and Features’ and locate FileCatalyst Central. Click 'uninstall’ and check the box 'Force deletion...' when prompted

MacOSX

  • Quit the application and stop the FileCatalyst service by using 'System Preferences' located under the Apple menu.  Locate FileCatalyst Central and stop the service.
  • To uninstall the service, open ‘System Preferences’, find the FileCatalyst Central service module, right-click on it and click 'remove from pane'
  • From the ‘Finder’ window, click on ‘Applications’, find  FileCatalystCentral.app, right-click on it and delete it
  • Use ‘Finder’ to access the Library folder, open ‘Application Support’ and delete the FileCatalyst folder (path e.g. /Library/Application Support/FileCatalyst)

Linux

Note: You may need admin access to perform some of these commands

  • If you are running the FileCatalyst Central stand-alone, shut the instance down:
    • Open a new Terminal window
    • Navigate to the install path (e.g. /opt/utechsoft/central/)
    • Execute the command ./fc_central_stop.sh
  • If you are running the FileCatalyst Central as a service, the service must be stopped and removed:
    • Execute the appropriate command for your version of Linux in the terminal window (e.g. in Ubuntu the command is service fc_central stop)
    • Navigate to the service_wrapper folder located within the central install path (e.g. /opt/utechsoft/central/service_wrapper)
    • Uninstall the service by running ./uninstall.sh
  • Verify the product is no longer running by executing the command ps -ef | egrep -i "filecatalyst"
  • Remove the folder structure by executing rm -rf <path to the Central install directory>
    (e.g. rm -rf /opt/utechsoft/central)

Preparing FileCatalyst Deployment for Monitoring

After installation, you must perform an initial web-based configuration to put the console UI online and make dispatchers available. Eligible FileCatalyst client nodes must then be configured to make them visible to the console.

Configure FileCatalyst Central

Apply a License Key

  1. Start the FileCatalyst Central service if it is not already started
  2. Using a web browser, navigate to the IP of the console, using port 8080 (http://127.0.0.1:8080)
  3. Copy the request string from the page that appears and send it to your FileCatalyst representative, who will provide a key in return.
  4. Enter the license key into the text field and click “Update License”

Update Password

  1. After the license key is applied, you may log in with the defaults:
    • Username: admin
    • Password: admin
  2. Select “Configuration” from the tools menu, then configure and update passwords. You may optionally update the corresponding usernames:
    • update the Remote Connections Configuration password (“12345” after initial installation)
    • Set a new Web Administration Configuration admin password “admin” after initial installation)
    • set the Web Administration Configuration read-only admin password (“user” after initial installation);)

Select Listener IP

This is the IP remote administrators will use to connect to the console to request remote administration applets and other resources. It is typically the public IPv4 address.

  1. Go to “Configuration” page
  2. In the Remote Connections Configuration, select a Listener IP

Note: It's strongly recommeded to create either a sub domain or to purchase a dedicated domain for Central Monitoring. The IP used here, will have to be configured on all the remote nodes including Server, HotFolder and TransferAgent. Using an IP will make moving Central to a new ISP or a cloud service impossible without a manual change of the IP on all the remote nodes.

Further Configuration Options

While setting license and password, you were on FileCatalyst Central's Configuration page. Most options are available through this page, which will be discussed in greater detail in the FileCatalyst Central Interface section.

While most options are available in this web interface, be aware that certain options such as the HTTP Port number for the web application, are available only by modifying the configuration file directly. Please see the FileCatalyst Central Configuration File section for more details.

Configure FileCatalyst Server

Monitoring is disabled by default. To allow the FileCatalyst Server to report to and be managed by FileCatalyst Central:

Server Alarms Screenshot
  1. Click “Central Mgt” in the main menu at the left
  2. Check “Enable remote monitoring…” checkbox
  3. Set the address and port of FileCatalyst Central
  4. Enter username and password set during configuration
  5. You may also select the IP and Alias (an easy-to-recognize name of your own choosing) which FileCatalyst Central will use to contact and identify this Direct Server
  6. Click “Apply”

Configure FileCatalyst HotFolder

A HotFolder will not be able to share its status and admin privileges with FileCatalyst Central until it has been enabled:

HotFolder Alarms Screenshot
  1. Click “Central Mgt” in the main menu at the left
  2. Check “Enable remote monitoring…” box
  3. Set the address and port of FileCatalyst Central
  4. Enter username and password set during FileCatalyst Central configuration
  5. You may also select the IP and Alias (an easy-to-recognize name of your own choosing) which FileCatalyst Central will use to contact and identify this HotFolder
  6. Set which transfer events trigger a notification (note that “Success” is a valid notification as well; on a high-volume deployment you may not wish to notify for all successful transfers.
  7. Click “Apply”

Configure FileCatalyst TransferAgent

FileCatalyst TransferAgent can be connected to an instance of FileCatalyst Central. To allow TransferAgent to share statistics with and be controlled by FileCatalyst Central, please set Enable remote monitoring option (FileCatalyst TransferAgent configuration page, "Central Mgt" tab) to "true".

With "Enable remote monitoring" set to true, a number of other fields configure the connection to Central:

Enable remote monitoring

Enable and disable the connection between FileCatalyst TransferAgent and one instance of FileCatalyst Central. Enabling this option will also recommended installing FileCatalyst TransferAgent as a system service (See FileCatalyst TransferAgent Documentation for more details).

Address

The address (IP or hostname) of FileCatalyst Central.

Port

The port at which FileCatalyst Central is found.

User

The username needed to log into FileCatalyst Central and register TransferAgent for monitoring.

Password

The password needed to log into FileCatalyst Central and register TransferAgent for monitoring.

Alias

A name of your (or your administrator's) choosing, which will allow FileCatalyst Central administrators to easily identify your TransferAgent.

TransferAgent hostname

The hostname of this instance of the FileCatalyst TransferAgent. Will often be the same as its IP.

TransferAgent IP

The IP of this instance of the FileCatalyst TransferAgent. Will often also be used as the hostname.

Notify on transfer success

Send a notification to FileCatalyst Central upon each transfer success.

Notify on transfer success

Send a notification to FileCatalyst Central upon each transfer failure.

Notify on transfer success

Send a notification to FileCatalyst Central upon each cancelled transfer.

FileCatalyst Central Interface: Conventions

This section of the guide will walk through each available view of the application, describing the information and functionality exposed in each view.

FileCatalyst Central Home Screenshot

Overview

  1. The admin sub-menu allows you to access the following:
    1. Documentation (this document)
    2. Configuration (FileCatalyst Central configuration). Click here for details
    3. View Logs (FileCatalyst Central logs)
    4. About Us (About FileCatalyst and FileCatalyst Central). Click here for details
    5. Sign Out (Log out of the application)
  2. Views with continuously updated data may be manually “paused” for inspection. Note: this pauses the continuous nature of the updates, but filtering and sorting will retrieve new up-to-the-moment data for the table or chart in question.
  3. Columns available for sorting show arrow widgets
  4. Search box allows the user to quickly isolate only the data they wish to view. Note: some columns of certain tables are not currently searchable with the text filter; for example, "Severity". For these columns, the ascending/descending order control on the column header is the best way to filter results.
  5. Node types are identified with the following icons:
    •  FileCatalyst Server
    •  FileCatalyst HotFolder
    •  FileCatalyst Cental Agent
    •  FileCatalyst TransferAgent
    •  Unknown or 3rd-party FTP Client
  6. Administrators with full rights may click FileCatalyst Server, FileCatalyst TransferAgent or HotFolder node names (in any pane) to view futher details and configuration options for that node.
  7. The tables and graphs are wrapped in sortable panels. Depending on your resolution, the panels can be sorted into areas that fit their size. That means panels on the left side cannot be moved to the right side. Also, the new sort is not permanent; after reloading the page, the panels will return to their original positions. Currently, only Internet Explorer does not support this feature.
  8. Tables are also resizable vertically. The tables will return to the original size once the page is refreshed.

About FileCatalyst and FileCatalyst Central

It is a pop-up menu that will display itself in the current rendered page, see image below.

FileCatalyst Central About Pop-up

The About FileCatalyst pop-up contains information about installation environment and version, as well as three buttons:

This button opens a new page displaying the FileCatalyst Central logs.

Diagnostic Report

The Diagnostic Report button collects state, logs, and configuration information about your application that will be useful to FileCatalyst engineers for analysis and troubleshooting. The information is assembled into a zip archive under the diagnostics subfolder of your application installation directory, from where it can be forwarded to the FileCatalyst support team if desired.

Generating diagnostics is a background activity, there will be limited visual feedback to the user when the Diagnostic Report button is pressed, and regular product usage can be resumed immediately. The diagnostics archive can take a few minutes to generate, depending on how busy the product is with other operations. Some temporary files may appear in the diagnostics folder during this time. When the archive is complete and ready to send, it will appear in the diagnostics folder with a name similar to "FileCatalyst<product>_<date&timestamp>_diagnostics.zip".

Please login to the Support Portal (https://support.filecatalyst.com/) to submit a ticket and upload diagnostics and other relevant ticket files. If you already have a Ticket ID, you can also use Support2U (https://support2u.filecatalyst.com/) to send this diagnostics file directly.

Close

This button dismisses the About FileCatalyst and FileCatalyst Central po-up.

FileCatalyst Central Interface: Classic View

This page is an analogy to the previous version of Central's main page. It is comprised of five panels with subsets of the most commonly-viewed data.

Classic View Panels

FileCatalyst Central Home Screenshot
  1. Transfers: transfers currently active on the system
  2. Current Bandwidth: a graphical representation of the current bandwidth of the selected server node. Nodes may be selected from the drop down.
  3. Alarms: the ten most recent alarms. To view more, go to the dedicated Alarms page
  4. Nodes: a list of nodes which Central is aware of. Offline nodes will appear here unless they are "detached" in the Nodes view.
  5. Transfer Statistics: aggregated statistics for the volume of data transferred by last hour, day, and week.

Classic View Data

Current Transfers

A subset of the full details seen in the Current Transfers view.

FileCatalyst Central Home Transfers Pane
  1. Source/Destination: The alias or IP of source and destination nodes.
  2. Filename: The filename (minus full path) being transferred
  3. Status: Specific activity occurring for the transfer task
  4. Progress: Progress bar representing estimated percentage of task completion

Bandwidth Usage

FileCatalyst Central Home Bandwidth Usage Pane
  1. Select which node's bandwidth usage will be shown. Disconnected nodes are grayed out.
  2. Gray line: total bandwidth used on the selected node
  3. Orange line: total outbound bandwidth from the node
  4. Blue Line: total inbound bandwidth to the node

Alarms Overview

FileCatalyst Central Home Alarms Pane

The columns are a subset of the full details seen in the Alarm Details view.

  1. Node: The FileCatalyst node raising an alarm or notification
  2. Alarm Name: A label for the type of alarm
  3. Severity: From “Notification” to “Critical”
  4. Time: The date and time the alarm was first raised
  5. Description: Plain-English description of the alarm

Managed Nodes

FileCatalyst Central Home Nodes Pane

The columns are a subset of the full details seen in the Node Details view.

  1. Node: Alias or IP of a FileCatalyst node (3rd-party clients are not managed)
  2. Hostname: IP or “name” of the machine with FileCatalyst installed on it
  3. # Alarms: How many alarms are currently raised by this node

Transfer Statistics

FileCatalyst Central Home Statistics Pane

Each of the four statistics (Volume Transferred, Files Transferred, Successful Transfers, and Failed Transfers) has data available for the last hour, day, or week. Volume Transferred statistics will be shown using the most appropriate unit of measurement; small files will be in Bytes, while large transfers may use GB (Gigabytes) or TB (Terabytes).

FileCatalyst Central Interface: Main Navigation Views

The administrator may use the main navigation to view more available data. Detail views are available through the main navigation bar but also by clicking the header of smaller (subset) panels on the overview page.

FileCatalyst Central Menu Bar

Current Transfers

A continuously-updated view of the ongoing individual file transfers on the managed FileCatalyst system.

FileCatalyst Central Transfers Detail View
  1. Source/Destination: The node's alias or IP is shown, along with an icon designating the product type. Administrators may click the alias to open a separate window with a remote administration view for full control of the node.
  2. Username: the name of the user account on the FileCatalyst Server.
  3. Filename: the full filename plus extension(s) being transferred.
  4. Start Time: Day and time the file transfer was initiated.
  5. Status: The current status of the file transfer. These statuses include: “Not Attempted”, “Success”, “Cancelled”, “Error”, “Transferring”, “Verifying”, “Compressing”, “Initializing”, “Updating Timestamp”, “Changing Permissions”, “Task Complete”, “Done Transfer”, “Checking”, “Creating Signature”, “Creating Delta”, “Rebuilding”, “Creating DMG”, “Moving with STOR”, “Reconnecting”, “Monitoring”.
  6. Progress: represented in terms of percentage (%) of total data to be sent and also as amount of data sent thus far.
  7. Transferred: amount of data transferred. This amount is represented in size-appropriate units (Bytes, KB, MB, GB, or TB).
  8. Rate: current effective transfer rate in Kbps, Mbps, or Gbps according to which is most appropriate.
  9. Packet Loss: percentage (%) of packets being dropped; this is a reflection of network conditions and how well your system is configured to prevent loss (for example, using congestion control).

Session History

FileCatalyst Central Session History View

This view shows an ongoing history of transactions with definable start and end times. A session begins when a file transfer is initiated between two nodes, and ends when the last file has been finalized or when the connection is otherwise closed.

FileCatalyst Central Session Overview View
  1. Session ID: Unique ID for this particular session. Administrators may click this ID to see the individual file transfers that comprise the session. Columns for the session detail view reflect those of the “Current Transfers” view.
  2. Source/Destination: The node's alias or IP is shown, along with an icon designating the product type. Administrators may click the alias to open a separate window with a remote administration view for full control of the node.
  3. Username: the name of the user account on the FileCatalyst Server.
  4. Status: the final status of this session; may be “SUCCESS”, “ERROR”, or “CANCELLED”
  5. Start Time: Day and time the session was initiated.
  6. Duration: Total time taken by the session in DD:HH:MM format
  7. Total Transferred: amount of data sent during the transfer, represented in bytes, MB, GB, or TB according to which unit is most appropriate.
  8. Avg Rate: The average effective speed of the transfer, in Kbps, Mbps, or Gbps as appropriate
  9. Avg Packet Loss: percentage (%) of packets dropped for this session; this is a reflection of network conditions and how well your system is configured to prevent loss (for example, using congestion control).

FileCatalyst maintains a database of transaction history. To view past transactions, you may search the database based on certain criteria using the form:

FileCatalyst Central Search Records menu FileCatalyst Central Search Records form
  1. Result Set: Whether records should be retrieved at the session level (all files transfered within a session matching the search) or the file level (an individual row for each file that matches the search).
  2. Search by source: Keyword match for the source node name/alias
  3. Search by destination: Keyword match for the destination node name/alias
  4. Start date and time: a datepicker will allow you to specify the date and time (down to the minute) at which a session or file transfer started
  5. End date and time: a datepicker will allow you to specify the date and time (down to the minute) at which a session or file transfer ended
  6. Filename or Path: Keyword match for a filename or a remote destination path associated with the session or file transfer
  7. Filesize from and to: specify the size and units (B, KB, MB, GB, TB) to match particular file sizes sent during a session or file transfer.
  8. Status: Narrow results down to successful, failed, or canceled transfers.

Report

The report page is responsible for displaying aggregated transfer data collected by the FileCatalyst Central instance. The information is presented via a histogram and a summary table.

FileCatalyst Central Report
  1. The Modify Selection panel has two containers within: Available Nodes and Node filters. The first container holds a “tag” for each node connected to this instance of FileCatalyst Central that has not been used as filter yet. The second container holds the nodes that are being filtered on. If there are a large number of nodes in the list of available nodes, a search field will appear within that container. Entering any text into the field will filter out those nodes that don't match the term entered. The nodes that are filtered out still exist; they are simply visually hidden. Emptying that search field will reset the filter.
  2. The Report panel contains the histogram representing the amount of data transfered to and from the filtered nodes. If no nodes are selected as filters, it shows the information relative to all available nodes.
  3. Below the histogram is a summary table showing the same information as the histogram, but as an alpha-numeric representation.

Nodes

Nodes are any instances of FileCatalyst or 3rd-party applications communicating with one-another within a FileCatalyst deployment. Richer details are available from FileCatalyst applications, though some details are available through the context of 3PP file transfers.

FileCatalyst Central Nodes menu FileCatalyst Central Nodes Detail View
  • Node: the user-defined name (or "alias") for the node
  • Type: the FileCatalyst product which is connected
  • Version: the FileCatalyst product version
  • Hostname: name of the machine on which the FileCatalyst product is installed
  • # Alarms: the number of alarms currently raised by this node
  • Highest Severity: Alarms have 5 degrees of severity, from “None” to “Critical”. This column shows the highest severity of any one alarm raised by the node
  • # Sessions: the total number of separate transfer tasks ongoing to and from this node
  • Transmit Rate: total rate for upload from this node, in the most appropriate unit of measurement (Kbps, Mbps, Gbps)
  • Receive Rate: total rate for download to this node, in the most appropriate unit of measurement (Kbps, Mbps, Gbps)
  • Tools: column containing tools to assist managing the nodes. Current tools include:
    • Detach (broken chain icon): Remove this node from being monitored by FileCatalyst Central. Detached nodes may reappear after they are restarted or after a configuration change on the node side. The detach function is typically used to remove decomissioned nodes from the Central view; an administrator will not normally detach a node which is expected to be active again.
    • Refresh (refresh icon): The files related to the node's view may be unavailable or corrupted. Clicking "refresh" will delete the node's HTML files and then attempt to recover a new copy from the node. This option is only available when the node is active, and the process may take a few seconds or several minutes depending on network conditions.

Current Alarms

All alarms have multiple values assigned to them to better understand the fault and the service raising the alarm.

FileCatalyst Central Current Alarms menu FileCatalyst Central Alarms Detail View
  1. Details: Click the “+” widget to show details related to the row. Some of these details are already visible in the table row itself, but the expanded view provides the full text for each, along with some details not otherwise available:
    • Service Type: the type of FileCatalyst product raising the alarm (eg. HotFolder, Server, Central, TransferAgent)
    • Node Alias: user-defined name for the node
    • Node AgentID: a unique ID assigned to the node automatically during the installation process
    • Node Hostname: the machine name, if available
    • Node IP: IPv4 address for the machine if available; otherwise will show the IPv6 address
    • Alarm Name: the full name of the Alarm as used internally by FileCatalyst Central
    • Alarm State: the only expected value should be SET. Other alarms are moved to the Alarm History view
    • Alarm Severity: one of “Critical”, “Major”, “Minor”, “Notification”, “None” in descending order of urgency
    • Alarm TimeStamp: full date the alarm was raised, in Greenwich Mean Time (GMT)
    • Alarm Description: human-readable description of the alarm, also containing technical information when relevant
    • Alarm Transaction: a unique transaction number for this particular instance of the alarm
  2. Node: user-defined name for the node
  3. Hostname: name of the machine on which the FileCatalyst product is installed
  4. Alarm Name: a shortened version of the internal “Alarm Name” visible in the details view.
  5. Severity: one of “Critical”, “Major”, “Minor”, “Notification”, “None” in descending order of urgency. Items in the severity column are also color-coded based on severity, with bold red being the most severe.
  6. Time of Alarm: time the alarm was raised in DD:HH:MM format
  7. Alarm Description: human-readable description of the alarm. Click on the “Details” icon to view all alarm details including full description.
  8. Discard All / Discard: Clicking “Discard All” in the header will discard all current alarms. Click “Discard” on a per-row basis to discard individual alarms. Note: discarding an alarm does not necessarily permanently remove it. If a node continues to have a communications error, for example, the alarm will be re-raised at the set interval. Notifications will not re-appear in this view once discarded.
  9. Silence: Available only for individual alarms. Once an alarm has been silenced, it will be removed from all current alarm lists within Central. This is useful for administrators who are aware of the alarm but are not able to act on it at the moment. The list of currently silenced alarms appear in a separate view, where they may be unsilenced if needed.

    Note: A notification is treated as a separate alarm when raised. Silencing one instance of the notification does not prevent nodes from creating a new (not silenced) notification that seems otherwise identical to the one you just silenced.

Archived Alarms

This view is identical to the Current Alarms view (previous section), but contains historical data and has no “discard” links.

FileCatalyst Central Archived Alarms menu

Silenced Alarms

This view is identical to the Current Alarms view, but contains only alarms that has been silenced and has no “discard” links. In addition, this view contains the ability to un-silence all or individual alarms.

FileCatalyst Central Archived Alarms menu FileCatalyst Central Alarms Detail View

FileCatalyst Central Interface: Node Views (For nodes version 3.6 and below)

Server Nodes

When you click on a FileCatalyst Server node name on almost any table view, you will be brought to an information page for that particular node:

FileCatalyst Central Server Configuration

The Users, Groups, and Virtual Folders views contain overlapping data; however, it is presented in terms of the item of concern.

  1. Users: Lists all users on the server, and then presents information about each, including their name, home directory, and file transfer limitations.
  2. Virtual Folders: Lists all virtual folders on the server and information about each, including the local filesystem path, which users have access to the folder, and which groups have access to the folder.
  3. Groups: Lists all groups on the server and information about each, including which users belong to that group, and which folders the group has access to.

HotFolder Nodes

When you click on a FileCatalyst HotFolder node name on almost any table view, you will be brought to an information page for that particular node:

FileCatalyst Central HotFolder Configuration
  1. Tasks: Details for any ongoing current transfers, at the task (rather than session or file) level. Tasks may be executed or canceled.
  2. HotFolders: view the names and local paths of HotFolders configured on the node.
  3. Sites: view the names and hostnames of sites configured on the node.

FileCatalyst Central Interface: Node Views (For nodes version 3.7 and higher)

Connecting to a node (Server, HotFolder, TransferAgent) of v3.7 or higher redirects you to the HTML administration interface for that node in a new tab. This means that you are presented with the options supported by the version of the node.

Example 1: Launching the admin interface for a v3.7 FileCatalyst Server page will look like the following: FileCatalyst Server Administration 3.7

Example 2: Launching the same interface for a connected v3.7.2 FileCatalyst Server, there are additional administrative functions available: FileCatalyst Server Administration 3.7.2

Similar functionality exists across HotFolder and TransferAgent nodes connected into Central.

FileCatalyst Central Interface: Map Creation and Editing

Any nodes connected to FileCatalyst Central may be organized into a “map” view. The map view offers a way to visualize the flow of data between nodes, as well as to change the details presented in the “Map and Data” view of FileCatalyst Central. Maps are manually created by the administrator; as such, upon first visit to the “Map and Data” page, you will be prompted to create a map.

First Map

FileCatalyst Central Map and Data, first map

If you are logged as admin and do not have a map created, the following message will appear: “You do not have a map set yet. Redirecting to edit map page...”, at which time the browser will send you to the edit map view.

FileCatalyst Central Map and Data, first map read-only

Read-only adminsitrators cannot create maps; therefore, if you are logged as read-only and do not have a map created yet, the following message will appear: “There are no maps available, and you do not have permission to create one. Please browse to another page or log in with full administrator priveleges.”.

Edit Map: Conventions

FileCatalyst Central Map and Data, first map read-only
  1. The “canvas” is the area in which the map will be drawn
  2. The “Edit Name” link prompts the user to set or edit the map's name.
  3. If a map already exists, you can switch to it using the select box. The star icon is used to set the selected map as favorite. The favorite map will be the default map in the Map and Data view.
  4. The Map and Data (current map) button allows switch between editing maps and the Map and Data view. You must save your changes before switching to the Map and Data view, or they will be lost.
  5. The Save Map button saves the current state of the map.
  6. The Add Map button begins the creation of a new map.
  7. The Delete Map button deletes the currently selected map.
  8. The Add nodes button invokes a dialog allowing the administrator to select nodes and add them to the map.
  9. The Add Organizers button invokes a dialog for creating an “organization unit” (more details in Edit Map: organizers section).
  10. The Backgroud Image button invokes a form responsible for adding or selecting a background image, as well as modifying related properties.

Edit Map: Nodes

FileCatalyst Central Map and Data, adding nodes dialog

When Add Nodes is clicked, the dialog shown on the image above appears, containing the nodes connected to your instance of FileCatalyst Central.

  1. Clicking a node “tag” toggles selection of the node.
  2. Once you selection is done, click Add Selected Nodes
  3. The Cancel button will close the dialog and cancel node selection.
FileCatalyst Central Map and Data, collision nodes

The selected nodes appear in the top-left corner of the canvas. They must then be dragged to different regions of the canvas to avoid collision with each other.

When multiple nodes are added, or if one node is dropped while in contact with another, the “Collision detected. Overlays are not allowed.” warning appears below the map.

After resolving collisions, a map may look something like the following:

FileCatalyst Central Map and Data, first map read-only
  1. Nodes are distinguished by icons:   for FileCatalyst Server,   for FileCatalyst HotFolder, and   for FileCatalyst TransferAgent
  2. The node name (or “alias”) appears below the icon.
  3. Clicking the icon at the top-left corner of each node will give the option of see more details about the node or remove the node from the map. Note: removing a node from a map will not detach the node from FileCatalyst Central. To learn how detach the node, please refer to the “Nodes” section of this document.

Edit Map: Organizers

FileCatalyst Central Map and Data, organizer dialog

When Add Organizers is clicked, the dialog shown on the above image appears, containing a form for adding a new organizer. An organizer is a conceptual “container” which can contain nodes. Nodes inside an organizer will have their data combined and saved on the FileCatalyst Central database, allowing reports of data transfers to be aggregated. The following fields are available when creating a new organizer:

  1. A title or description which will be visible on the organizer on the map.
  2. An initial width (you may resize later) for the organizer, with a minimum of 150 pixels.
  3. An initial height (you may resize later) for the organizer, with a minimum of 150 pixels.

Once the form is complete, click Add Organizer. A button is also available to Cancel adding a new organizer. After adding organizers, the map may look something like the following:

FileCatalyst Central Map and Data, rendering the organizers

The organizer on left-top corner shows all default options (no title, 150px by 150px). The other one is resized and has the title “America” set on it. The following tools are available on created organizers:

  1. The (edit) icon shows a dialog identical to “Add Organizer”, presenting the option to update any fields.
  2. When a node is successfully dragged into an organizer, it receives a (link) icon on top-right corner. To sever this link, drag the node outside of the organizer. If successful, the icon will disappear.
  3. The (trash) icon invokes a dialog:
    FileCatalyst Central Map and Data, remove organizer dialog
    You may either remove a node and all of its contents (Remove Organizer and Nodes), remove the organizer box itself without disrupting any nodes (Remove Organizer Only), or Cancel the operation.

Edit Map: Background Image

When Background Image is clicked, a dialog appears which allows the administrator to choose an image to be used as background for the currently selected map.

FileCatalyst Central Map and Data, background Image initial dialog
  1. Three pre-installed options are available; you may click Apply to select one for the current map.
  2. Upload a new image pressing the browse button, which will call the file explorer implemented by your browser.
  3. Once the image is uploaded, it will become part of the gallery of images and will be available to Apply.
  4. After Applying an image, click Done button.
  5. You may also Cancel the dialog at any time.
FileCatalyst Central Map and Data, background Image applied
Canvas with an image applied as background

Once an image has been applied, a number of controls become available, to the right of the canvas:

FileCatalyst Central Map and Data, bg image control
  1. Backgroud Image will display the selection/upload dialog.
  2. Background Repeat allows smaller images to repeat: repeat-x for horizontal-only, repeat-y for vertical-only, or repeat to tile in both directions. When No-repeat is selected or the image is bigger than the canvas, there will be no tiling.
  3. Opacity allows the background image be partially transparent. This has the net effect of “muting” an image's colors.
  4. Height allows the background-image stretch vertically.
  5. Width allows the background-image stretch horizontally.
  6. Remove Current Background Image removes the background image from map. This also has the effect of removing these controls.
  7. Resize Background To Fit will stretch the image until it fills the container width. Height is set proportionally.
  8. Reset Background Position moves the background image to the default position (aligned top-left).

Edit Map: Edit Name

Clicking the Edit Name link presents the following dialog:

FileCatalyst Central Map and Data, edit map name dialog
  1. Create or update the Map Name in the supplied text field
  2. Press Apply to temporarily apply the name for the map. The map must be saved for this change to persist.
  3. Cancel to close the dialog without any changes.

Edit Map: Saving Map

Click Save Map to save the map's current state. A message will appear with the results of the save attempt.

Success:
FileCatalyst Central Map and Data, saving map
Failure due to overlapping nodes:
FileCatalyst Central Map and Data, error saving overlay nodes
Failure due to overlapping organizers:
FileCatalyst Central Map and Data, error saving overlay organizers

Other error messages may also appear for unexpected situations.

FileCatalyst Central Interface: Map and Data View

Map and data: Overview

Once a map is created, it is possible navigate to the Map and Data page. This page is dynamic, responding to selections made in the map and in other tables. Information like tasks, sessions, alarms, histogram, bandwidth graphs are displayed filtered by selections on the map canvas. If no elements on the canvas are selected, the entire contents of the map are used as the filter. Information on the Tasks and Sessions tables, as well as the Transfer Histogram are related to the selection.

FileCatalyst Central Map and Data

On this page, a number of UI (user interface) conventions are followed:

  1. All panels may be collapsed with the icon to the left of the title. Also, if not using Internet Explorer, they can be rearranged vertically to suit the administrator's needs.
  2. A select box above the canvas provides the possibility to switch the map in the event that two or more maps have been created. The default map (if defined) is marked with a star filled with blue ().
  3. The double-screen icon ( | ) creates a second view of the filtered data (see Map and Data: Split Screen for more details)
  4. The Edit Map button appears for admin users, allowing you to switch to the Edit Map view.
  5. The Report from Selection button sends the user to the report page, with the report pre-filtered based on the map selection.
  6. If a FileCatalyst HotFolder contains Sites connecting to a FileCatalyst Server present in the current map, a line is drawn to represent the link. (see Map and Data: Links)
  7. The bandwidth usage graph is identical to that in the Classic View, but with the selection box limited to nodes appearing in the current map.
  8. The Alarms table shows a summary of the current alarms based on selection.
  9. The Transfer Histogram presents data transfer information about the canvas selection. It contains a select box with predefine timeframes to show the related data.
  10. The Tasks shows the aggregated tasks from all HotFolders in the map selection. If the user has full administrator priveleges, an execute/cancel icon becomes available.
  11. The Sessions table shows aggregated session information from the current map selection. If an individual task is selected, sessions are filtered by that task.

Map and Data: Selectable Nodes

In the Map and Data view, the nodes cannot be dragged and must be re-positioned in the edit view; however, they do present certain options to the administrator.

FileCatalyst Central Map and Data, nodes
  1. When selected, a node's border turns blue. All selected nodes act as filters for the page's panels.
  2. When the menu icon ( ) is clicked, a popup menu appears. This allows the user to view “Details” or “Connect to node”.
    • “Detail” invokes a dialog box showing: type, IP, version, host, and ID (seen in the image above).
    • “Connect to node” redirects the administrator to a management page appropriate to the product type and version.
    • An icon will also appear in the upper-right corner of the node widget when there is an alarm raised by the node. See the next section for details.

Map and Data: Nodes Alarms

As mentioned in the previous section, if a node has an alarm, an alarm icon ( ) is displayed on top-right corner of the node. Once clicked, a dialog appears with the list of alarms related to the node. The alarm icon changes its color to match the higher severity alarm color of the node.

FileCatalyst Central Map and Data, nodes

Map and Data: Organizers

In the Map and Data view, organizers cannot be dragged and must be re-positioned in the edit view; however, they do present certain options to the administrator.

FileCatalyst Central Map and Data, nodes
  1. A selected organizer has a blue border to identify its state. The contents of selected organizers act as filters for the page's panels.
  2. The filter icon ( ) must be clicked to toggle selection. Clicking the border will NOT select the organizer.

Links are dynamically generated. In case of FileCatalyst TransferAgent, ongoing transfers create the link relationship. In the case of FileCatalyst HotFolder, configured “sites” establish this relationship. Links can be selected by clicking the widget in the middle of the line.

FileCatalyst Central Map and Data, nodes

Map and Data: Making Selections

The tables, bandwidth usage graph, and transfer histogram have information filtered primarily by the selections on the canvas. Selections may be made and modified with the following user interactions:

  • Single click selection

    Clicking on a single node, organizer ( ) or link will remove the selection of all other nodes, organizers or links, leaving only the last clicked object selected. Clicking on an empty area on the canvas will de-select all objects.
  • Selecting using “Lasso tool”

    This common UI convention allows users to click an empty area of the canvas and drag a “lasso” around any visible nodes. Links and organizers are not selected.
  • Selecting using control key

    If the Control Key is held while the user is clicking a node, organizer ( ) or a link it will added the item for the current selection. If the item is alredy selected, the Control-click will de-select it.

Map and Data: Multi Selection

FileCatalyst Multi Selection

When the selection involves different type of elements, e.g. a FileCatalyst HotFolder, a FileCatalyst Server and a organizer, then the surrounding widgets will react accordingly:

  • Bandwidth Usage Graph

    The bandwidth graph only can show graphs for FileCatalyst HotFolders and FileCatalyst Servers. Because of this, when a multi-selection occurs, only one of the nodes selected will be represented by this widget. If the new selection already contains the visible node, it will remain visible. If the new selection excludes the previous selection, it will switch to the first node in the new list.

  • Alarm Table, Session Table, Task Table

    These tables will be filtered to show aggregated information from selected Nodes, Links, and Organizers. Near the title of each table, a list of currently-filtered nodes will appear:

    FileCatalyst Multi Selection tables header

    (Organizers without name will be represented as "organizer - #id" , where #id is the numerical identifier of the organizer)

    Some of these tables' titles link to related information. The Alarm table links to the Alarm page, and the Session table links to the Current Transfers page.

  • Transfer Histogram

    The histogram will show aggregated information from the current selection. The title of this panel links to the Report page for additional information. The current time frame selection is carried over.

    FileCatalyst Multi Selection histogram
  • More Tag

    If three or more items are selected, two of them will be presented, and the difference (number of the selected minus the 2 already showed) is represented with a "# more ..." tag, where "#" is the number of hidden items. Once this tag is clicked, a small dialog appears and shows the name of the rest of the selected items.

    FileCatalyst Multi Selection histogram

When only one or more Links, or, one or more Organizes are selected the surround widgets working the same way of Multi Selection.

Map and Data: Selecting Only FileCatalyst HotFolder

When the selection involves only a single FileCatalyst HotFolder, a new table is presented: the Last Files table. The task table, bandwidth graph and the histogram will show data from this HotFolder (only for nodes version 3.7 and above).

FileCatalyst HotFolder Selection Tables

The title of the Last Files table links to the Search page.

Map and Data: Selecting Only FileCatalyst Server

When the selection involves only a single FileCatalyst Server, the Last Files table appears and the Session table remains, but the Tasks table is hidden. The bandwidth graph and the histogram will show data from this Server.

FileCatalyst FileCatalyst Server Selection Tables

The title of the Last Files table links to the Search page.

Map and Data: Transfer Histogram

FileCatalyst Map and Data Histogram
  1. The select box shows the time ranges for filtering the data. The Today option shows data from 00:00 a.m. of the current day up to the time frame available.
  2. The title Transfer Histogram: is presented together a list of the elements selected.
  3. The blue bars represents the amount of data Received, while the orange bar represents Transmitted.
  4. Below the select box, a subtitle shows what the chart currently represents in terms of data unit (eg. KB, MB, GB) and time scale (eg. HOURS, DAYS, WEEKS).
  5. Leaving the mouse over a bar shows a box detailing the time and amount of transferred data.

Map and Data: Filtering Table Results

By Task

The rows of the Tasks table can be used as a filter by clicking on them. When a task row is selected, the Sessions table and Last Files table are filtered by that individual task.

FileCatalyst Map and Data Selecting by task

By Session

The rows of the Sessions table can be used as a filter by clicking on them. The Last Files table is the only one that can be filtered by session.

FileCatalyst Map and Data Selecting by task

Removing Row Filters

It is possible remove the filter by making a new selection, clicking on the selected row again (to de-select it), or clicking on the filter icon ( ) beside the filtered table label.

Map and Data: Split Screen

The double-screen icon ( | ) when clicked launch a new tab or window (depends on your browser settings). This second tab contains the same tables of Map and Data main page, and also, the filters executed on the main page affect the child tab.

Filters

The table filters work for both direction in the split screen, which means that you can filter or remove filter clicking in the table on the main screen or splited tab. The filterable tables are the same of previous section(Map and Data: Filtering Table Results).

Filter Applied on left tab affecting right tab:
FileCatalyst Map and Data split screen

Remove Row Filters (One tab to another)

It is the same of the previous section(Map and Data: Filtering Table Results), it is possible remove the filter doing a new selection, clicking on the selected row again or clicking on the beside the filtered table label

FileCatalyst Central Interface: Configuration

The configuration page contains a number of panels for configuring various aspects of a Central deployment. Most changes are made via the "Server Configuration" panel, which itself contains a number of tabs. Most changes will take place immediately as the field is updated.

FileCatalyst Central Configuration

Server Configuration: License

This tab has two purposes: first, it provides all information about the current license; next, it allows the administrator to set a new license key.

  • Version (read-only): This full string should be provided to FileCatalyst should customer support be required.
  • Request String (read-only): when applying a license renewal or upgrade, the FileCatalyst representative will need this string.
  • License Key (read-only): the current license key. Typically for information purposes only
  • License Details (read-only): a list of all priveleges and limitations tied to the FileCatalyst Central license.
  • Change License Key: click or tap this button to launch a dialog box with a text field for the license key provided by FileCatalyst.

Server Configuration: Email Settings

When connected to an existing SMTP server, the FileCatalyst Central application is able to dispatch emails for events such as alarms being raised.

  • Enable Email: check this box to allow Central to communicate with an SMTP server
  • From: email address to be used as the "sender"
  • To: recipient of automated emails. Multiple addresses may not be specified in this field; to send to multiple people the administrator must create an address which has been set up to forward to multiple recipients. If only one other recipient is required, use the "cc" field.
  • cc: an additional email address which will receive the "carbon copy" of any dispatched emails.
  • SMTP Address: the hostname of the mail server to be used
  • SMTP Port: the listener port of the mail server
  • Use SMTPS (SSL): enable an encrypted channel to be opened for commands to the mail server
  • Requires Authorization: the mail server may be configured to require credentials before it will dispatch an email. If this is the case, check this box and complete the "Username" and "Password" fields.
  • Username: the username required for authorization on the mail server
  • Password: the password required for authorization on the mail server

Server Configuration: SNMP Settings

The administrator may enable FileCatalyst Central to dispatch SNMP traps to tie into an existing notification system. Upon completing the input fields and clicking "Add New", a string identifying the Manager is added to the list in the text box.

  • Enable SNMP: check this box to allow Central to communicate with an SNMP manager
  • SNMP Manager: hostname for the SNMP manager
  • SNMP Port: port for the SNMP manager
  • Community: a string provided by the SNMP administrator.
  • Version: choose from v2c or v1

Below the input fields is a box listing available SNMP managers. These may be selected individually and then updated or deleted.

Server Configuration: Alarms Settings

A number of options allow the administrator to tailor the behavior of capturing and reporting alarms:

  • Polling Interval: The interval at which Central will check with connected nodes for alarm status. In theory, an alarm could be raised and solved within the polling interval and therefore never be exposed to the interface.
  • Rebroadcast Interval: How often the current list of alarms should be sent via SNMP or email.
  • Notification Interval: How often the current list of alarms is updated for rebroadcast purposes.
  • Alarm Retention: Amount of time resolved alarms are kept in a viewable history.
  • Session History Retention: Amount of time completed sessions are kept in a viewable history.
  • Active Alarms: a list of possible alarms that may be triggered during the polling phase (all available alarms enabled by default)
  • Disabled Alarms: a list of alarms that will be ignored for notification purposes. Administrators will not be alerted by email for disabled alarms. For example, an admin may not want to be sent an email for every Transfer success, failure, or cancellation. Please note a disabled alarm will still display under Alarms section of Central.

Remote Connections Configuration

The values in this panel are used by remote applications such as FileCatalyst HotFolder and FileCatalyst Server to establish a connection to the FileCatalyst Central application.

  • Username: remote applications will use this name for authentication
  • Password: remote applications will use this password for authentication
  • New Password: to update the remote authentication password, enter the current password into the "Password" field, a new one into this field, and a confirmation of the new one into the "New Password (Re-Type)" field.
  • New Password (Re-Type): to update the remote authentication password, enter the current password into the "Password" field, a new one into the "New Password" field, and and a confirmation of the new one into this field.
  • Listener IP: a list of available IPs on the machine to which FileCatalyst Central is installed. Select the IP which can be reached from remote connections.
  • Connection Port: set the port for establishing remote connections for monitoring.
  • Use External IP: Enable this option if the applications connecting to Central are to use an external IP which will be forwarded to the Central machine.
  • External IP: If "Use External IP" is checked, this is the IP used by applications to connect to Central.

Web Administration Configuration

This panel allows the administrator to set new credentials for logging into the FileCatalyst Central web interface. Two accounts may be configured: "Admin" and "Read-only"

For both accounts, the username may be updated. To change the password, each must have 3 fields completed: the current password, the new password, and the new password re-entered.

Local Configuration Values

This panel is used to configure how the local browser interacts with the application. Changes made here are not persistent from machine to machine, but are kept in local storage for the current browser only.

  • Idle Timeout (minutes): the amount of time the web application interface must be idle (no mouse or keyboard entry) before updates are paused. Once paused, there are no further HTTP requests and the web session will eventually time out. Web session timeouts are set by the web server and are not configured via this interface.
  • Session Timeout (seconds): time allowed for fail communication between the browser and FileCatalyst Central before used logged out.
  • Clear Information Saved on Local Storage: It will reset the local configuration to default values. Also, it will clear sorting, search and pagination cache for tables within the application.

Admin Tools

This panel is initially collapsed, as it contains tools that should not ordinarily be needed.

  • Rebuild History: Rebuilds and replaces in-memory statistics with the persistent statistics stored in the FileCatalyst Central database. The application itself is not at risk by rebuilding history; however, the operation will heavily consume system resources as the rebuild happens; depending on system specifications, this operation should complete in under a minute.

The Configuration File

All of the configuration options available through the user interface are accessible through the FileCatalyst Central's configuration file, maconfig.conf. This file is located directly in the install path of the core application on Windows and Linux. On OSX, the file can be found in /Users/<installing user>/Library/Application Support/FileCatalyst/

Making Modifications

The only reliable way to work with this file is:

  1. Stop the FileCatalyst Central application from running. In most cases, this will mean stopping the service.
  2. Modify the configuration file using the editor of your choice
  3. Save the configuration file
  4. Run the FileCatalyst Central application. This will usually mean restarting the service.

The format of the configuration file is relatively straightforward. Hash symbols (#) denote comments, with the remaining parameters in a “parameter=value” syntax with each parameter having its own line. Here is a sample of the maconfig.conf file:

# Location of alarm history file and active alarm XML file.
# If full path if not indicated, a relative path is used (where JVM is launched).
FCMonitoringAgent.config.active.alarm.list=alarmactive.xml
FCMonitoringAgent.config.historical.alarm.log=alarmhistory.log

# List of agents to be monitored.
FCMonitoringAgent.config.agents=agentlist.xml

# Polling interval of FileCatalyst Central towards monitored applications
# Default value once per minute (60000)
FCMonitoringAgent.config.polling.interval.millis=60000

Parameters Only Found in maconfig.conf

Certain parameters are not exposed to the web interface. In some cases, the defaults are expected to provide the best scenario; in others there are practical limitations to exposing the parameter (for example, changing web server port).

  • Windows service configurations: a collection related to how the service behaves in Windows. Among these are heap size parameters (wrapper.java.initmemory, wrapper.java.maxmemory) and Java class path (wrapper.java.classpath.x
  • Wrapper Logging Properties: a collection related to logging behavior:
    • wrapper.console.loglevel

      Log level to use for console output. Valid log levels include: NONE for no output, FATAL to only show fatal error messages, ERROR to show all error messages, STATUS to show all state changes, INFO shows all JVM output and informative messages, and DEBUG shows detailed debug information. The default value is INFO.

    • wrapper.logfile

      Log file to which all output to the console will be logged. If the logfile is not specified, then file logging will be written to a file called "wrapper.log" in the same directory as the Wrapper executable. Providing a blank value will cause file logging to be disabled.

    • wrapper.logfile.format

      Format to use for logging to the log file. Logging was intentionally kept simple. The format consists of the tokens 'L' for log level, 'P' for prefix, 'D' for thread, 'T' for time, 'Z' for millisecond time, and 'M' for message. If the format contains these values then it will be included in the format. The order of the tokens does not affect the way the log appears, but the 'M' token should usually be placed last as it is the only column without a uniform width. If the property is missing or commented out, then the default value 'LPTM' will be used. Setting the property to a blank value will cause file logging to be disabled.

    • wrapper.logfile.loglevel

      Log level to use for logging to the log file. Valid log levels include: NONE for no output, FATAL to only show fatal error messages, ERROR to show all error messages, STATUS to show all state changes, INFO shows all JVM output and informative messages, and DEBUG shows detailed debug information. The default value is INFO.

    • wrapper.logfile.maxsize

      The wrapper.log file can be set to roll when the file reaches a specified size. The default value of 0 will disable log file rolling. To roll the file, specify a maximum file size in bytes. The size can be abbreviated with the suffixes 'k' for kilobytes, or 'm' for megabytes. For example, '10m' sets the log file to be rolled when it reaches a size of 10 megabytes.

    • wrapper.logfile.maxfiles

      When log file rolling is enabled, old log files will be renamed by appending an integer to the end of the file. Larger indices are older log files. The maximum number of rolled log files can be set using this property. The default value, 0, implies no limit on the number of files. If this number is reduced from say 10 to 5, the extra 5 files will not be deleted, new log files will only be rolled within the first 5 indices.

    • wrapper.syslog.loglevel

      Log level to use for logging to the Event Log on Windows systems, or the syslog on unix systems. Valid log levels include: NONE for no log output, FATAL to only log fatal error messages, ERROR to log all error messages, STATUS to log all state changes, INFO logs all JVM output and informative messages, and DEBUG logs detailed debug information. The default value is NONE. Be careful setting log which are too low. DEBUG for example will very quickly fill up your syslog or event log.

  • Wrapper NT Service Properties: These properties may not be modified while FileCatalyst Central is installed as a service. Please uninstall the service before modifying, and then reinstall the service once complete.
    • wrapper.netservice.name

      Name of the NT service when installed.

      WARNING: Never change the value of this property while an application is installed as a service. Doing so will make it impossible to uninstall the service. Always remove an existing service before changing the name. The service with the new name can then safely be reinstalled.

    • wrapper.ntservice.displayname

      Display name of the NT service when installed.

    • wrapper.ntservice.starttype

      Mode in which the service is installed. AUTO_START starts the service automatically when the system is rebooted. Or DEMAND_START which requires that the service me started manually.

    • wrapper.ntservice.interactive

      Setting the interactive property to true will make it possible for the service to display a GUI and have access to the desktop when run as a service. The default is false, or a non-interactive service.

Understanding Alarms

Alarm Polling

FileCatalyst Central handles fault management by polling active services. Should a fault occur and be cleared inside of the polling interval, alarms may not be raised.

The longer the polling interval, the longer it will require for the alarm condition to be raised.

Note: Communication between the FileCatalyst Server and FileCatalyst Central is verified/reestablished at every polling interval. If using the Server Administration GUI to view alarms, restarting the FileCatalyst Server (example, as the result of a configuration change) will automatically sever communication sockets, preventing alarms to be viewed until the next polling interval. It is recommended to have the polling interval value set to between 10 seconds to 5 minutes (5 000 to 300 000 ms).

Behavior based on Severity

All alarms that are sent out have a severity assigned to them. They are defined as follows:

  • CRITICAL alarms indicate a complete loss of file transfer ability
  • MAJOR alarms indicate a partial loss of file transfer ability
  • MINOR alarms indicate a partial or complete loss of sub-functionality not related to file transfer
  • NOTIFICATION alarms indicate a one-time event of interest

CRITICAL, MAJOR, or MINOR alarms that are SET will be explicitly cleared when the fault condition is resolved. A matching transaction number can be used to pair up SET and CLEAR alarms to indicate that the fault no longer exists. If the alarm condition persists after a set period (broadcast interval), the alarm will be resent to overcome possible message loss (email server down, SNMP UDP packet loss).

NOTIFICATION alarms have no matching CLEAR alarm sent out. Instead, the alarm is considered to have a limited lifetime (default 15 minutes) before the alarm is considered invalid and consumed (decay). If the alarm condition persists after the alarm has decayed, a new fault condition will be raised.

Alarms Currently Configured

Name unlmtchAlarmsLicenseInvalid
Severity CRITICAL
Comment Sample License is invalid
Products All Products
Name unlmtchAlarmsLicenseExpired
Severity CRITICAL
Comment Sample License has expired
Products All Products
Name unlmtchAlarmsConnectionFailure
Severity CRITICAL
Comment Sample (Legacy) Port 999 (Main FTP Port) Port is unavailable.
Comment Sample (v3.7+) Central could not connect to any of the enabled FTP ports on the remote service at IP: 192.168.1.100
Products FileCatalyst Server
Name unlmtchAlrmsPortError
Severity CRITICAL
Comment Sample Varies based on source event. Alarm raised only when connection attempt fails.
Port 8080 (default FTP PORT on IP 192.168.1.100) Could not be connected
Products FileCatalyst Server
Name unlmtchAlarmsServiceDown
Severity CRITICAL
Comment Sample Unable to communicate with agent 'myAliasName' @ localhost:9999
Products All Products
Name unlmtchAlarmsAuthenticationServiceFailure
Severity MAJOR
Comment Sample Authentication service is down.
Products FileCatalystServer
Name unlmtchAlrmsFileSystemUnavailable
Severity MAJOR
Comment Sample FileCatalyst Server is unable to connect to an External File System (ie: Amazon S3) where user data may reside.
Products FileCatalyst Server
Name unlmtchAlrmsSMTPUnavailable
Severity MAJOR
Comment Sample FileCatalyst Server is unable to connect to an SMTP Server to send out e-mail messages.
Products FileCatalyst Server
Name unlmtchAlarmsRemoteAdminRedirect
Severity MINOR
Comment Sample Configured remote administration port (9999) has been redirected to port (1234).
Products FileCatalyst Server
Name unlmtchAlrmsNodeSyncInProgress
Severity MINOR
Comment Sample Central is downloading usage statistics from the node. Some statistics may be unavailable.
Products All Products
Name unlmtchAlarmsLicenseExpiring
Severity MINOR
Comment Sample License is due to expire on Sun Jun 22 15:52:52 EDT 2012
Products All Products
Name unlmtchAlrmsUnlicensedCall
Severity NOTIFICATION
Comment Sample An unlicensed GET request has been made to /rs/nodes by 0:0:0:0:0:0:0:1. To allow this call, Central must have a license with the 3PP REST feature.
Products All Products
Name unlmtchAlrmsMultipleLoginFailure
Severity NOTIFICATION
Comment Sample User ‘Bob’ has failed 5 consecutive login attempts.
Products FileCatalyst Server
Name unlmtchAlrmsUserDisabled
Severity NOTIFICATION
Comment Sample User 'bob' has been disabled due to 5 consecutive failed login attempts. Administrator can manually re-enable via Server Administration.
Products FileCatalyst Server
Name unlmtchAlrmsMultipleLoginFailureIP
Severity NOTIFICATION
Comment Sample IP ‘192.168.1.100’ has failed 50 consecutive login attempts.
Products FileCatalyst Server
Name unlmtchAlrmsIPBlocked
Severity NOTIFICATION
Comment Sample IP ‘192.168.1.100’ has been blacklisted in the IP filters due to 50 consecutive failed login attempts. Administrator can manually re-enable via Server Administration.
Products FileCatalyst Server
Name unlmtchAlrmsDirectoryUnavailable
Severity NOTIFICATION
Comment Sample User 'abc123' directory 'k:/TESTDATA/b' is unavailable. User may be prevented from logging in.

Virtual Folder 'foo' with path 'H:/foobar' is unavailable. Virtual Folder contents may be unavailable to users.

Hotfolder 'Test Files' with path '/mnt/bigdata/test' is unavailable. Folder may be unavailable for transfers.
Products FileCatalyst Server, FileCatalyst HotFolder
Name unlmtchAlrmsDataPortError
Severity NOTIFICATION
Comment Sample Error entering passive mode. TCP port 8000 may be blocked by your firewall, or you need to enable IP masquerade.
Products FileCatalyst Server
Name unlmtchAlrmsSystemResourceLow
Severity NOTIFICATION
Comment Sample Varies based on resource allocation notification
Products FileCatalyst Server
Name unlmtchAlrmsSystemAdminLogin
Severity NOTIFICATION
Comment Sample Varies based on source event. Alarms raised only on failed logins, not successful logins.
Admin (notARealUser, 0), (IP (127.0.0.1:54378), event: Admin does not exist any directory service.
Products FileCatalyst Server
Name unlmtchAlrmsSystemConfigChange
Severity NOTIFICATION
Comment Sample Varies based on source event:
Admin (admin, 6999), (IP (127.0.0.1:54375), event: Config file fcconf.conf committed to server. Differences detected in configuration file:
key: FCServer.server.config.remote.admin.forceAuthOnLocalhost
old value: true
new value: false.
Products FileCatalyst Server
Name unlmtchAlrmsTransferSuccess
Severity NOTIFICATION
Comment Sample Varies based on resource allocation notification:
Transfer (Upload) was successfully sent. Site: localhost:21 User: user Total files sent: 1 Total bytes sent: 9.9 MB Transfer time: 8 sec Type: UPLOAD (UDP)
Products FileCatalyst HotFolder, FileCatalyst TransferAgent
Name unlmtchAlrmsTransferFailed
Severity NOTIFICATION
Comment Sample Varies based on source event:
Transfer (Upload) failed. Error :Software caused connection abort: recv failed Software caused connection abort: recv failed Site: localhost:21 User: user Total files sent: 1 Total bytes sent: 0 Bytes Transfer time: < 1 sec Type: UPLOAD (UDP)
Products FileCatalyst HotFolder, FileCatalyst TransferAgent
Name unlmtchAlrmsTransferCancelled
Severity NOTIFICATION
Comment Sample Varies based on source event:
Transfer (Upload) cancelled by user. Site: localhost:21 User: user Total files sent: 1 Total bytes sent: 9.9 MB Transfer time: 3 sec Type: UPLOAD (UDP)
Products FileCatalyst HotFolder, FileCatalyst TransferAgent

MIB Definitions

In accordance to SNMP protocols (see here for more details), alarm information (SNMP Traps v1 and v2) are stored in MIB definitions.

There are four MIB files included in the installation package (located in the FileCatalyst Central install directory): two for SNMP v1, and two for SNMP v2 protocols.

  • UNLIMI-TECH-ALARMS-MIB-v1.txt
  • UNLIMI-TECH-ALARMS-MIB-v2.txt
  • UNLIMI-TECH-GENERAL-MIB-v1.txt
  • UNLIMI-TECH-GENERAL-MIB-v2.txt

UNLIMI-TECH-GENERAL-MIB

The general MIB contains general company information and structure. This sparse MIB provides a base of extensibility for future releases.

Currently, the only other available MIB in production is unlmtchAlarms:

OID short Enterprise OID full MIB name Description
1.3.6.1.4.1   enterprises IANA standard for enterprise MIB
enterprises 30640 30640 unlmtchRegMIB IANA definition for Unlimi-Tech
unlmtchRegMIB 1 30640.1 unlmtchProducts Main MODULE-IDENTITY
unlmtchProducts 1 30640.1.1 unlmtchFileCatalystDirect Future MIBs for get/set could point here
unlmtchProducts 2 30640.1.2 unlmtchFCHotFolder Future MIBs for get/set could point here
unlmtchRegMIB 2 30640.2 unlmtchAlarms Main leaf for alarms MIB to be based from

UNLIMI-TECH-ALARMS-MIB

Alarms are the current central reasons for implementing SNMP at this stage (getters/setters are not implemented).

All traps (SNMPv1) and notifications (SNMPv2c) have the same set of varbinds sent out to help identify the source of the alarm. These correspond to roughly the variable entries in the AlarmBase:

  • Varbind1unlmtchAlrmsAlarmType
  • Varbind2unlmtchAlrmsSeverity
  • Varbind3unlmtchAlrmsSeverityHRF
  • Varbind4unlmtchAlrmsState
  • Varbind5unlmtchAlrmsStateHRF
  • Varbind6unlmtchAlrmsTransactionNumber
  • Varbind7unlmtchAlrmsTimeStamp
  • Varbind8unlmtchAlrmsTimeStampHRF
  • Varbind9unlmtchAlrmsServiceDescr
  • Varbind10unlmtchAlrmsServiceAlias
  • Varbind11unlmtchAlrmsServerIP
  • Varbind12unlmtchAlrmsServerHostname
  • Varbind13unlmtchAlrmsAlarmDescription
OID short Enterprise OID full MIB name Description
1.3.6.1.4.1   enterprises IANA standard for enterprise MIB
enterprises 30640 30640 unlmtchRegMIB IANA definition for Unlimi-Tech
unlmtchRegMIB 2 30640.2 unlmtchAlarms Defined in UNLIMI-TECH-GENERAL- MIB
unlmtchAlarms 1 30640.2.1 unlmtchAlrmsMIB Alarm MODULE-IDENTITY
unlmtchAlrmsMIB 1 30640.2.1.1 unlmtchAlrmsObjects Alarms Object Identifier (varbinds defined)
Varbinds defined below
unlmtchAlrmsObjects 1 30640.2.1.1.1 unlmtchAlrmsAlarmType Readable alarm name
unlmtchAlrmsObjects 2 30640.2.1.1.2 unlmtchAlrmsSeverity Severity of the alarm being dispatched
unlmtchAlrmsObjects 3 30640.2.1.1.3 unlmtchAlrmsSeverityHRF Severity in Human Readable Format
unlmtchAlrmsObjects 4 30640.2.1.1.4 unlmtchAlrmsState Severity of alarm CRITICAL, MAJOR, MINOR, NOTIFICATION
unlmtchAlrmsObjects 5 30640.2.1.1.5 unlmtchAlrmsStateHRF State of the alarm being dispatched in Human Readable Format
unlmtchAlrmsObjects 6 30640.2.1.1.6 unlmtchAlrmsTransactionNumber Unique identifier for an alarmed event. Separate SET and CLEAR traps can be matched up by using Transaction Number.
unlmtchAlrmsObjects 7 30640.2.1.1.7 unlmtchAlrmsTimeStamp Time stamp of the alarm (milliseconds since Jan 1, 1970).
unlmtchAlrmsObjects 8 30640.2.1.1.8 unlmtchAlrmsTimeStampHRF Time stamp in Human Readable Format
unlmtchAlrmsObjects 9 30640.2.1.1.9 unlmtchAlrmsServiceDescr Value will hold a description and a software version number.
unlmtchAlrmsObjects 10 30640.2.1.1.10 unlmtchAlrmsServiceAlias Alias that describes the particular service, configured by the operator
unlmtchAlrmsObjects 11 30640.2.1.1.11 unlmtchAlrmsServerIP IP address of the source agent.
unlmtchAlrmsObjects 12 30640.2.1.1.12 unlmtchAlrmsServerHostname Server hostname
unlmtchAlrmsObjects 13 30640.2.1.1.13 unlmtchAlrmsAlarmDescription Description of the alarm being raised/cleared.
Alarm groupings defined below
unlmtchAlrmsGenTraps 1 30640.2.1.2.1.0.1 unlmtchAlrmsServiceDown Service has become unavailable.
unlmtchAlrmsGenTraps 3 30640.2.1.2.1.0.3 unlmtchAlrmsNodeSyncInProgress Central is downloading usage statistics from the node. Some statistics may be unavailable..
unlmtchAlrmsLicTraps 1 30640.2.1.2.2.0.1 unlmtchAlrmsLicenseInvalid Invalid license has been detected for the service.
unlmtchAlrmsLicTraps 2 30640.2.1.2.2.0.2 unlmtchAlrmsLicenseExpired Expired license has been detected for the service.
unlmtchAlrmsLicTraps 3 30640.2.1.2.2.0.3 unlmtchAlrmsLicenseExpiring Service is operating using a license key that is set to expire shortly.
unlmtchAlrmsLicTraps 5 30640.2.1.2.2.0.5 unlmtchAlrmsUnlicensedCall A third party REST call was made, but the currently active Central license doesn't support third party REST calls.
unlmtchAlrmsSysTraps 1 30640.2.1.2.3.0.1 unlmtchAlrmsPortError For FileCatalyst Server (Legacy) :
Error detected on the service port.

For FileCatalyst Server (v3.7+) :
Central raises an alarm for each enabled FTP port on the server that could not be connected.

unlmtchAlrmsSysTraps 2 30640.2.1.2.3.0.2 unlmtchAlrmsDataPortError Data port errors detected.
unlmtchAlrmsSysTraps 3 30640.2.1.2.3.0.3 unlmtchAlrmsSystemResourceLow System resource warnings or errors have been detected.
unlmtchAlrmsSysTraps 4 30640.2.1.2.3.0.4 unlmtchAlrmsSystemAdminLogin Administrative login event on the system.
unlmtchAlrmsSysTraps 5 30640.2.1.2.3.0.5 unlmtchAlrmsSystemConfigChange Configuration change requested by admin.
unlmtchAlrmsSecTraps 1 30640.2.1.2.4.0.1 unlmtchAlrmsAuthenticationServiceFailure Authentication service (LDAP, ActiveDirectory) is currently unavailable.
unlmtchAlrmsSecTraps 2 30640.2.1.2.4.0.2 unlmtchAlrmsMultipleLoginFailure Multiple consecutive login failures detected for user
unlmtchAlrmsSecTraps 3 30640.2.1.2.4.0.3 unlmtchAlrmsMultipleLoginFailureIP Multiple consecutive login failures detected for IP address
unlmtchAlrmsSecTraps 4 30640.2.1.2.4.0.4 unlmtchAlrmsUserDisabled User disabled due to multiple login failures
unlmtchAlrmsSecTraps 30640.2.1.2.4.0.5 unlmtchAlrmsIPBlocked IP blocked due to multiple login failures
unlmtchAlrmsFCServerTraps 1 30640.2.1.2.5.1.0.1 unlmtchAlrmsConnectionFailure For FileCatalyst Server (Legacy) :
Unable to connect to the main FTP port (default 21)
Users may be experiencing login difficulties.

For FileCatalyst Server (v3.7+) :
Unable to connect to any of the enabled ports on the FileCatalyst Server.
Note: Only FTP and FTPS ports are considered while connecting to enabled ports; SFTP port, if enabled, is ignored.

unlmtchAlrmsFCServerTraps 2 30640.2.1.2.5.1.0.2 unlmtchAlrmsRemoteAdminRedirect Remote Administration port (default 12400) listener has been redirected to another port
unlmtchAlrmsFCServerTraps 3 30640.2.1.2.5.1.0.3 unlmtchAlrmsFileSystemUnavailable FileCatalyst Server is unable to connect to an external File System (ie: Amazon S3) where user data may reside.
unlmtchAlrmsFCServerTraps 4 30640.2.1.2.5.1.0.4 unlmtchAlrmsDirectoryUnavailable On a FileCatalyst Server, a user directory or virtual file/folder is unavailable. On FileCatalyst HotFolder, a hotfolder directory may not be available for transfers.
Verify that the configured path is available to the FileCatalyst product.
unlmtchAlrmsFCHotfolderTraps 1 30640.2.1.2.5.2.0.1 unlmtchAlrmsTransferSuccess File transfer has successfully completed.
unlmtchAlrmsFCHotfolderTraps 2 30640.2.1.2.5.2.0.2 unlmtchAlrmsTransferFailed File transfer has failed.
unlmtchAlrmsFCHotfolderTraps 3 30640.2.1.2.5.2.0.3 unlmtchAlrmsTransferCancelled File transfer has been cancelled by user.

Troubleshooting and Advanced Features

Connecting to the FileCatalyst Central Database

FileCatalyst Central provides the ability to enable external access to its database of transfer information. For more information, please read the “Connecting to FileCatalyst Central Database” document.

Security Settings

Setting Encryption Method

In order to help keep sensitive configuration information secure, the application encodes data in the settings files. The default setting may be overridden to use either a salted AES or a salted DES encryption. To set the value, you must edit your maconfig.conf file. Find the line:

FCMonitoringAgent.config.encoding.format=DEFAULT

Changing the value of this setting to AES, DES, or DEFAULT will cause all encoded values to be re-encoded and saved with the new algorithm. If you are upgrading from a version where encoding did not take place, these values will be encoded and saved.

The default settings are:

                FCMonitoringAgent.config.deployment.security.defaultTransport=TLSv1
                FCMonitoringAgent.config.deployment.security.SSLv2Hello=true
                FCMonitoringAgent.config.deployment.security.SSLv3=false
                FCMonitoringAgent.config.deployment.security.TLSv1=true
                FCMonitoringAgent.config.deployment.security.TLSv1.1=true
                FCMonitoringAgent.config.deployment.security.TLSv1.2=true
                

Supported protocols include:

  • SSLv2Hello
  • SSLv3
  • TLSv1
  • TLSv1.1
  • TLSv1.2

REST API

Enabling REST services

FileCatalyst Central is built upon a powerful REST API. Should you wish to use the REST API directly in building your own applications or widgets, the API documentation is a good starting point.

The REST API provided with FileCatalyst Central is enabled by default.

REST services security

All REST services require user authentication to run them. User credentials are passed in using HTTP headers. There are two ways to pass in user credentials.

  • Using the RESTAuthorization header.

    This HTTP header can be used to pass in user credentials. The user credentials are Base 64 encoded and follow the following format: username:password

    JSON Example assuming the administration username and password is admin:admin

    URL: http://localhost:8080/rs/alarms
    Method: GET
    Accept: application/json
    RESTAuthorization: YWRtaW46YWRtaW4=

    Returned JSON:
    {{"totalRecords":3,"totalFilteredRecords":3,"isListFiltered":false...}}

  • Using the RESTSessionSecret header

    This is the more secured (and recommended) version for using the REST services. At least one call needs to be called using the above mentioned HTTP Header (RESTAuthorization). A POST call to the /rs/AuthorizationSession REST service with the above header and the user credentials in the data content is required to get back a session secret. Once the session secret is known, it can then be used for all subsequent calls using the RESTSessionSecret header. The session secret will be valid for as long as the session stays alive on the server.

    JSON Example assuming username/password is admin/system:

    URL: http://localhost:8080/rs/AuthorizationSession
    Method: POST
    Accept: application/json
    Content-Type: application/json
    RESTAuthorization: YWRtaW46YWRtaW4=

    Content:
    {"authorization":"YWRtaW46YWRtaW4="}

    Returned JSON:
    {"sessionSecret":"796FD3436D2DA6DF0C1928AE1CA0BC0A"}

    JSON Example using RESTSessionSecret:

    URL: http://localhost:8080/rs/alarms
    Method: GET
    Accept: application/json
    RESTSessionSecret: 796FD3436D2DA6DF0C1928AE1CA0BC0A

    Returned JSON:
    {{"totalRecords":3,"totalFilteredRecords":3,"isListFiltered":false...}}

REST services documentation

Documentation on the REST services provided by the Central application can be viewed here

Alternatively, the documentation can be downloaded from here

REST example using Swagger

A sample application for executing REST calls against Central's REST API can be found at the following location.

By using this application, you will be able to view all of the available REST services within the application, as well as examples of responses and requests that a particular call may produce or consume. In addition to these examples, the Swagger application supports the ability to configure REST call and make them directly against the application. Upon executing a REST call, the application will present you with the response for the call, as well as a small CURL example of the request that was made.

SSL

How to install an SSL Certificate

The most recent instructions on how to install an SSL Certificate can be found in our Knowledge Base at http://support.filecatalyst.com/index.php?/Knowledgebase/Article/View/364/0/how-to-install-a-ssl-certificate-in-central.

Frequently Asked Questions and Troubleshooting

1) Where are my logs?

On Window or Linux, the logs can be found in the logs directory in the application's install directory. On OS X, the logs will be found in logs folder of the appropriate application folder in "Library/Application Support/FileCatalyst" for the user running the application, or in the root library if the application is being run as a service. The path to the logs can also be found in the configuration file as log.location.

2) Why am I seeing an UnsupportedClassVersionError?

You are likely trying to run with an unsupported version of Java. FileCatalyst products require a minimum version of Java 1.8

Support

Support System

Visit our support website at https://support.filecatalyst.com to view the knowledge base and to submit a ticket (Available 24/7).

If you have already submitted a Ticket and would like to send us your case files please go to https://support2u.filecatalyst.com to upload them. A valid Ticket ID will be required.

Chat, Email and Phone Support

Live Chat: Visit our website at https://support.filecatalyst.com - Available on Monday to Friday from 7 AM - 7 PM Eastern Time Except for Statutory Holidays

Email: support@filecatalyst.com - Typical response time is one business day

Phone: +1(613) 667-2439 or +1 (877) 327-9387 - Available on Monday to Friday from 7 AM - 7 PM Eastern Time Except for Statutory Holidays