Live Chat Software by Kayako |
Knowledgebase : Product Technical Support > FileCatalyst Central
|
(8)How To's
|
OVERVIEW
The contents of the log files can be invaluable in helping to diagnose
many of the common issues that affect a FileCatalyst installation.
While not always definitive they are an invaluable resource when
looking for the source of an issue. Logs are commonly found within
the install folder of the product under the folder Logs. (for an
overview of log locations see: FileCatalyst Direct Suite Log
Locations by Product -
http://support.filecatalyst.com/index.php?/Knowledgebase/Article/Vi...
Overview
FileCatalyst Central has two types of User Accounts, these accounts
are an Admin level and User level. Both accounts store their username
and password in the FileCatalyst Central configuration file. Passwords
for both accounts are not visible in clear text and are converted to a
hash value, however, the account names are visible in clear text. The
configuration file is not accessible to anyone who does not have
access to the filesystem where FileCatalyst Central is installed. The
Admin...
OVERVIEW
The FileCatalyst Direct Suite has the ability to specify a version of
the Java Runtime Environment to use when launching the application as
a service. Some common issues that are reported to the Support Team
are:
* Application stalls.
* Abnormal service termination.
* The application does not launch or exits abruptly.
* Windows Service Manager Error 1067: "_The process terminated
unexpectedly"_.
The FileCatalyst Server, HotFolder and Central deployments can be
installed as ...
OVERVIEW
Setting the JAVA_HOME path in the environmental variables on the
Windows local machine.
ENVIRONMENT
Windows Environment.
Java v7.0 JDK or JRE.
RESOLUTION
* Open the _System Properties. _Right click on MY COMPUTER and click
PROPERTIES.
* Click ADVANCED SYSTEM SETTINGS on the left side.
* Hit ADVANCED TAB on the top menu and click on the ENVIRONMENT
VARIABLES button.
* Go to _System Variables _section, find the _PATH_ variable,
highlight it and click EDIT.
* Add the ...
OVERVIEW
This is a known issue with our Development Team and has been fixed in
FileCatalyst Hotfolder v3.5 and FileCatalyst Central v3.5.
Original Issue:
When connecting a FileCatalyst HotFolder v3.4 or v3.4.2 to
FileCatalyst Central, the following message appears:
_HotFolder is Connected to Central but is not Licensed for Alarms_
In addition, the FileCatalyst HotFolder raises two alarms in
FileCatalyst Central for each connected HotFolder:
- LicenseExpired (critical)
- LicenseExpiri...
OVERVIEW
If you run into issues while using a FileCatalyst Web Application
(such as Workflow, Central, and TransferAgent) or certain Unlimi-Tech
transfer applets, there are two important reasons for knowing how to
view and understand the JavaScript console:
* The support team may ask for additional information, such as the
errors being reported.
* To spot any errors you may have introduced in a configuration
file.
ENVIRONMENT
FileCatalyst Workflow v4.9.4 and later.
FileCatalyst Tran...
OVERVIEW
Behaviour:
Trying to open the FileCatalyst Central Administration page results in
Central encountering a 500 error in the web browser. This occurs after
installation of Java Version 8 Update 91 or higher on Linux or Windows
Environments. MAC OSX users are unaffected by this update of Java 8.
Exception:
_org.apache.jasper.JasperException: Unable to compile class for JSP: _
_An error occurred at line: 1 in the generated java file_
_The type java.io.ObjectInputStream cannot be res...
OVERVIEW
This article describes how to update the .jar files in FileCatalyst
Central to remedy the Java Application Blocked message that
Administrators receive when trying to launch the Remote Admin Applet
in Central.
The Java message or pop-up is generated from a failed check for a
security certificate. Our web based Java Applets and Applications are
signed for 2 years from the date of the build. For the purposes of
this article, any FileCatalyst Application connecting to FileCatalyst
Centr...
OVERVIEW
This article will outline how to force FileCatalyst Central to
redirect all traffic to use an HTTPS connection.
ENVIRONMENT
FileCatalyst Central v3.6 and later.
RESOLUTION
To force a redirect of all traffic to HTTPS automatically, we need to
edit the _web.xml_ file.
* Shutdown the FileCatalyst Central Service.
* Open the WEB.XML file in a text editor. It is located in _//__FileCatalyst Central/www/Web
Console/WEB-INF/._
A sample path in th...
OVERVIEW
There is a known issue with Firefox's implementation of Java, whereby
if you attempt to simultaneously launch multiple identical Remote
Administration applets from within Central, each instance will show
the UI of the first applet launched.
For example:
You have two FileCatalyst HotFolders with identical build numbers.
They are both connected to FileCatalyst Central.
Navigate to the Nodes page and reveal the HTML UI for the first node
(by clicking its name in the table), and then cli...
OVERVIEW
When you use Java 7 to run the FileCatalyst HotFolder, it can not
delete a task from the HotFolder Web Admin UI. This issue was observed
when using the FileCatalyst HotFolder Web Admin through FileCatalyst
Central or connecting directly to the FileCatalyst HotFolder
deployment.
This issue is only present in Java 7 RE and Java 7 DK.
Environment
Oracle Java 7
FileCatalyst HotFolder v3.7.1 and newer.
Resolution
The best solution would be to upgrade the Java deployment on the
Operating...
OVERVIEW
With the release of File Catalyst Direct 3.0.1, Central will provide
the ability to enable external access to its database of transfer
information.
First, a little basic information: Central uses a Derby database to
store its data. This means that whatever tool you are planning on
using to access the database will need to be able to interact with
Derby. In order to do this, the tool must be able to use the Apache
Derby Client driver (http://db.apache.org/derby
[http://db.apache.org/...
Overview
According to the knowledge base article here
[https://en.avm.de/service/fritzbox/fritzbox-7390/knowledge-base/publication/show/663_No-DNS-resolution-of-private-IP-addresses/], "A
computer in the FRITZ!Box home network (192.168.178.29) cannot access
a web server on the same home network because the DNS request for this
web server (my_domain.de) is answered with an IP address in the same
home network (192.168.178.20)."
"For security reasons, the FRITZ!Box suppresses DNS responses that...
OVERVIEW
This article will give a quick walkthrough on the generation of a
Certificate Signing Request (CSR) and Private Key file which will be
used in FileCatalyst Server, Central, and HotFolder.
ENVIRONMENT
OpenSSL
Windows OS
Resolution
Install OpenSSL:
* Download the OpenSSL installer from one of the mirrors located
at https://wiki.openssl.org/index.php/Binaries
[https://wiki.openssl.org/index.php/Binaries]. The example install
directory referenced in this article is C:OPENSSL.
...
OVERVIEW
This article will provide a quick walkthrough of the installation of
an SSL Certificate in FileCatalyst Central.
With our most recent release of FileCatalyst Central v3.7.2, we have
replaced the embedded Tomcat Web Server which is used to serve up the
Central deployment with the Grizzly Web Server. With this new
implementation, we will be using this internal web server in all our
product lines. Depending on your starting point you can jump down in
the article to different guides whic...
OVERVIEW
Every instance that is deployed on Amazon EC2 must have Firewall and
specific ports configured. By default, most of the ports that are
needed are not open for TCP or UDP connections. The FileCatalyst
Server, FileCatalyst Workflow, and FileCatalyst Webmail deployments
all need to have their respective ports opened for connectivity and
data transfer.
This article will walk you through a typical security group setup for
an Amazon EC2 instance.
The default ports for FileCatalyst Direc...
OVERVIEW
Every FileCatalyst application that runs, whether it is a service or
in stand-alone mode has a Process ID (PID) associated with it when it
launches.
A Heap Dump is a snapshot of the memory of a Java Process. The
snapshot contains information about the Java objects and classes in
the heap at the moment the snapshot is triggered. Our developers can
use this information to analyze the root cause of failures.
This article will explore a command line method which can be used on
Linux, W...
OVERVIEW
There are few folders which reside within FileCatalyst applications
such as logs and diagnostic that should be cleaned up periodically.
This will prevent the local disk from being filled up and causing
service interruptions. In Linux environments, you have the ability to
set up cronjobs to delete files and folders that are not needed and
taking up some disk space. This article will give you sample crontab
entries to clean up log folders.
Environment
FileCatalyst Direct v3.4 and later.
...
Overview
Clients who upgrade FileCatalyst Central to v3.7.3 build 22 may
experience nodes not coming online after the upgrade. Central uses a
field called Listener IP which is set on various nodes (FileCatalyst
Server, TransferAgent and HotFolder). This address is used to connect
the node to your Central deployment.
In the latest release of Central, we have corrected a known issue
which impacts the Listener IP field and could pose as a product
defect. For example, you have multiple IPs on the...
Overview
The following article describes how to perform an upgrade of
FileCatalyst Central on Windows, Mac OSX and Linux platforms.
Please note this document does not apply to any versions of
FileCatalyst Central below 3.4.
Click on the links below to view the individual guide based on your
Operating Systems:
* How To Upgrade FileCatalyst Central in a Windows Environment
* How To Upgrade FileCatalyst Central in a Linux Environment
Environment
FileCatalyst Central v3.4 and later.
RESOL...
OVERVIEW
First, what is a diagnostic report?
Using tools within Java we capture the current state of the Java
Virtual Machine at a very low level.
This allows our developers to examine what is occurring within the
memory, which internal (Java) components are open and how long they
have been, among many other things.
These are all captured among our logs into a zip file.
Most of our FileCatalyst products that have a User Interface have a
"DIAGNOSTIC REPORT" button on the "ABOUT FILECATALYST" po...
OVERVIEW
All of our FileCatalyst Products are installed with default memory
limits, including both initial reserve and maximum memory. However,
these can be configured to fit your specific needs and environment.
This article will go through the configuration process for each
FileCatalyst Product for Windows, Linux, and Mac OSX
NOTE:
* For all environments:
If you are using a 32-bit Operating System or Java 32-bit, the maximum
memory you can define for Java is limited to 1.5GB of memory...
OVERVIEW
The following instructions are provided as a guide to installing Java
onto a system for use with FileCatalyst the JAVA API,
SDK and CLI which do not have an embedded Java Runtime Environment
and require one to run.
On Windows, Linux and OSX, many FileCatalyst v3.8 products (HOTFOLDER,
SERVER, TRANSFERAGENT and CENTRAL) _do not need_ Java installed
separately as a JRE (Amazon Corretto Java 8) is already pre-packaged
in these applications.
Implementation notes:
* Windows
* MacO...
OVERVIEW
The FileCatalyst Suite of products can leverage cloud resources
supplied by Amazon AWS. Using EC2 Instances, users are able to create
and deploy our software on many different versions of Windows and
Linux Operating Systems. You will need to consult Amazon AWS for their
Cloud Services Pricing.
The products in the FileCatalyst Direct Suite can be downloaded
directly from our Download Page. To access the page, you will need
credentials which can be obtained from your FileCatalyst Sale...
OVERVIEW
Logs are one of the critical pieces of information requested by
FileCatalyst Support. Below is a list of those viewed as most useful
from a support perspective and their default locations. If support has
requested logs for a given event please remember that they are rotated
every 24 hours at the time set in the configuration file and archived
with the dates shown in the name.
The default location is dictated by the O/S version and is established
during the initial install. If the Fi...
OVERVIEW
A recent update to the Firefox framework introduced behaviour where
the sessionStorage information no longer persists across new tabs
created by our web applications. For example, new tabs are created
with the activity views and Server log pages. Because of the new lack
of persistence, our web applications experience issues when attempting
to authenticate WebSocket connections with the underlying WebServers.
These issues cause the customer's pages to properly load, which then
leads to ...
OVERVIEW
This article will give a quick walkthrough of the installation or
upgrade of an SSL Certificate with the generation of a Certificate
Signing Request (CSR) into FileCatalyst Central.
These instructions assume you acquired your certificate from Thawte
and that steps from another provider may differ. In step 4 of the
resolution, the resulting file will be a self-signed .keystore file.
This can also be used in place of a Trusted SSL Certificate but it is
not recommended as a best practi...
OVERVIEW
With the release of FileCatalyst Central v3.7.3, we have added the
ability to add and customize the Java Cipher Suite usage. This article
will outline the steps needed to use custom Java Ciphers in Central.
If you have upgraded from an older version of Central (
OVERVIEW
Most FileCatalyst Applications can be run in a headless Linux
environment and registered as a system service. In older versions of
Ubuntu the service for the application was started and stopped using:
service start/stop/status
Between Ubuntu v16 and v18, the underlying system completely migrated
over to using systemctl rather than service commands to control
services. Our service installation/uninstallation scripts have been
updated for v3.8.
This is still an issue...
Overview
FileCatalyst Central is our node management tool which will receive
transfer records from nodes and store the data in our local database.
When an instance of Central has a combination of many nodes, high
traffic and/or reports being generated, users will find that the
response time from Central will be increased.
When any of the tasks mentioned above are being processed
simultaneously there will be a larger hit on the CPU consumption. This
article will show you how to increase the nu...