Sunday, May 31, 2015

Creating Endeca Discover Application For Beginners : Endeca

Create Discover App:


1.   Go To => C:\Endeca\ToolsAndFrameworks\3.1.1\deployment_template\bin


2.   Open Command Prompt from the above location,

3.   Note: deploy.bat file will call deploy.pl file from ToolAndFrameworks lib folder

4.   Note: deploy.pl file will allow the system to call respective variable for creating new app

5.   Follow the below steps:


Microsoft Windows [Version 6.1.7601]
Copyright (c) 2009 Microsoft Corporation.  All rights reserved.

C:\Endeca\ToolsAndFrameworks\3.1.1\deployment_template\bin>deploy.bat --app C:\Endeca\ToolsAndFrameworks\3.1.1\reference\discover-data\deploy.xml



 ------------------------------------------------------------------------------

   Found version 6.1 of the Endeca IAP installed in directory

   C:\Endeca\PlatformServices\6.1.3. If either the version or location are
   incorrect, type 'Q' to quit and adjust your ENDECA_ROOT environment variable.
   Press enter to continue with these settings.

   Continue?


 ------------------------------------------------------------------------------

     Deployment Template installation script.

     This script creates the directory structure for your
     deployment and installs configuration files and scripts
     into the directory structure.

05/05/2015 12:11:57 [deploy.pl] INFO:  Starting deployment template
   installation.

 ------------------------------------------------------------------------------

   The following app modules were specified on the command line argument:

   C:\Endeca\ToolsAndFrameworks\3.1.1\reference\discover-data\deploy.xml


   Modules may be deployed standalone or on top of a base deployment type. Do
   you want to install a base deployment with the specified module(s)?

    Install base deployment? [Y/N]:   Y


05/05/2015 12:12:05 [AppDescriptorReader] INFO:  Parsing application descriptor
   file C:\Endeca\ToolsAndFrameworks\3.1.1\reference\discover-data\deploy.xml.
05/05/2015 12:12:05 [AppDescriptorReader] INFO:  Parsing application descriptor
   file

   C:\Endeca\ToolsAndFrameworks\3.1.1\deployment_template\app-templates\base_descriptor.xml.

 ------------------------------------------------------------------------------

   Enter a short name for your application.

   Note: The name must conform to this regular expression: ^[a-zA-Z0-9]+$
    [default: Discover]

   Choosing a different application name may require additional configuration on
   your web application.

   Application name:  lifestyle

 ------------------------------------------------------------------------------

   Specify the path into which the application will be deployed. The specified
   directory must exist and cannot contain spaces.

   For example, to deploy into c:\apps\lifestyle, specify the path as c:\apps.


   Deployment directory: C:\Endeca\Apps


 ------------------------------------------------------------------------------

   Specify the port on which the Endeca Application Controller is running. This
   is configured in the server.xml file in the workspace of the Endeca software
   install and should be the same for all applications deployed in this
   environment. Ports must be in the range 1024-65535 [default: 8888].

   EAC port:  8888


05/05/2015 12:12:46 [deploy.pl] INFO:  Deploying application into
   C:\Endeca\Apps\lifestyle

 ------------------------------------------------------------------------------

   What port is the Workbench running? [Default: 8006]

8006

 ------------------------------------------------------------------------------

Note: I have another app running on 15000 Port. In this app i am using 18000 port

-------------------------------------------------------------------------------

   What port should be used for the Live Dgraph? [Default: 15000]

18000

 ------------------------------------------------------------------------------

   What port should be used for the Authoring Dgraph? [Default: 15002]

18002

 ------------------------------------------------------------------------------

   What port should be used for LogServer? [Default: 15010]

18010


05/05/2015 12:13:25 [AppDescriptorReader] INFO:  Parsing application descriptor
   file
   C:\Endeca\ToolsAndFrameworks\3.1.1\deployment_template\app-templates\base_descriptor.xml.
05/05/2015 12:13:25 [deploy.pl] INFO:  Processing install with id 'Dgraph'
05/05/2015 12:13:27 [AppDescriptorReader] INFO:  Parsing application descriptor
   file C:\Endeca\ToolsAndFrameworks\3.1.1\reference\discover-data\deploy.xml.
05/05/2015 12:13:27 [deploy.pl] INFO:  Processing install with id
   'DefaultTemplateManagerApp'
05/05/2015 12:13:30 [deploy.pl] INFO:  Application successfully deployed.


C:\Endeca\ToolsAndFrameworks\3.1.1\deployment_template\bin>

Note: Verify our new app will be created under C:/Endeca/Apps folder. if it is created. then we are successfully created the new app.



Run Initial_Services.bat




C:\Endeca\Apps\lifestyle\control>initialize_services.bat
Setting EAC provisioning and performing initial setup...
[05.05.15 12:17:51] INFO: Checking definition from AppConfig.xml against existing EAC provisioning.
[05.05.15 12:17:51] INFO: Setting definition for application 'lifestyle'.
[05.05.15 12:17:52] INFO: Setting definition for host 'AuthoringMDEXHost'.
[05.05.15 12:17:52] INFO: Setting definition for host 'LiveMDEXHostA'.
[05.05.15 12:17:53] INFO: Setting definition for host 'ReportGenerationHost'.
[05.05.15 12:17:53] INFO: Setting definition for host 'WorkbenchHost'.
[05.05.15 12:17:53] INFO: Setting definition for host 'ITLHost'.
[05.05.15 12:17:53] INFO: Setting definition for component 'AuthoringDgraph'.
[05.05.15 12:17:53] INFO: [AuthoringMDEXHost] Starting shell utility 'mkpath_-data-dgidx-output'.
[05.05.15 12:17:57] INFO: [AuthoringMDEXHost] Starting shell utility 'mkpath_-data-partials-forge-output'.
[05.05.15 12:17:58] INFO: [AuthoringMDEXHost] Starting shell utility 'mkpath_-data-partials-cumulative-partials'.
[05.05.15 12:17:59] INFO: [AuthoringMDEXHost] Starting shell utility 'mkpath_-data-workbench-dgraph-config'.
[05.05.15 12:18:01] INFO: [AuthoringMDEXHost] Starting shell utility 'mkpath_-data-dgraphs-local-dgraph-input'.
[05.05.15 12:18:02] INFO: [AuthoringMDEXHost] Starting shell utility 'mkpath_-data-dgraphs-local-cumulative-partials'.
[05.05.15 12:18:03] INFO: [AuthoringMDEXHost] Starting shell utility 'mkpath_-data-dgraphs-local-dgraph-config'.
[05.05.15 12:18:04] INFO: Setting definition for component 'DgraphA1'.
[05.05.15 12:18:05] INFO: Setting definition for script 'PromoteAuthoringToLive'.
[05.05.15 12:18:05] INFO: Setting definition for custom component 'WorkbenchManager'.
[05.05.15 12:18:05] INFO: Updating provisioning for host 'ITLHost'.
[05.05.15 12:18:05] INFO: Updating definition for host 'ITLHost'.
[05.05.15 12:18:05] INFO: [ITLHost] Starting shell utility 'mkpath_-'.
[05.05.15 12:18:07] INFO: [ITLHost] Starting shell utility 'mkpath_-data-workbench-temp'.
[05.05.15 12:18:08] INFO: Setting definition for custom component 'IFCR'.
[05.05.15 12:18:08] INFO: Updating provisioning for host 'ITLHost'.
[05.05.15 12:18:08] INFO: Updating definition for host 'ITLHost'.
[05.05.15 12:18:08] INFO: [ITLHost] Starting shell utility 'mkpath_-'.
[05.05.15 12:18:10] INFO: [ITLHost] Starting shell utility 'mkpath_-'.
[05.05.15 12:18:11] INFO: Setting definition for component 'LogServer'.
[05.05.15 12:18:11] INFO: [ReportGenerationHost] Starting shell utility 'mkpath_-reports-input'.
[05.05.15 12:18:13] INFO: Setting definition for script 'DaySoFarReports'.
[05.05.15 12:18:13] INFO: Setting definition for script 'DailyReports'.
[05.05.15 12:18:13] INFO: Setting definition for script 'WeeklyReports'.
[05.05.15 12:18:13] INFO: Setting definition for script 'DaySoFarHtmlReports'.
[05.05.15 12:18:14] INFO: Setting definition for script 'DailyHtmlReports'.
[05.05.15 12:18:14] INFO: Setting definition for script 'WeeklyHtmlReports'.
[05.05.15 12:18:14] INFO: Setting definition for component 'WeeklyReportGenerator'.
[05.05.15 12:18:14] INFO: Setting definition for component 'DailyReportGenerator'.
[05.05.15 12:18:20] INFO: Setting definition for component 'DaySoFarReportGenerator'.
[05.05.15 12:18:20] INFO: Setting definition for component 'WeeklyHtmlReportGenerator'.
[05.05.15 12:18:21] INFO: Setting definition for component 'DailyHtmlReportGenerator'.
[05.05.15 12:18:21] INFO: Setting definition for component 'DaySoFarHtmlReportGenerator'.
[05.05.15 12:18:21] INFO: Setting definition for script 'BaselineUpdate'.
[05.05.15 12:18:21] INFO: Setting definition for script 'PartialUpdate'.
[05.05.15 12:18:21] INFO: Setting definition for component 'Forge'.
[05.05.15 12:18:22] INFO: [ITLHost] Starting shell utility 'mkpath_-data-incoming'.
[05.05.15 12:18:23] INFO: Setting definition for component 'PartialForge'.
[05.05.15 12:18:23] INFO: [ITLHost] Starting shell utility 'mkpath_-data-partials-incoming'.
[05.05.15 12:18:25] INFO: Setting definition for component 'Dgidx'.
[05.05.15 12:18:25] INFO: Definition updated.
[05.05.15 12:18:25] INFO: Provisioning site from prototype...
[05.05.15 12:18:26] INFO: Finished provisioning site from prototype.
[05.05.15 12:18:26] INFO: Uploading config files to Workbench.
[05.05.15 12:18:26] INFO: [ITLHost] Starting shell utility 'emgr_update_update_mgr_settings'.
[05.05.15 12:18:36] INFO: Finished uploading config files to Workbench.
Finished updating EAC.
Importing sample content...
[05.05.15 12:18:37] INFO: Checking definition from AppConfig.xml against existing EAC provisioning.
[05.05.15 12:18:37] INFO: Definition has not changed.
[05.05.15 12:18:38] INFO: Packaging contents for upload...
[05.05.15 12:18:38] INFO: Finished packaging contents.
[05.05.15 12:18:38] INFO: Uploading contents to: http://ADMINIB-EAOPVNR:8006/ifcr/sites/lifestyle/
[05.05.15 12:18:39] INFO: Finished uploading contents.
[05.05.15 12:18:40] INFO: Checking definition from AppConfig.xml against existing EAC provisioning.
[05.05.15 12:18:41] INFO: Definition has not changed.
[05.05.15 12:18:41] INFO: Packaging contents for upload...
[05.05.15 12:18:41] INFO: Finished packaging contents.
[05.05.15 12:18:41] INFO: Uploading contents to: http://ADMINIB-EAOPVNR:8006/ifcr/sites/lifestyle/content
[05.05.15 12:18:42] INFO: Finished uploading contents.
[05.05.15 12:18:43] INFO: Checking definition from AppConfig.xml against existing EAC provisioning.
[05.05.15 12:18:44] INFO: Definition has not changed.
[05.05.15 12:18:44] INFO: Packaging contents for upload...
[05.05.15 12:18:44] INFO: Finished packaging contents.
[05.05.15 12:18:44] INFO: Uploading contents to: http://ADMINIB-EAOPVNR:8006/ifcr/sites/lifestyle/pages
[05.05.15 12:18:44] INFO: Finished uploading contents.
Finished importing sample content
Importing editors configuration...
[05.05.15 12:18:45] INFO: Checking definition from AppConfig.xml against existing EAC provisioning.
[05.05.15 12:18:46] INFO: Definition has not changed.
[05.05.15 12:18:46] INFO: Packaging contents for upload...
[05.05.15 12:18:46] INFO: Finished packaging contents.
[05.05.15 12:18:46] INFO: Uploading contents to: http://ADMINIB-EAOPVNR:8006/ifcr/sites/lifestyle/configuration/tools/xmgr
[05.05.15 12:18:46] INFO: Finished uploading contents.
Finished importing editors configuration
Importing media...
[05.05.15 12:18:47] INFO: Checking definition from AppConfig.xml against existing EAC provisioning.
[05.05.15 12:18:47] INFO: Definition has not changed.
[05.05.15 12:18:47] INFO: Packaging contents for upload...
[05.05.15 12:18:48] INFO: Finished packaging contents.
[05.05.15 12:18:48] INFO: Uploading contents to: http://ADMINIB-EAOPVNR:8006/ifcr/sites/lifestyle/media
[05.05.15 12:18:49] INFO: Finished uploading contents.
Finished importing media
Importing templates...
Removing existing cartridge templates for lifestyle
Setting new cartridge templates for lifestyle
Finished setting templates
Finished importing templates



Run load_baseline_test_data.bat



C:\Endeca\Apps\lifestyle\control>load_baseline_test_data.bat

C:\Endeca\Apps\lifestyle\config\script\..\..\test_data\baseline\camerastore.xml.gz
        1 file(s) copied.
Setting flag 'baseline_data_ready' in the EAC.



Run baseline_update.bat



C:\Endeca\Apps\lifestyle\control>baseline_update.bat
[05.06.15 01:11:14] INFO: Checking definition from AppConfig.xml against existing EAC provisioning.
[05.06.15 01:11:15] INFO: Updating provisioning for component 'DailyReportGenerator'.
[05.06.15 01:11:15] INFO: Updating definition for component 'DailyReportGenerator'.
[05.06.15 01:11:15] INFO: Definition updated.
[05.06.15 01:11:15] INFO: Starting baseline update script.
[05.06.15 01:11:15] INFO: Acquired lock 'update_lock'.
[05.06.15 01:11:15] WARNING: Baseline data not ready for processing.
[05.06.15 01:11:15] INFO: Released lock 'update_lock'.
[05.06.15 01:11:15] INFO: Baseline update script finished.



Run promote_content.bat



C:\Endeca\Apps\lifestyle\control>promote_content.bat
[05.06.15 01:11:55] INFO: Checking definition from AppConfig.xml against existing EAC provisioning.
[05.06.15 01:11:56] INFO: Definition has not changed.
[05.06.15 01:11:56] INFO: Promoting IFCR content...
[05.06.15 01:11:58] INFO: Finished promoting IFCR content.



Final Step:


Verify lifeStyle in Endeca Workbench by accessing below URL

http://localhost:8006  

Also check access your lifestyle application by accessing below URL

http://localhost:8006/lifestyle


Thats It.




Endeca Issues When creating Any App:



Some times when you are trying to execute baseline_update.bat,  you may face below issues.


C:\Endeca\Apps\lifestyle\control>baseline_update.bat

[05.05.15 12:19:45] INFO: Checking definition from AppConfig.xml against existing EAC provisioning.
[05.05.15 12:19:45] INFO: Definition has not changed.
[05.05.15 12:19:45] INFO: Starting baseline update script.
[05.05.15 12:19:45] INFO: Acquired lock 'update_lock'.
[05.05.15 12:19:46] INFO: [ITLHost] Starting shell utility 'move_-_to_processing'.
[05.05.15 12:19:47] INFO: [ITLHost] Starting copy utility 'fetch_config_to_input_for_forge_Forge'.
[05.05.15 12:19:48] INFO: [ITLHost] Starting backup utility 'backup_log_dir_for_component_Forge'.
[05.05.15 12:19:49] INFO: [ITLHost] Starting component 'Forge'.
[05.05.15 12:19:54] INFO: [ITLHost] Starting backup utility 'backup_log_dir_for_component_Dgidx'.
[05.05.15 12:19:55] INFO: [ITLHost] Starting component 'Dgidx'.
[05.05.15 12:20:01] SEVERE: Batch component  'Dgidx' failed. Refer to component logs in C:\Endeca\Apps\lifestyle\config\script\..\..\.\logs\dgidxs\Dgi
dx on host ITLHost.
Occurred while executing line 25 of valid BeanShell script:
[[

22|        Forge.archiveLogDir();
23|        Forge.run();
24|        Dgidx.archiveLogDir();
25|        Dgidx.run();
26|
27|        // distributed index, update Dgraphs
28|        DistributeIndexAndApply.run();

]]

[05.05.15 12:20:01] SEVERE: Caught an exception while invoking method 'run' on object 'BaselineUpdate'. Releasing locks.

Caused by java.lang.reflect.InvocationTargetException
sun.reflect.NativeMethodAccessorImpl invoke0 - null
Caused by com.endeca.soleng.eac.toolkit.exception.AppControlException
com.endeca.soleng.eac.toolkit.script.Script runBeanShellScript - Error executing valid BeanShell script.
Caused by com.endeca.soleng.eac.toolkit.exception.EacComponentControlException
com.endeca.soleng.eac.toolkit.component.BatchComponent run - Batch component  'Dgidx' failed. Refer to component logs in C:\Endeca\Apps\lifestyle\conf
ig\script\..\..\.\logs\dgidxs\Dgidx on host ITLHost.

[05.05.15 12:20:01] INFO: Released lock 'update_lock'.



Solution: 


1. This issue will occur only when your Mdex Engine is not started properly.

Go to Windows ==> Run ==> Type "Services.msc"

And Start/Restart Endeca Mdex will resolve this issue.






























Popular Posts