Friday 2 September 2016

Sitecore Publishing Service – Part 2 (Install Sitecore Publishing Service)



In this part will walk you through the steps of installing and configuring sitecore publishing service into your site, if you didn’t read the sitecore publishing service part 1 I advise you to do so, you can find a good introduction to sitecore publishing service, so are you ready? Let’s start.




Sitecore publishing service consist of two main parts; the separated sitecore publishing service ASP.Net Core application and sitecore integration package, will show you in details how to setup both.


Before going to details steps you will need to download the following which I will mention when I use them:
   

How to install Sitecore publishing service application?

Step 1 

Sitecore publishing service host needs .Net core to be installed, if you don’t know if you have it see the following cmd commands that will help you:


Also click here to download the version that suite your system.


Step 2

Download Sitecore Publishing Service Host and extract it your C:\inetpub\wwwroot\ or whatever directory you are using.

Let’s assume that your service will be called “SitecorePublishing” Go to IIS and create a new site pointing to this directory and change the sitecore application pool .Net CLR version to be “No Managed Code” as you can see from the following screen shot:

  

Note: Also do not forget to configure your host file.


Step 3

Now is the step of connected your service host with the databases related to the sitecore instance that you will use the service for, this can be done by placing the following file in the following path:
C:\inetpub\wwwroot\sitecorepublishing\config\global


Notice that the file extension is .xml and should be started with sc prefix.

Also you can add these connection strings can be added to the file “C:\inetpub\wwwroot\sitecorepublishing\config\sitecore\publishing\sc.publishing.xml” as you can see from the following screen shot:


Step 4

Update your databases to be compatible with the new publishing service, this can be used by following steps:
  • Run CMD as administrator
  •  Change directory to your service root by executing: cd C:\inetpub\wwwroot\sitecorepublishing
  • Run schematool list to see your schema with current version
  • Run schematool upgrade to upgrade the databases schema



The schema upgrade command will add tables to your configured databases like:
  •  __PublishingSchema: This table will show you the version of the current installed publishing service, as you can see from the following screen shot:


  • Publishing_JobQueue: this table will show you the jobs that have been executes with status and dates stamps, see following screen shot:

  • Publishing_Data_Params_FieldIds
  • Publishing_Data_Params_Languages
  • Publishing_JobManifest
  • Publishing_JobMetadata   
  • Publishing_ManifestOperationResult
  • Publishing_ManifestStatus
  • Publishing_ManifestStep   
  • Publishing_PublisherOperation
 Will explain the publishing jobs and Manifests in future posts.

Step 5

All what you need to do now is open the following: 
http://sitecorepublishing/api/publishing/operations/status

If you get {"status":0} then you service is ready! You’re almost there.



 
How to install Sitecore Integration Package?

Step 1

This is an easy part first you have to download Sitecore Publishing Integration Module and install it using following steps
  • Login to your sitecore instance
  • Go to desktop and then from start go development tools and then to installation wizard.
  • Upload and choose Sitecore Publishing Integration Module
  • Restart the client after finish





Step 2

 
Add the following file to your include folder which contains the configuration that will tell your sitecore instance to which service to use (this is done by the service URL).


Now your publishing service is up and running, yes there are other configurations that you can apply which will talk about later, now have fun and use the publishing service! J
 

No comments:

Post a Comment