For developers: moving your Sitecore 9.x installation to another folder

Sometimes, you might decide to tidy the Sitecore installation folders or you realized that you dislike the name the installation folder received.

Here’s some steps on how to move or rename your Sitecore installation folders

Sitecore X0/XP/XM and IdentityServer

Open Internet Information Services (Run > inetmgr) and stop the Identity Server and Sitecore X0/XP/XM websites. Move those sites to the target folder (Cut > Paste), or rename them.

On IIS, click on the Identity Server website. In the right pane, click on Basic Settings… and then in the Edit Site dialog, update the Physical Path. Repeat this step for the other Sitecore X0/XP/XM roles.

Finally, start the websites again.

I like to group the Sitecore roles into a parent folder. For example, I have a folder xp930 that contains:

  • Identity Server: xp930.identityserver
  • Sitecore X0: xp930.sc
  • Universal Tracker Collection Service: xp930.tracking.collection.service
  • Universal Tracker Processing Service: xp930.tracking.processing.service
  • Sitecore xConnect: xp930.xconnect

xConnect, Index Worker, Marketing Automation, Processing Engine

Open Internet Information Services (Run > inetmgr) and stop the xConnect website.

Open Services (Run > services.msc) and stop the Sitecore Marketing Automation Engine, Sitecore Processing Engine and Sitecore XConnect Search Indexer services.

Now, move the xConnect website folder to the target folder (Cut > Paste), or rename it.

On IIS, click on the xConnect website. In the right pane, click on Basic Settings… and then in the Edit Site dialog, update the Physical Path.

Open a Command Prompt dialog as Administrator and run the following command lines to update the path of the Sitecore Marketing Automation Engine, Sitecore Processing Engine and Sitecore XConnect Search Indexer services.

Index Worker

SC CONFIG "xp903.xconnect-IndexWorker" binPath= "\"C:\inetpub\wwwroot\xp903.xconnect\App_Data\jobs\continuous\IndexWorker\XConnectSearchIndexer.exe\" \"-service\""

Marketing Automation

SC CONFIG "xp930.xconnect-MarketingAutomationService" binPath=
"\"C:\inetpub\wwwroot\xp930\xp930.xconnect\App_Data\jobs\continuous\AutomationEngine\Sitecore.MAEngine.exe\" \"-service\""

Sitecore Processing Engine

SC CONFIG "xp930.xconnect-ProcessingEngineService" binPath=
"\"C:\inetpub\wwwroot\xp930\xp930.xconnect\App_Data\jobs\continuous\ProcessingEngine\Sitecore.ProcessingEngine.exe\" \"-service\""

The first argument is the name of the service, which you can find by double-clicking the service and inspecting the Service name property.

The second argument is the executable path of the service. Notice that I escape quotation marks by using a backslash ( \ ) key.

Remarks:

  • For each command-line option (parameter), the equal sign is part of the option name.
  • A space is required between an option and its value (for example, binPath= C:\…. If the space is omitted, the operation will fail.

With all set and done, start Sitecore Marketing Automation Engine, Sitecore Processing Engine and Sitecore XConnect Search Indexer services and the xConnect website.

Note: By moving things around, you might need to reconfigure permissions on folders. Since I am dealing with a developer machine, I normally add all the permissions to the root of the inetpub folder. This way I don’t have to worry about setting it over again.

Credits

Photo by Sharon McCutcheon on Unsplash

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s