Configuring the Web App

You configure the Web App using the Web Configuration tool. By default, if you left the Run the Web Configuration check box selected on the Completed page of the Setup Wizard, the manager starts after you complete the installation.

You can launch the Web Configuration tool from the Alloy Control Panel or using the Start menu.

INFO: For details, see Using the Alloy Control Panel.

NOTE: After you complete the initial configuration, you can always use the Web Configuration tool to modify your configuration. For details about available settings, see Pre-configuration considerations.

To configure the Web App:

1. On the main menu of the Web Configuration tool, click File > Create > Web App. This step applies only if you cleared the Run the Web Configuration check box in the last step of the installation procedure on the Completed page of the Setup Wizard.

2. On the Database page, specify the Database Access key that the Web App will use to connect to your AN2023 database.

   1. Click Import Key and import the Database Access Key. This populates the SQL Server and Database fields with the values from the imported key.

      INFO: For details, see Importing the Database Access Key and Distributing the Database Access Key.

   2. Fine-tune the database connection details, if needed: in the SQL Server field, enter the network address of the SQL Server, which may differ from the SQL Server name specified in the Database Access Key.

   Click Next.

3. On the Web page, type a description of your web application. This description will help you and other administrators identify this Web App instance on the IIS server.

   Click Next.

4. On the Installation Type page, specify where to install the Web App:

   • If you want to install the web application as a web site, i.e. to the root directory of a web site, click Install as a web site.

   • If you want to install the web application to a virtual directory on a web site, click Install into a virtual directory.

     INFO: For instructions, see Choosing the Installation Type (Web App).

   Click Next.

5. On the Web Site page, all web sites available on the IIS server are displayed. Choose the site where you want to install the Web App. If you are installing the web application as a web site, you can specify parameters for the new site. Click Next.

   • If you are installing the web application into a virtual directory, the Virtual Directory page opens. Proceed to the step describing the Virtual Directory page.

   • If you are installing the web application as a site, the User Authentication Type page opens. Proceed to the step describing the User Authentication Type page.

6. On the Virtual Directory page, type the name of the virtual directory to create, or select an existing directory from the list.

   NOTE: The virtual directory name will become a part of the URL you will be using to access the Web App. For example, if your server's host name is "www.example.com," specifying "wp" as the Virtual Directory Name will result in the following URL: https://www.example.com/wp/.

   Click Next.

7. On the Authentication Method page, choose the authentication type for Web App users:

   • If you want to use Windows authentication, click Windows Authentication.

   • If you want to use standard (password) or single sign-on authentication, or leverage LDAP authentication, click Standard Authentication.

     To allow password authentication, select the corresponding check box.

     INFO: For details about authentication types, see Choosing Authentication Method.

   Click Next.

8. On the Workflow Integration page, you can specify the URL address for the Web Portal Link macro. This macro is used in workflow notifications to generate direct links to objects.

   INFO: For details, see Customizing the Web Portal Link Macro.

   The Web Configuration tool detects the URL address automatically and suggests to use this value by default. To replace the auto-detected URL with your custom value, click Replace the macro’s value with a custom URL and type in your custom URL address.

   TIP: Applying the suggested URL is the best choice when the web application is to be accessed only over the local network. When the web application will be accessed over the Internet, you may need to type in the real URL manually. Keep in mind that you can skip this step, complete the configuration, and then run the Web Configuration tool again to replace the macro contents with the real URL.

   Click Next.

9. On the Features page, click Next.

10. On the Logo Image page, specify the logo for the Web App.

    • If you want to leave the default Alloy Software logo, click Next.

    • If you want the Web App to display your custom logo image, select the Custom image option, click Load, select the image file to import and click Open, then click Next.

      INFO: For details, see Customizing the Logo.

11. On the Ready to Apply Settings page, review your settings. To make changes, click Previous to return to the relevant page or pages. When you have finished, click Apply. Wait for the Web Configuration tool to configure the web application.

12. When completed, the Web Configuration tool displays a summary of applied settings.

    NOTE: After you complete the initial configuration, you can always use the Web Configuration tool to modify any settings.

NOTE: If your Web App does not work as expected and you need to send the debug information to our Support Team, click Help > Debug Information on the main menu. The Web Configuration tool will generate the WebConfigDebugInfo.txt file and open it in Notepad.

NOTE: If you want to view the log file, go to the Error Logs section at the bottom of the Web Configuration tool’s page and click View Details.