Installing a Windows server

warning

Before you begin the installation, please ensure that you have a working Jadu Central installation and have installed all prerequisites before installing forms configuration.

note

All commands need to be run with Administrator privilege, as escalated privileges are required.

Install

Copy the installer package to the server
Extract the zip installation package
Open command prompt as an Administrator User and change to the extracted installer directory

cd /path/to/xfp-installer/

Now run the installer

./install.bat -d /path/to/jadu/

You will be prompted if you want to install Jadu Central forms as a standalone product, entering y at this prompt will disable the publishing capabilities of Jadu Central.

Do you want to install standalone XForms Professional? [y/N]:

If no errors occurred during installation, you should see an output similar to the following:

Checking prerequisites are installed...
Installing database...
Loading SQL from C:/Users/Administrator/Desktop/xfp-installer/shared/schema.legacy.sql
Loading SQL from C:/Users/Administrator/Desktop/xfp-installer/shared/schema.sql
Loading SQL from C:/Users/Administrator/Desktop/xfp-installer/shared/data.sql
Copying files...
Installing XForms Professional module config...
Updating java class path...
Updating Readable URLs...
Adding data retention schedule task...
Installing XForms Professional search...
Updating module page tabs...
Updating local settings to en_GB...
Do you want to install standalone XForms Professional? [y/N]: N
Installation Report.
---
CMS Version: 21.0.0
Config Directory: C:/inetpub/wwwroot/jadu/config
---
Exec: Yes
Java: Yes
Suhosin: No
---
Setting permissions...
Detected service username as: jadu_svc
Installation complete
Please apply a Meteor patch for the latest Jadu Central version.

Patch

To complete the install you must patch up to the latest Jadu Central version.

Copy the release package to the server
Extract the release package (replace {patch-version-number} with the version number of release package)
Open command prompt as an Administrator User and change to the extracted installer directory

cd {patch-version-number}

Apply the patch by running the Meteor command

php -d memory_limit=512M meteor.phar patch:apply --path=/path/to/jadu

Update web.config

Resolve conflict in web.config rewrite rules. Open web.config file located in C:/path/to/jadu/public_html/ in a text editor.

Locate the first rewrite element (around lines 16 to 27)

    <rewrite>
      <rules>
        <rule name="Jadu XFP Frontend" stopProcessing="true">
          <match url="^(xfp)/" ignoreCase="false"/>
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true"/>
            <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true"/>
          </conditions>
          <action type="Rewrite" url="app.php/{R:0}"/>
        </rule>
      </rules>
    </rewrite>

Copy the rule element and then delete the first rewrite element

        <rule name="Jadu XFP Frontend" stopProcessing="true">
          <match url="^(xfp)/" ignoreCase="false"/>
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true"/>
            <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true"/>
          </conditions>
          <action type="Rewrite" url="app.php/{R:0}"/>
        </rule>

Add the copied rule to the start of the second rewrite element

      <rewrite>
        <rules>
          !! ADD HERE !!
          <rule name="RewriteAll" stopProcessing="true">
            <match url="^(.*)$" ignoreCase="false"/>
            <conditions logicalGrouping="MatchAll">
              <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true"/>
              <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true"/>
            </conditions>
            <action type="Rewrite" url="app.php" appendQueryString="true"/>
          </rule>
          <rule name="AvoidDuplicate" stopProcessing="true">
            <match url="^app/.php(?:/(.*)|$)" ignoreCase="false"/>
            <action type="Redirect" redirectType="Permanent" url="{R:1}"/>
          </rule>
        </rules>
      </rewrite>

Your final web.config should be similar to

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <modules runAllManagedModulesForAllRequests="true">
      <add name="JaduUrlRewriter" type="JaduUrlRewriter.RewriterModule"/>
    </modules>
    <httpProtocol>
      <customHeaders>
        <add name="X-Frame-Options" value="SAMEORIGIN"/>
      </customHeaders>
    </httpProtocol>
    <httpErrors>
      <remove statusCode="404" subStatusCode="-1"/>
      <error statusCode="404" path="/404.php" responseMode="ExecuteURL"/>
    </httpErrors>
  </system.webServer>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <defaultDocument enabled="true">
        <files>
          <add value="app.php"/>
        </files>
      </defaultDocument>
      <rewrite>
        <rules>
          <rule name="Jadu XFP Frontend" stopProcessing="true">
            <match url="^(xfp)/" ignoreCase="false"/>
            <conditions logicalGrouping="MatchAll">
              <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true"/>
              <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true"/>
            </conditions>
            <action type="Rewrite" url="app.php/{R:0}"/>
          </rule>
          <rule name="RewriteAll" stopProcessing="true">
            <match url="^(.*)$" ignoreCase="false"/>
            <conditions logicalGrouping="MatchAll">
              <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true"/>
              <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true"/>
            </conditions>
            <action type="Rewrite" url="app.php" appendQueryString="true"/>
          </rule>
          <rule name="AvoidDuplicate" stopProcessing="true">
            <match url="^app/.php(?:/(.*)|$)" ignoreCase="false"/>
            <action type="Redirect" redirectType="Permanent" url="{R:1}"/>
          </rule>
        </rules>
      </rewrite>
    </system.webServer>
  </location>
</configuration>

Save web.config and restart IIS in command prompt run

issreset

Once complete, the server will contain a working copy of Jadu Central forms.

Install​

Patch​

Update web.config​

Install

Patch

Update web.config