Valid for Sitecore 6.x
Module Updates
Prev

Instructions on downloading and installing module updates.

Upgrade instructions from Active Directory 1.0.3 rev. 111005 to Active Directory 1.0.4 rev. 121120:

To download the full distributive of the Active Directory module 1.0.4 rev. 121120:

To upgrade the module from version 1.0.3 rev. 111005 to version 1.0.4 rev. 121120:

Upgrade Instructions.

  1. Install "Sitecore Active Directory - 1.0.4 rev. 121120 Upgrade.zip".
  2. Click "Yes to all" when you are asked whether you want to override existing files.

Upgrade instructions from Active Directory 1.0.2 rev.090914 to Active Directory 1.0.3 rev. 111005:

To download the full distributive of the Active Directory module 1.0.3 rev. 111005:

To upgrade the module from version 1.0.2 rev.090914 to version 1.0.3 rev. 111005:

Update Instructions:

  1. Install "Sitecore Active Directory - 1.0.3 rev. 111005 Upgrade.zip"
  2. Click "Yes to all" when you are asked whether you want to override existing files.
  3. Make changes to the App_Config\Include\ldap.config file.

Changes in the App_Config\Include\ldap.config:

Add the following nodes to configuration\sitecore:

<pipelines>
     
      <initializeAdUserEntry>
        <!--
        Use the processor if all new user should have a predefiled value in a property.
        The PropertyName parameter defines the name of the property.
        The DefaultValue parameter defines the default value of the property.
        -->
        <!--
        <processor type="LightLDAP.Pipelines.InitializeAdEntry.SetPropertyValue, LightLDAP">
          <PropertyName desc="AD property name ">type the property name here</PropertyName>
          <DefaultValue desc="AD property value ">type the default property value here</DefaultValue>
        </processor>
        -->
        <!--
          Use the processor if all new roles should be a member of the predefined role.
          The RoleName parameter defines the name of the main role.
        -->
        <!--
        <processor type="LightLDAP.Pipelines.InitializeAdEntry.AddToRole, LightLDAP">
          <RoleName desc="AD group">type role name here</RoleName>
        </processor>
        -->
        <processor type="LightLDAP.Pipelines.InitializeAdEntry.CommitChanges, LightLDAP"/>       
      </initializeAdUserEntry>

      <initializeAdRoleEntry>
        <!--
        Use the processor if all new user should have a predefiled value in a property.
        The PropertyName parameter defines the name of the property.
        The DefaultValue parameter defines the default value of the property.
        -->
        <!--
        <processor type="LightLDAP.Pipelines.InitializeAdEntry.SetPropertyValue, LightLDAP">
          <PropertyName desc="AD property name ">type the property name here</PropertyName>
          <DefaultValue desc="AD property name ">type the default property value here</DefaultValue>
        </processor>
        -->
        <!--
          Use the processor if all new roles should be a member of the predefined role.
          The RoleName parameter defines the name of the main role.
        -->
        <!--
        <processor type="LightLDAP.Pipelines.InitializeAdEntry.AddToRole, LightLDAP">
          <RoleName desc="AD group">type role name here</RoleName>
        </processor>
        -->
        <processor type="LightLDAP.Pipelines.InitializeAdEntry.CommitChanges, LightLDAP"/>
      </initializeAdRoleEntry>

    </pipelines>

Active Directory 1.0.2 rev.090914 module update.

To download the full distributive of the Active Directory module 1.0.2 rev. 090914:

To download the update package of the Active Directory module 1.0.2 rev. 090914:

To update an existing Active Directory installation from any version to the current one, follow these instructions:

  • Install the Active Directory Upgrade Package.
  • Click "Yes to all" when you are asked whether you want to override existing files.
  • Change system.web\profile attributes to (if a customer uses the AD profile provider):
    <profile defaultProvider="switcher" enabled="true" inherits="Sitecore.Security.UserProfile, Sitecore.Kernel">
    Change system.web\profile\providers\switcher (if a customer uses the AD profile provider):
    <add name="switcher" type="Sitecore.Security.SwitchingProfileProvider,Sitecore.Kernel" applicationName="sitecore" mappings="switchingProviders/profile" />
    Changes in the App_Config\Include\ldap.config:
    • Remove under sitecore\settings the following nodes:
      <setting name="LDAP.DefaultProfile" value="" />
      <setting name="LDAP.Sync" value="false" />
      <setting name="LDAP.SyncConnection" value="DomainRoot" />
      <setting name="LDAP.SyncFlags" value="1" />
    • Add to sitecore\settings the following nodes:
      <!-- ENABLE SORT OPERATION
                   Determines whether the sorting is enabled
              -->
              <setting name="LDAP.EnableSorting" value="false" />
             <!-- LDAP FIND USERS SIZE LIMIT
                   Determines the max number of returned users for GetAll method
              -->
              <setting name="LDAP.FindSizeLimit" value="100" />
              <!-- LDAP USER CACHE SIZE
                   Determines the size of the ldap users cache.
                   Specify the value in bytes or append the value with KB, MB or GB
                   A value of 0 (zero) disables the cache.
              -->
              <setting name="LDAP.Caching.UserCache" value="2MB" />
              <!-- LDAP MEMBEROF CACHE SIZE
                   Determines the size of the ldap users cache.
                   Specify the value in bytes or append the value with KB, MB or GB
                   A value of 0 (zero) disables the cache.
              -->
              <setting name="LDAP.Caching.MemberOfCache" value="2MB" />
              <!-- LDAP MEMBERS CACHE SIZE
                   Determines the size of the ldap users cache.
                   Specify the value in bytes or append the value with KB, MB or GB
                   A value of 0 (zero) disables the cache.
              -->
              <setting name="LDAP.Caching.MembersCache" value="2MB" />
                      <!--  SETTINGS PROPERTY VALUE FACTORY
                  Returns an SettingsPropertyValueFactory interface that resolves the active directory properties.
              -->
              <setting name="LDAP.SettingsPropertyValueFactory" value="LightLDAP.SettingsPropertyValueFactory, LightLDAP" />
              <!-- RECONNECT PERIOD
                   Determines a reconnect period for attempts to restore connection after the connection gets break.
              -->
              <setting name="LDAP.ReconnectPeriod" value="0.00:10:00" />
              <!-- TIME OUT NOTIFICATION
                   Determines a timeout for notification.
              -->
              <setting name="LDAP.NotificationTimeOut" value="1.00:00:00" />
              <!-- FULL NAME PROPERTY NAME
                   Determines the full name property mapping.
              -->
              <setting name="LDAP.FullName" value="ad|unicode string|displayName" />
              <!-- DELETE USER SCOPE
                   Determines the scope of the "delete user" operation.
              -->
              <setting name="LDAP.DeleteScope" value="Subtree" />
              <!-- MAX VALUE RANGE
                   Determines the maximal value of an AD range attribute.
              -->
              <setting name="LDAP.MaxValueRange" value="1500" />

Active Directory 1.0.1 rev.090302 module update.

Download Active Directory 1.0.1 rev.090302 update package.

To update an existing Active Directory installation from any version to the current one, follow these instructions:

  • Backup the /App_Config/Include/ldap.config.
  • Install the Active Directory Upgrade Package.
  • Choose "Overwrite" when prompted.
  • Merge the settings from the old ldap.config with the settings in the newly installed one.

Active Directory 1.0.0 rev.080903 module update.

Download Active Directory 1.0.0 rev.080903 update package.

To update an existing Active Directory 1.0.0 installation, follow these instructions:   

  • Backup the /App_Config/Include/ldap.config.
  • Install the module package, choose "Overwrite" when prompted.
  • Merge the settings from the old ldap.config with the settings in the newly installed one.

Prev