Posts tagged "Install"

Quick and Easy steps to run Author & Publish Systems of Correspondence Management ES4

Steps to setup Correspondence Management system with author and publish instances configured

It’s recommended to perform these steps on your development system where you would like to  have a setup in less amount of time to get started with the application

For stage, UA or prod systems please follow the detailed install & config guides

 

  1. Run LiveCycle installer and complete installation , before running LCM follow as mentioned in next step
  2. Go to <LC_Root_Directory>/jboss/server , create a copy of lc_turnkey under the same folder but with different name .. say lc_publish_turnkey (Publish instance needs a separate JBoss profile so this new profile can be used for publish instance)
  3. Now run LCM and complete the configuration manager – After completing LCM run You will have Author instance of CM up and running , now you need to perform few more steps to have author and publish running on same machine and configured to talk to each other
  4. LCM creates a folder with name crx-repository under <LC_Home_Directory> which is used as a repository for author instance
  5. Create a new folder under <LC_Home_Directory> with name “crx-publish-repository” (without quotes) , Go to <LC_Home_Directory>\configurationManager\export\crx-quickstart and copy install folder along with it’s contents and paste it under <LC_Home_Directory>\crx-publish-repository such that the contents under publish repository would appear like this after pasting the contents <LC_Home_Directory>\crx-publish-repository\install\
  6. Go to <LC_Home_Directory>\configurationManager\export Copy adobe-livecycle-cq-publish.ear file and paste it in <LC_Home_Directory>\jboss\server\lc_publish_turnkey\deploy folder
  7. Start lc_publish_turnkey profile from command prompt using command as “run -c lc_publish_turnkey -Dcom.adobe.livecycle.crx.home=”C:/pathToLCHomeDirectory/crx-publish-repository” -Djboss.service.binding.set=ports-01 -b 0.0.0.0” [o is zero in case you try to copy paste this content]
  8. For the first time start up of publish instance , It takes around ten minutes to completely start as it unpacks packages and creates repository , When the server is up and running You can use following URLs to log on to author and publish systems
  9. Author Manage Assets UI – http://hostname:8080/lc/cm , Publish Manage Assets UI – http://hostname:8180/lc/cm (You can login as default super admin i.e administrator/password – Change the password if needed)
  10. One last setting before you are done – Go to http://authorinstancehostname:8080/lc/etc/replication/agents.author/publish.html  , Login as admin\admin , Click Edit , Go to Transport tab and modify URL to http://localhost:8180/lc/bin/receive?sling:authRequestLogin=1 , Click OK , Click Test Connection and ensure that you see success message

Now you have running Correspondence Management system with author instance running on port 8080 and publish instance running on port 8180

 

Santosh

Deploying CM on production server

Experience Server Solutions QuickStart provides some sample collateral and creates some sample users so that developers can directly start using the OOTB reference application and make use of samples to know about and learn the product capabilities, *but* It is highly recommended to remove these sample assets and sample users when the solution is deployed on to a production server.

 

I will take you through the steps to remove:

1)      Sample assets from the system and

  1. By uninstalling them from package manager
  2. By Removing sample assets package from SQS

2)      Sample users from the system

  1. Removing sample users from CRX user administration
  2. modifying a configuration file

 

Removing Sample assets & sample users from a production system:

There are two ways to remove the sample assets from the system one can follow any way that suits them.

Steps to remove sample assets and sample users from a running server:

1.a. Removing Sample assets by uninstalling them from package manager [Please do not start SQS as a publish instance till the step it is specified to do so]

  • Go to http://[hostname:port]/crx  (on author instance)
  • Login as admin
  • Click Package Manager
  • Click on Package with name “cm-sampleassets.zip”
  • Click More dropdown in action bar (This action bar has other actions like Edit Build etc.,. , More option is in the right most area of this bar)
  • Click Uninstall
  • Click Uninstall again on confirmation dialog
  • Wait for sometime till you see a message like “Package uninstalled in <some>ms” in the Activity Log
  • Now if you log on to CM Manage Assets UI , you will not see any sample assets. If you are still seeing them then clear your browser cache and then try.

2.a Removing sample users from CRX user administration

  • Go to http://[hostname:port]/crx (on author instance)
  • Login as admin
  • Click User Administration
    • CM creates following users OOTB
      • Todd Goldman (tgoldman)
      • Caleb Lopez (clopez)
      • Gloria Rios (grios)
      • Frank Kricfalusi (fkricfalusi)
      • Jocelyn Robinson (jrobinson)
      • Heather Douglas (hdouglas)
      • In user administration dialog , Navigate to each of these users and click Remove user , Now if you try to log on to CM Manage Assets UI with any of the above usernames , You are not allowed to login

After completing steps mentioned in 1.a & 2.a , You can start the publish instance , Follow the steps mentioned above in 2.a and remove sample users from publish instance as well.

 

Now I will take you through the steps 1.b & 2.b in order to stop creation of sample assets and sample users by making some changes in SQS jar

Steps to remove sample assets and sample users from SQS when server is down (or not even started once):

1.b Steps to stop sample assets creation

  • Open SQS jar using a zip utility
  • Navigate to <SQS jar>\static\repository\install
  • Open solution-correspondencemanagement-pkg-<version>.zip file
  • Navigate to solution-correspondencemanagement-pkg-<version>.zip\ jcr_root\etc\packages\adobe\aep\solutions
  • Select samples-correspondencemanagement-pkg-<version>.zip
  • Click Delete
  • Save the changes to jar
  • Re-open the SQS jar with any zip utility and validate that the samples-correspondencemanagement-pkg-<version>.zip is not shown in the location from where you deleted it
  • This package creates sample assets , If we delete it we can stop the creation of sample assets on production system

2.b Steps to stop creation of sample users

  • Open SQS jar using a zip utility
  • Navigate to <SQS jar>\static\repository\install
  • Open solution-correspondencemanagement-pkg-<version>.zip file
  • Navigate to solution-correspondencemanagement-pkg-<version>.zip\ jcr_root\etc\packages\adobe\aep\solutions
  • Open template-correspondencemanagement-pkg-<version>.zip
  • Navigate to template-correspondencemanagement-pkg-<version>.zip \jcr_root\apps\solutions\cm
  • Edit CMGroupsAndUsers.xml to make following changes
    • Remove the below section from xml [Remove block and lines highlighted here]

 

  • Use the modified xml in template-correspondencemanagement-pkg-<version>.zip
  • Save changes to SQS jar
  • Re-open the SQS jar with zip utility and check that the changes to CMGroupsAndUsers.xml are properly saved

Now use this SQS jar to run author and publish instances , Sample assets and sample users will not be created after these changes

 

Note:

These steps are just to give an overview, Please do not follow them as is on any production server. Contact ADEP Engineering/Support/PS before you try these on a production system so that they can provide more and in-detail steps to achieve this, which best suits your deployment topology and any other specific needs.