Skip to main content

Install Sitecore Connect for Content Hub on-prem

Abstract

Guide to installing the Sitecore Connect for Content Hub connector on-prem

You must install the Sitecore Connect for Content Hub (SCCH) connector on your Content Manager (CM) server. If you use the Sitecore Digital Asset Management (DAM) functionality, you must also install SCCH on your Content Delivery (CD) server(s). This enables you to populate images from your Sitecore DAM installation to your CD server.

Before installing SCCH, you must have Sitecore Experience Platform 9.2, 9.3, 10.0.x, 10.1, or 10.2 installed on your server. You must also have access to Sitecore Content Hub 3.4.x, 4.0.x, 4.1, or 4.2.

You must also ensure that the following network ports are available and not blocked by your Windows firewall:

Required port

Role

443

HTTPS

5671

AMQP

9354

Net messaging/SBMP

You can install SCCH using either dat or dacpac files, depending on which Sitecore version you use. The following table shows which Sitecore versions support which installation types methods.

Sitecore version

Dacpac

Dat

Note

10.0 or below

Yes

No

10.1

Yes

Yes

The dat file must be placed in the App_Data\items folder.

10.2

No

Yes

To install SCCH on your Sitecore server:

  1. Download the SCCH module installation package and the SCCH Sitecore Installation Framework (SIF) from the Sitecore download page.

  2. Unzip the SCCH SIF installation package to your server.

  3. Open a PowerShell window with administrator privileges. Use the following command to run the SCCH SIF installation script:

    <path where you extracted the SCCH SIF installation script>\deploy.ps1 `
    -ScchWdpPackage “<path of SCCH module installation package downloaded>” `
    -InstanceName “<Sitecore instance name>” `
    -InstanceUrl “<Sitecore instance url>” `
    -SitecoreAdminUser “<Sitecore admin user name>” `
    -SitecoreAdminPass “<Sitecore admin password>” `
    -SqlInstanceName “<Sitecore SQL Database prefix name>” `
    -SqlUser “<SQL server user name>” `
    -SqlPass “<SQL server password>” `
    -SqlServerName “<SQL server name>” `
    -SkipDatabaseInstallation “<true or false for skip database installation>”

    Note

    If you are deploying SCCH using dat files, you must set the SkipDatabaseInstallation parameter to $true. If you are not using dat files, set it to $false.

    For the SqlInstanceName parameter, you can find the prefix in the Sitecore database name that is in the form of <Sitecore SQL Database prefix name>_Core.

  4. If you are installing SCCH on a CD server, to enable DAM images to be populated on the CD website, you must now go to the C:\inetpub\<CD site>\xsl folder and open the xslt file, for example, sample rendering.xslt, in a text editor. Add an sc:image field line to the xslt file.

    For example:

    <!-- entry point -->
    <xsl:template match="*">
      <div>
        <h1 class="contentTitle">
          <sc:text field="title"/>
        </h1>
        <div class="contentDescription">
          <sc:text field="text" />
          <sc:image field="image" />
        </div>
      </div>
    </xsl:template>
  5. Save the xslt file.