Installing Ingeniux CMS 10.5–10.6 DSS Instances


Prerequisites:

To install an Ingeniux Dynamic Site Server (DSS) instance, run the Ingeniux CMS 10.5–10.6 DSS Instance Setup Wizard on the server that will host the DSS. The wizard installs and deploys an instance of the DSS.

Important
If the installed CMS system uses a license key that doesn't include a DSS license, the DSS cannot install. To receive a new key with a DSS license, contact Ingeniux Support.
To install a CMS 10.6 or CMS 10.5 DSS instance:
  1. Follow the step that corresponds with your CMS site instance installation version.
    • Version Notes: CMS 10.6
      Navigate to Ingeniux CMS 10.6 within your server's file system.
      For example, in the Windows OS, click the Start icon > Ingeniux CMS 10.6.
    • Version Notes: CMS 10.5

      Navigate to Ingeniux CMS 10.5 within your server's file system.

      For example, in the Windows OS, click the Start icon > Ingeniux CMS 10.5.

  2. In the Ingeniux CMS [version-number] program folder, click Dynamic Site Server Setup Wizard.
    The Welcome dialog displays.
  3. Ensure the Create a new instance option displays as selected.

    Welcome Screen of CMS 10.5–10.6 DSS Instance Setup Wizard

  4. Click Next.
    The Choose Instance screen displays.

    Choose Instance Screen of CMS 10.5–10.6 DSS Instance Setup Wizard

  5. Choose one of the following instance type options.
    • If you want to set up the DSS instance as a Virtual Directory:
      1. Select the Virtual Directory option.
      2. Select Default Web Site or website of your choice to have the Virtual Directory created under.
      3. Click Next.

        The Instance Name screen displays.

      4. Enter the virtual directory name in the field provided.
        Note
        Consider including the associated CMS instance in the virtual directory name. This way, you can identify which DSS instances associate with particular CMS instances.

        In this example, the instance name is cms-106-staging-dss, where "cms-105" is the name of the CMS instance and "staging" is the name of the publishing target.

        DSS Virtual Directory Instance Name

      5. Click Next.

        The Physical Location screen displays.

    • If you want to set up the DSS instance as a website:
      1. Select the Site option.
      2. Click Next.

        The Instance Name screen displays.

        DSS Website Instance Name

      3. Complete the following fields:
        FieldDescription
        Host NameEnter the host name of the site.
        Display Name

        The DSS Instance Setup wizard auto-populates the Display Name field with the host name that you provided.

        Optional: If you would rather use a different display name than the auto-populated one, enter it in the Display Name field.

        IP AddressEnter the IP Address of your DSS site. By default, the IP address sets to a value of *, which indicates the IP address of the local server.
        PortProvide your site's port number in the Port field. By default, the port value sets to 80.
      4. Click Next.

        The Physical Location screen displays.

  6. Click Browse and navigate to the folder that will contain the DSS instance installation (e.g., C:\igxdss\cms-105-staging-dss).
    Note
    If the containing folder does not exist, use the Browse > Make New Folder button to create one.

    Physical Location Screen of CMS 10.5–10.6 DSS Instance Setup Wizard

  7. Determine if you want to deploy source code.

    If you select the Deploy Source Code checkbox, then a sample ASP.NET MVC solution deploys with the installation.

    Caution
    For legacy installations using an XSLT runtime and for installations deploying an existing MVC solution, do not select this option. However, if you plan to build a new MVC solution, you can deploy the source code to use as the framework for your project. Generally, we recommend selecting the Deploy Source Code checkbox.
  8. Click Next.
    The Content Locations screen displays.

    Content Locations Screen of CMS 10.5–10.6 DSS Instance Setup Wizard

  9. Click Browse to the right of the Published Content field.
    Version Notes: CMS 10.6
    The CMS Assets (optional) field is deprecated in CMS 10.6.
  10. Navigate to the location of the folder that you set up for the physical location of the DSS instance.

    The DSS displays content on the DSS website from this folder. Your published content path will be similar to the following: [Drive]:\[Path-to-DSS-Site]\[Publishing-Target-Name].

    For example: C:\Ingeniux\dss\cms-105-dss-staging-dss\published.

    Important
    • Do not give the name XML to the folder that will contain the CMS published content for non-preview sites. If the folder is named XML, then conflicts will occur when the DSS Preview PageFilesLocation key value references the folder's filepath.
    • Remember the Published Content path. You will use this path when configuring replication. The Published Content folder is where the CMS replicates content within the DSS file structure.
  11. Click OK to close the File Explorer dialog.
    The path displays in the Published Content field.
  12. Click Next.
    The setup wizard creates a DSS instance and displays the Success screen.
    Note
    The Success dialog contains the link to your hosted DSS instance. In the screen capture below, the new DSS instance is hosted locally.

    CMS 10.5–10.6 DSS Installation Finished Successfully

  13. Click Finish.
    Tip
    When you go to your new DSS site, you will see that unformatted XML content displays. The reason why the DSS renders unformatted XML is because your MVC solution, which controls content formatting and style, has not been deployed to your DSS site.

Next Steps:

  • To deploy the MVC solution to your DSS, see Setting up DSS to Display Content for details.
    Note
    If your MVC solution has not been developed, then it's too early to deploy the MVC solution.
  • If your organization will develop the MVC site, rather than the Ingeniux Development Services team, see Developing an MVC Site for details.