Skip to main content

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​

  1. Copy the installer package to the server

  2. Extract the zip installation package

  3. Open command prompt as an Administrator User and change to the extracted installer directory

cd /path/to/xfp-installer/
  1. Now run the installer
install.bat -d /path/to/jadu/

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...
Running scripts...
Installing Central Forms module config...
Updating java class path...
Updating Readable URLs...
Adding scheduled tasks...
Updating locale settings to match en_GB...
Installation Report.
---
CMS Version: 23.2.1
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.

  1. Copy the release package to the server

  2. Extract the release package (replace {patch-version-number} with the version number of release package)

  3. Stop IIS

  4. Open command prompt as an Administrator User and change to the extracted installer directory

cd {patch-version-number}

  1. Apply the patch by running the Meteor command

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

  2. Start IIS

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

iisreset

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