Documentation Center

Setting up Site Types for the Site Wizard

Set up the Site Wizard to enable users to create a new site quickly without having to run PowerShell scripts. In the Site Wizard, users combine one BluePrint Publication (the Site Type) with another BluePrint Publication (the Content Publication). You need to map each Site Type to a Web application on the delivery side.

About this task

The Site Wizard must use certain assumptions in order to work: specifically, when setting up a Site Type in Topology Manager, you have to ensure that you associate it with only one Topology and only one Web application per Content Delivery environment. If there is ambiguity, the Site Type does not appear in the Site Wizard.

Procedure

  1. Create at least one Publication with its Type set to SiteType. Such a Publication defines the logic of the sites you create on top of it, but not the contents of those sites. Your next step is to configure the newly created Publication or Publications with the Type set to SiteType in Topology Manager. The steps that follow describe the procedure for one Publication.
  2. Find out which Topology Types exist in your system by running the following Powershell command:
    Get-TtmCdTopologyType
    Powershell shows you a table of one or more defined Topology Types, showing the name, Purpose(s), ID and Extension Properties for each. Typically, your setup will have only one Topology Type defined.
  3. If you get multiple Topology Types back from this command, identify the one used by this Publication as follows:
    1. In Content Manager Explorer, right-click the Publication and select Properties to open a Properties dialog.
    2. On the Publishing tab, check the value for Business Process Type.
    3. In the Publication node of the tree, under Business Process Types, find and open the Business Process Type you found.
    4. On the Target Types tab of the Business Process Type, check the value of Topology Type.
    5. In the script response, note down the value of the Id property for the Topology Type whose Name property is the value your found.
  4. Run the following PowerShell command:
    Get-TtmCdTopology
    Powershell shows you one or more property-value tables, one for each defined Topology. The first property for each table is CdTopologyTypeId, which identifies the Topology Type of this Topology.
  5. Find the Topology or Topologies whose CdTopologyTypeId is the one you found previously. Typically, your setup will have only one Topology per Topology Type, but if you see multiple Topologies with the Topology Type ID you identified, identify the specific Topology used by this Publication as follows:
    1. Check the value of the CdEnvironmentIds property for the first Topology listed. This is a comma-separated list.
    2. Run the command Get-TtmWebsite.
      Powershell shows you one or more property-value tables, one for each defined website. Each table shows a value for a CdEnvironmentId property.
    3. Compare the Content Delivery environment IDs of the websites against the list of Content Delivery environment IDs for this first Topology, and note down the value of the Id of each website that matches.
    4. Run the command Get-TtmWebApplication.
      Powershell shows you one or more property-value tables, one for each defined web application. Each table shows a value for a WebsiteId property.
    5. Compare the website IDs of the web applications against the list of website IDs that match this first Topology, and note down the value of the Id of each web application that matches.
    6. Run the command Get-TtmMapping.
      Powershell shows you one or more property-value tables, one for each defined mapping. Each table shows a value for a PublicationId property.
    7. Check all the PublicationId property values against the Content Manager URI of your Publication (which you can see by selecting its Info tab in Content Manager Explorer). If you find a match, then this Topology is the one that your Publication publishes to; if you do not find a match, repeat the procedure for the next Topology until you find the correct one.
    You have identified your Topology and its ID. To complete the setup, you can run a single command for a quick setup, or individual commands for more fine-grained installation options.
  6. If you want to do the rest of the setup quickly, run the following command:
    Add-TtmSiteTypeKey -Key PUBKEY -CdTopologyId TOPID -WebApplicationIds WEBAPPIDS
    where:
    • TOPID is the ID of your Topology
    • PUBKEY is the value of Publication Key in the General tab of your Publication, as found in Content Manager Explorer
    • WEBAPPIDS is comma-separated list of the IDs of your Web applications.
  7. Alternatively, if you want to perform a more detailed setup, do the following:
    1. Run the following command:
      Set-TtmCdTopology -Id TOPID -ScopedRepositoryKeys PUBKEY

      where TOPID is the ID of your Topology, and PUBKEY is the value of Publication Key in the General tab of your Publication, as found in Content Manager Explorer.

    2. Get the Content Delivery environment(s) associated with this Topology, by checking the value of the CdEnvironmentIds property in this response. This is a comma-separated list.
    3. For each Content Delivery environment, run the following command:
      Set-TtmCdEnvironment -Id CDENVID -ScopedRepositoryKeys PUBKEY

      where CDENVID is the ID of one of the Content Delivery environments, and PUBKEY is the value of Publication Key in the General tab of your Publication, as found in Content Manager Explorer.

    4. Find out the Web site(s) associated with all Content Delivery environments by running the following command:
      Get-TtmWebsite

      and checking for the matching Content Delivery environment ID, then recording the Id property, representing a website ID.

    5. For each website ID you collected in this way, run the following command:
      Set-TtmWebsite -Id WEBSITEID -ScopedRepositoryKeys PUBKEY

      where WEBSITEID is the ID of one of the Web sites, and PUBKEY is the value of Publication Key in the General tab of your Publication, as found in Content Manager Explorer.

    6. Run the following command:
      Get-TtmWebApplication

      and checking for the matching website ID, then recording the Id property, representing a web application ID.

    7. For each web application you collected in this way, run the following command:
      Set-TtmWebApplication -Id WEBAPPID -ScopedRepositoryKeys PUBKEY

      where WEBAPPID is the ID of one of the Web applications, and PUBKEY is the value of Publication Key in the General tab of your Publication, as found in Content Manager Explorer.