Installing Zulu 3

From 360Works Product Documentation Wiki
(Difference between revisions)
Jump to: navigation, search
(Custom Installation)
Line 17: Line 17:
  
 
=Custom Installation=
 
=Custom Installation=
Users who need a more customized solution may choose to perform a manual installation of the Zulu 2 software. Zulu 2 runs on your server as an Apache Tomcat application, so you will need to download and install the Apache Tomcat server application for your operating system. (this may involve setting Tomcat up to start automatically with your system, as well as configuring your web server to forward traffic for Zulu to port 80). '''Installing Zulu inside the FileMaker Server Web Publishing Engine is no longer supported.'''
+
Users who need a more customized solution may choose to perform a manual installation of the Zulu 3 software. Zulu 3 runs on your server as an Apache Tomcat application, so you will need to download and install the Apache Tomcat server application for your operating system. (this may involve setting Tomcat up to start automatically with your system, as well as configuring your web server to forward traffic for Zulu to port 80). '''Installing Zulu inside the FileMaker Server Web Publishing Engine is no longer supported.'''
  
 
=====Prerequisites=====
 
=====Prerequisites=====
Line 26: Line 26:
 
* Start up Tomcat (this usually happens automatically when using the installer, otherwise you will need to run the Catalina shell script with a 'start' command).
 
* Start up Tomcat (this usually happens automatically when using the installer, otherwise you will need to run the Catalina shell script with a 'start' command).
  
=====Installing Zulu 2=====
+
=====Installing Zulu 3=====
 
* Copy the Zulu.war file from the Installer Data folder into the <code>$TOMCAT_HOME/webapps</code> folder in your Tomcat instance.
 
* Copy the Zulu.war file from the Installer Data folder into the <code>$TOMCAT_HOME/webapps</code> folder in your Tomcat instance.
 
* (Tomcat 6) Modify the <code>zulu.xml</code> file located in the <code>$TOMCAT_HOME/conf/Catalina/localhost/</code> folder.
 
* (Tomcat 6) Modify the <code>zulu.xml</code> file located in the <code>$TOMCAT_HOME/conf/Catalina/localhost/</code> folder.

Revision as of 22:26, 10 January 2019

Contents

Standard Installation

Prerequisites
  • Check your Java version to make sure you are running at least Java 6
  • Be sure FileMaker Server is installed and running with XML Custom Web Publishing enabled.
  • Zulu expects to be installed on the same machine as FileMaker Server. If you are running Zulu on a different machine, see Customizing Zulu
Installation Steps
  • Unzip the package downloaded from the Zulu product page.
  • Run the installer provided in the package.
  • Follow the installer prompts, entering a username and password when prompted. (this is your sync admin password, write it down!)
Post Installation
  • Register Zulu when the Welcome Page launches. (if you're using other 360Works products, and would like to try the demo license, simply restart the Tomcat Application Server using the 360Works Admin tool.
Troubleshooting

Having trouble installing? For more detailed instructions, check out the Troubleshooting Installation section.

Custom Installation

Users who need a more customized solution may choose to perform a manual installation of the Zulu 3 software. Zulu 3 runs on your server as an Apache Tomcat application, so you will need to download and install the Apache Tomcat server application for your operating system. (this may involve setting Tomcat up to start automatically with your system, as well as configuring your web server to forward traffic for Zulu to port 80). Installing Zulu inside the FileMaker Server Web Publishing Engine is no longer supported.

Prerequisites
  • Check your Java version to make sure you are running at least Java 6
  • Be sure FileMaker Server is installed and running with XML Custom Web Publishing enabled. (FMS does not need to necessarily run on the same machine as Zulu, but is required for Zulu to function.)
  • Download and install Apache Tomcat 6.x or 7.x from http://tomcat.apache.org, for Windows make sure to download the installer
  • Follow Tomcat documentation for running Tomcat as server, for Windows make to make the service selection during installation
  • Start up Tomcat (this usually happens automatically when using the installer, otherwise you will need to run the Catalina shell script with a 'start' command).
Installing Zulu 3
  • Copy the Zulu.war file from the Installer Data folder into the $TOMCAT_HOME/webapps folder in your Tomcat instance.
  • (Tomcat 6) Modify the zulu.xml file located in the $TOMCAT_HOME/conf/Catalina/localhost/ folder.
  • (Tomcat 7) Modify the context.xml file located in the $TOMCAT_HOME/webapps/zulu/META-INF/ folder.
    • Specify your username and password on these two lines of the zulu.xml file:
      • <Parameter name="zulu.adminUsername" value="" override="false" />
      • <Parameter name="zulu.adminPassword" value="" override="false" />
  • If necessary for your configuration, set up URL forwarding from IIS / Apache to your Tomcat connectors. See Tomcat documentation on how to do this.

Troubleshooting Installation

Personal tools
Namespaces

Variants
Actions
Plug-in Products
Other Products
Navigation
Toolbox