Zulu - Installation

From 360Works Product Documentation Wiki
(Difference between revisions)
Jump to: navigation, search
Line 12: Line 12:
 
=====Post Installation=====
 
=====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.
 
* 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.
* Zulu uses the XML Web Publishing engine.  See more about enabling that, and allowing accounts to use XML here: [[Configure XML Web Publishing]]
+
* Zulu uses the XML Web Publishing engine.  See more about enabling that, and allowing accounts to use XML here: [[Enable XML FileMaker 17]]
  
 
=====Troubleshooting=====
 
=====Troubleshooting=====

Revision as of 19:38, 11 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 Zulu - Advanced Settings
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.
  • Zulu uses the XML Web Publishing engine. See more about enabling that, and allowing accounts to use XML here: Enable XML FileMaker 17
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

Can not access the Zulu admin page

The Zulu admin page should be accessible using the url First, check whether Zulu is running. On the machine where Zulu is installed, go to the below url. This will bypass the any firewalls or web servers in the way:

http://localhost:42424/zulu

If you can see the admin page, Zulu is running, web server configuration may have been removed, or a firewall is blocking the port. Common If you have installed or updated FileMaker Server after installing Zulu, the FileMaker Installer will clear out the web server configurations that Zulu sets up. To get these back, just re-run the Zulu installer.

If you can't see the admin page, Zulu is down. Try running the installer again to bring it back up. If that still does not work, contact 360Works support - support@360works.com

Shell execution failed. Verify that Java is installed and run setup again.

This error means that the installer did not find a suitable Java installation. Download and install Java 8 from here: Java 8 Downloads. After that is installed, run the installer again and see if the issue persists.

Could not configure web server forwarding because of an error

This error occurs when the installer could not communicate with the web server. Usually when you see this error message, Zulu has been successfully installed, but was unable to set up a rewrite with the web server. To see if Zulu was successfully installed, open this url in a browser and see if the admin console comes up:

http://localhost:42424/zulu

If you do not see the admin page, another issue has occurred, and you should contact 360Works support at support@360Works.com.

If the admin page loads correctly, then your web server is the problem. This means that Zulu is up and running, but you will need to access it over port 42424. If you require that Zulu be accessed over the standard ports, you will need to get your web server to cooperate. Here are some things you can try:

  • If FileMaker server is also installed on this machine, you can restart the webserver with this command line command:
fmsadmin restart httpserver -y
  • If FileMaker Server is not installed on this machine, you will need to configure your own web server
Personal tools
Namespaces

Variants
Actions
Plug-in Products
Other Products
Navigation
Toolbox