Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Before you start installing PhixFlow, please complete the steps in Planning your PhixFlow System. Your IT system must meet the PhixFlow system requirements. The instructions in this topic ensure that you In particular, you must have: 

  • installed a database server
  • configured a database instance or schema and the user or login credentials
  • installed a (Linux or Windows) server to act as the web-application (webapp) host.

...

Tha pages in this topic guide you through a complete PhixFlow installation. A summary of the steps is:

...

Required or recommendedPage with detailsSummary
Required if Java is not already installedInstall JavaDownload and install Java.

...

Required if Tomcat is not already installed

Install Tomcat


Download and install the Apache Tomcat web-application (webapp) server.

...

...

For secure communications, you must configure Tomcat to use HTTPS. PhixFlow must be configured:

  • to allow HTTPS connections to the webapp
  • to disable HTTP access.

...

Recommended

...

titleTomcat on Linux

...

Do not run Tomcat as root on Linux as this constitutes a security risk.

...

titleUsing default ports on Linux

Windows: Microsoft blog post about IIS as a reverse proxy

If you want to make your web server visible on the default ports (e.g. on Linux, http: 80, https: 443

...

) we recommend that you use a reverse proxy to terminate the HTTPS session and to forward web requests using HTTP to the Tomcat server. 

In this configuration, the reverse proxy runs as root, which allows it to use privileged ports (up to 1000), and forwards requests to the web server which runs as a non-privileged user (normally 'tomcat'), on non-privileged ports (above 1000)

...

. This solution requires that:

  • the proxy and Tomcat servers run on a private network or on the same server

  • and that the Tomcat server is not directly accessible to normal users

...

On Linux, use Pound as a reverse proxy.

On Windows servers, you can use IIS as a reverse proxy

...

...

If you do not already have the PhixFlow package to install, you can download it from our support FTP site. Please contact PhixFlow Support for details.

Logon to the webapp host and unpack the release package.

RequiredInstall the PhixFlow Database Schema

...

Create a database user and tables. Populate the tables with initial configuration data and set the customer name.

...

 

See also the details in Database URLs.

OptionalSQLServer Integrated Authentication

...

Enable server support for integrated user authentication.
RequiredInstall PhixFlow Webapp

...

Copy the PhixFlow webapp from the unpacked release package into Tomcat and configure it.
RequiredStart PhixFlow on the Client

...

Check that the application is running by starting the client and logging in with the username startup and password: Startup.



Warning
titleTomcat on Linux

Do not run Tomcat as root on Linux as this constitutes a security risk.

System Configuration After Installation

After PhixFlow is installed, there are system set-up and configuration tasks:

...