Installing Zulu
Installation: Installing the plugin on your FileMaker Server
Servlet rather than a "plugin"
Zulu was introduced as both a traditional server-side plugin and as a small application (a servlet) for FileMaker Server. Newer versions of Zulu are only available as servlets because these offer a lot more configuration options. If you are currently running Zulu as a plugin, please uninstall the plugin and download the latest version of Zulu from the 360Works store 360Works Zulu
To install the servlet, simply run the Windows Installer or Mac Installer that came packaged with your Zulu download.
Standard Installation
Prerequisites
- Be sure FileMaker Server is installed and running with XML Custom Web Publishing enabled.
Installation Steps
Run the installer downloaded from the Zulu product page
Custom Installation
Manual Installation
Users who need a more customized solution may need to perform a manual installation of the Zulu software. Zulu runs on your server as an Apache Tomcat application; therefore, it will run alongside the Web Publishing engine using the existing Tomcat instance installed by FileMaker Server or you can download and install the Apache Tomcat server application for your operating system to run Zulu in a standalone Tomcat Server (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).
Zulu can be installed into the Web Publishing Engine. This is the easiest installation method to configure, and is easily redirected to port 80. Alternatively, you may install Zulu in a standalone Tomcat server of your choice. This option is available if you do not want to modify the Web Publishing Engine or if you need further customization.
Installing in the FileMaker Server Web Publishing Engine
Prerequisites
- Be sure FileMaker Server is installed and running with XML Custom Web Publishing enabled.
Installing Zulu
- Copy the Zulu.war file from the Installer Data folder into the jwpc-tomcat folder located at
FileMaker Server/Web Publishing/publishing-engine/jwpc-tomcat/
(a Zulu folder will be created automatically when the .war file is dropped in place). - Now you should be able to access the Zulu sync admin splash page by visiting
http://localhost:16020/zulu
verify that you are able to successfully access this page. - (FMS13) Back in the jwpc-tomcat folder, navigate to
jwpc-tomcat/zulu/META-INF/
and edit the context.xml - (FMS12) Back in the jwpc-tomcat folder, navigate to
jwpc-tomcat/conf/Catalina/localhost/
and edit the zulu.xml- Specify your username and password on these two lines of the
zulu.xml/context.xml
file:<Parameter name="zulu.adminUsername" value="" override="false" />
<Parameter name="zulu.adminPassword" value="" override="false" />
- Specify your username and password on these two lines of the
URL Redirection
NOTE: These instructions apply only to users installing inside the FMS13 Web Publishing Engine.=====Windows===== FileMaker Server uses the URL Rewrite module of IIS to redirect traffic from standard web traffic through port 80 to our default HTTP Tomcat port 42424 (or port 16020 if installed in the FMS WPE).
- Launch the IIS Manager, expand the Sites folder, then click on the FMWebSite site. You will see a collection of modules in the center pane of IIS Manager.
- Double click the module that reads
URL Rewrite.
- In the right hand pane, click
Add Rule(s)
at the very top of the list of actions. - From here, choose
Blank rule
and press OK - Set up the rule to match the pattern for the requested URL using regular expressions.
- Set the pattern as
^zulu(.*)
- Scroll down to the action section and be sure the action type is set to
Rewrite
- Set the Rewrite URL as
http://localhost:42424/zulu{R:1}
- Be sure
Append query string
andStop processing of subsequent rules
are both checked, then apply the settings. - Go to the ARR proxy settings (they're hidden under IIS -> Application Request Routing Cache -> Server Proxy Settings) and uncheck the "Reverse rewrite host in response headers" checkbox.
- Finally, test the the zulu URL in your browser (http://localhost/zulu)
Mac
If Zulu is installed in it's own instance of Tomcat (Default Installation)
- Navigate to
FileMaker Server/HTTPServer/conf/
and open thehttpd.conf
file with a text editor. You will need elevated permissions to modify this file. - Add these lines to the end of the
httpd.conf
file:ProxyPass /zulu ajp://127.0.0.1:42423/zulu retry=1 timeout=7200
- Save the file back to its original location.
If Zulu is installed inside the FileMaker Web Publishing Engine
- Navigate to
FileMaker Server/Admin/admin-helper/WEB-INF/conf/
and open themod_proxy.conf
file with a text editor. You will need elevated permissions to modify this file. - Add these lines to the end of the
mod_proxy.conf
file:ProxyPass /zulu ajp://127.0.0.1:16021/zulu retry=1 timeout=7200
- Save the file back to its original location.
Now Apache needs to be restarted, but we need to be sure to restart Apache with the FMS13 configuration.
- Open a terminal window and enter
cd "/Library/FileMaker Server/HTTPServer/bin"
and press return. - Enter this command to restart Apache (you will need to enter your system password when prompted):
sudo ./httpdctl graceful
- Test the Zulu URL in your browser (http://localhost/zulu)
Using Filemaker Server 11?
Navigate to:
- Windows: Program Files/360Works/Application/webapps/Zulu/META-INF/context.xml
- Mac: Library/360Works/Application/webapps/Zulu/META-INF/context.xml
- Copy the context.xml file to your desktop, leaving a copy inside the META-INF folder (This is important. if there is no context.xml file in this location, Tomcat does not react well, and may require reinstallation)
- In the desktop copy of the context.xml, remove the port number from this line:
- Parameter name="jdbc.host" value="127.0.0.1:16020" overide="false"
- So that it reads:
- Parameter name="jdbc.host" value="127.0.0.1" overide="false"
- Now, drop the context.xml file back into the META-INF directory, use the "Replace" option to replace the old context.xml
- Restart Tomcat, follow the instructions here: Restart_tomcat
- Try and publish to confirm the issue is fixed.
Using Filemaker Server 14?
When installing Zulu for FMS 14, there is one modification you have to make.
Navigate to:
- Windows: Program Files/360Works/Application/webapps/Zulu/META-INF/context.xml
- Mac: Library/360Works/Application/webapps/Zulu/META-INF/context.xml
- Copy the context.xml file to your desktop, leaving a copy inside the META-INF folder (This is important. if there is no context.xml file in this location, Tomcat does not react well, and may require reinstallation)
- In the desktop copy of the context.xml, remove the port number from this line:
- Parameter name="jdbc.host" value="127.0.0.1:16020" overide="false"
- So that it reads:
- Parameter name="jdbc.host" value="127.0.0.1" overide="false"
- Now, drop the context.xml file back into the META-INF directory, use the "Replace" option to replace the old context.xml
- Restart Tomcat, follow the instructions here: Restart_tomcat
- This is necessary to compensate for a change in port number when communicating with the Filemaker Web Publishing Engine in Filemaker 14
Alternative - Installing in a standalone Apache Tomcat Server
Prerequisites
- 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
- 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" />
- Specify your username and password on these two lines of the
- If necessary for your configuration, set up URL forwarding from IIS / Apache to your Tomcat connectors. See Tomcat documentation on how to do this.
Next Steps
Serve the Sample File
Confirm your installation and see Zulu at work by serving the Zulu Sample File on your server. You'll want to do this before adding Zulu to your own file.
Troubleshooting
"Mac Installer.pkg" can't be opened because it was not downloaded from the Mac App Store
Option 1
If a user has a high security setting for downloaded apps, when the Zulu installer is run, the following prompt is displayed:
Older OS's might display the warning:
.app is damaged and should be moved to trash
The quickest way around this is to right-click the installer, and select Open
The new prompt will show an "OK" button that will allow the app to be installed.
Option 2
The other way to solve this is to set your security preferences to allow apps to be downloaded from "Anywhere"
Open up System Preferences, and browse to Security, and select the General Tab.
Now Allow Apps Download From Anywhere: