K2 blackpearl Product Documentation: Installation and Configuration Guide
Custom K2 Workspace Web Site Configuration

K2 Workspace Web Site Configuration for a custom installation

The K2 Workspace Web Site Configuration screen enables:

  1. The selection of a web site cluster if applicable
  2. The creation of the K2 Workspace Site
  3. The ability to select an existing site if one exists
  4. If multiple IIS bindings are used, the installer will allow the user to select one

If you create a new site with the installer, a K2 Self Signed Certificate will be automatically generated and used. If you choose an existing site that has a certificate, that certificate will be used.

When selecting "Use an existing Web Site", this site must already exist.

Feature Description

Web site Cluster

If the Workspace web site is going to be installed over a load balanced environment, enter the load balanced URL here.

Create a New Web Site

If the user wants to create a new site, type the name in the Web Site Name field, and K2 will create it automatically.

Use an Existing Web Site Name

The name of the site that was created under IIS.
Note: The site can be created without closing the K2 Setup Manager. Click Refresh to reload the list of available web site options.

If no site is listed in the Web Site drop down, one may need to be created. Type in the name of the web site you want to create, and K2 will do the rest. If a site was recently created and does not display, you may need to perform an IIS reset. Then, click the Refresh button on this page.

Bindings button and pop-up panel

Bindings refers to the bindings for the website as set up in IIS.

The Bindings panel can be shown by clicking the Bindings button, but will otherwise be hidden as the Setup Manager takes care of Bindings configuration in the background, except under the following conditions:

  1. The Bindings panel will be shown if you have a Binding on your website set up in IIS with a wildcard certificate and with no host name entry. In this case the Bindings panel will show a Binding in this format:
    https://[MachineName].[domain].com:443
     You're free to use this if you do not want to set up a Host Header. If you want to use a Host Header, see the following points:
  2. The Bindings panel will be shown if the Setup Manager detects that the value (WebServiceServerURL) in the Workspace web.config file does not match the selected Binding in the Bindings panel. In this case you will need to select the Binding seen in the web.config for your site to work.

If, during an Upgrade or Reconfigure, the selected Bindings don't match the STS Issuers in the database, the Resolve STS Issuers panel will be shown. See the Resolve Security Token Service Issuers topic for more information.

During an Upgrade or Reconfigure, if the Setup Manager detects that the selected IIS bindings do not match the Uri configured as the K2 Windows STS in the Identity.ClaimIssuer table of the K2 database, the Resolve Security Token Service Issuers panel will be displayed.

What to do on this page

To configure the K2 Workspace Web Site:


Option 1- Create a new web site:

Enter the name for the New web site

Click Next to proceed

The Setup Manager will create the new Web site

Option 2 - Use an existing Web site

Select the web site to use from the Web Site drop down menu

Click Next to proceed

 

 


K2 blackpearl Product Documentation: Installation and Configuration Guide 4.6.11