Skip to Content

Upgrade App Builder on Microsoft Windows (x64)

Introduction

To upgrade to App Builder on Microsoft Windows, satisfy the system requirements for each server, then follow the steps in these sections:

  1. Get and unpack the software.

  2. Configure IIS.

  3. (Optional) Enable Crystal Reports.

  4. Test and run.

Prepare

  1. Stop IIS:

    1. Enter the IIS Manager.

    2. Select the web server.

    3. Click the Stop button at the top right of the Actions pane.

  2. Backup your databases.

  3. Make copies of the following:

    • Connection.xml file.

    • appsettings.json file.

    • Keys directory.

Get and unpack the software

To get the App Builder software, follow these steps:

  1. Contact your Customer Success Manager (CSM) to get a copy of the App Builder 4.0 software.

  2. The App Builder software is provided as a compressed file with the name AppBuilder-VER.zip, where VER is the version number. Copy or move it to the host where IIS runs.

    Tip

    Depending on your system's security settings, you may need to unblock the file. To do this, right-click on the file, then select Properties. In the Properties dialog, select the Security tab, then select Unblock.

  3. In the IIS default physical root folder (usually C:\inetpub\wwwroot\), create a sub-folder for App Builder. (For example, C:\inetpub\wwwroot\AppBuilder.)

  4. Unzip the contents of the downloaded .zip file into this folder.

Configure

  1. Open the IIS Manager.

  2. Expand the App Builder folder.

  3. Right click the data folder and choose the Edit Permissions... option.

  4. Select the Security tab.

  5. Click the Edit button to launch the Permissions for data dialog box.

  6. Click the Add... button to launch the Select Users or Groups dialog box.

  7. Provide the name IIS AppPool\App Builder in the bottom field.

  8. Check Allow Full Control in the Permissions field, then click the OK button to close the Permissions for data dialog box.

  9. Click the OK button to close the data Properties dialog box.

  10. Repeat steps 3-9 for the logs and keys directories as well.

  11. Restart IIS by selecting the server and clicking the Start button in the Actions pane.

(Optional) Enable Crystal Reports

App Builder supports Crystal Reports on Windows systems. Crystal Reports is hosted out-of-process in a COM server. To register the Crystal Reports COM server, open a Windows PowerShell as an administrator, then run these commands:

Set-ExecutionPolicy RemoteSigned
cd C:\inetpub\wwwroot\AppBuilder\Scripts
.\RegisterCrystalReports.ps1

Test and run

To run App Builder after an upgrade, follow these steps:

  1. Go to http://localhost/AppBuilder/.

  2. It can take several minutes to update the database. When the login screen appears, enter your administrator's credentials, then click the Sign In button.

  3. If necessary, upload and activate a new license file.