This topic is for system administrators who plan to install PhixFlow. The pages in this topic describe . It describes how to install a new instance of PhixFlow::
| Child pages (Children Display) | ||
|---|---|---|
|
.
Prerequisites
Before installation starts it is assumed that you have completed you start installing PhixFlow, please complete the steps in completed in Planning your PhixFlow System and that your system meets the . Your IT system must meet the PhixFlow system requirements. 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.
...
Summary Installation Instructions
Tha The pages in this topic guide you through a complete PhixFlow installation. A summary of the steps is:
| Required or recommended | Page with details | Summary |
|---|---|---|
| Required if Java is not already installed | Install Java |
...
| OLD | Download and install Java. |
| Required if Tomcat is not already installed |
...
| Download and install the Apache Tomcat web-application (webapp) server. | |
| Recommended |
...
You are responsible for ensuring all PhixFlow communication is secure.
|
...
to disable HTTP access.
| Warning | ||
|---|---|---|
| ||
Do not run Tomcat as root on Linux as this constitutes a security risk. |
| |
| Recommended | Linux: Install Pound Reverse Proxy |
...
| title | Using default ports on Linux |
|---|
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. The proxy and Tomcat servers must run on a private network or on the same server and the Tomcat server must not be directly accessible to normal users. In this configuration, the reverse proxy runs as root, which allows it:
|
...
|
...
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
...
|
The instructions on this page assume you are setting up a Linux Ubuntu distribution. This solution requires that:
Options for reverse proxy servers are:
| |||||
| Required | Unpack PhixFlow Release Package | If you do not already have the PhixFlow package to install, you can download it from our support FTP site. Please |
...
email support@phixflow.com. Log on to the webapp host and unpack the release package. | |
| Required | Install 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. | ||
| Required | Configure a Keystore and Aliases | Create a keystore for the database credentials and their aliases. Configure the following files to use the keystore:
|
...
| ||
| Optional | MS SQL Server Integrated Authentication | Enable server support for integrated user authentication. |
| Required | Install the PhixFlow Webapp |
...
| Copy the PhixFlow webapp from the unpacked release package into Tomcat and configure it. | |
| Required | Start PhixFlow |
...
| and Configure | Check that the application is running by starting the client and logging in with the username startup and password: Startup. |
...
After Installation
After Once PhixFlow is installed, there are system set-up and configuration tasks:
...
,
...
see
...
- Configure Active Directory Integration: users are authenticated using one or more Active Directory servers in addition to users that are defined locally within the PhixFlow database.
- Configure SAML Integration: map the PhixFlow user groups to user groups in your existing single-sign-on system.
...
Administration for details of the configuration steps required immediately after installation, as well as the ongoing configuration and maintenance tasks.