Status: Verified
GOAL:
Migrating an EasyAsk eCommerce Application from version 9.x to 10.1
FACT(s) (Environment):
EasyAsk Versions
EasyAsk 10.1
FIX:
New installation directory, or directory from uninstalled earlier version
1. Install version 10.1 in test environment
· Save serial number in install.properties file from previous install, if applicable (resides in the installation directory <EAinstall>)
· Run installation executable and supply serial number and other information
ü If a Windows Service is desired, don?t select Windows Service during install but instead, run EasyAsk Windows Service setup after initial installation
- NOTE: the new utility provides greater flexibility particularly with having multiple servers on the same machine and it provides a facility to uninstall the service w/o uninstalling EasyAsk.
ü Configuration files for a Service are given distinct names when using this utility:
- EasyAskServer_<servicename>_<port>.properties
- EasyAskServer_<servicename>_<port>.lax
- mso-ansi-language: FR">EasyAskServer_<servicename>_<port>.log
- EasyAskServer_<servicename>_<port>.exe
· Review 10.1 documentation included in the installation
2. Revise scripts and procedures
· Revise index and deployment script(s)
ü Note: The utilities in EasyAsk 10.1 are located in <EAinstall>/bin folder. In previous versions of EasyAsk, they were located in <EAinstall>
3. Configure properties for Server and other executables
· Properties files
ü Save .properties files from previous install, if applicable
ü Use a filediff utility to find custom settings in current .properties files
style="FONT-FAMILY: Wingdings; mso-fareast-font-family: Wingdings; mso-bidi-font-family: Wingdings">ü Apply custom settings to corresponding files in 10.1
· LAX files
ü Save .lax files from previous install, if applicable
ü Use filediff to find custom settings in current .lax files
ü Apply custom settings to corresponding files in 10.1
4. Copy existing application files to new configuration
· Copy db driver file(s) from \classes folder to same folder in 10.1
· Copy current dictionaries (not indexes) to new dictionaries folder
ü Default analytics dictionary is ecomlog.dxp but is often tailored with a name like ?ecomlogDB<Company>?.dxp
tab-stops: list 1.5in; mso-list: l2 level3 lfo1">ü Check EasyAsk.properties for AnalyticsDictName=<custom analytics dxp>
ü If present, copy custom analytics dictionary to 10.1
ü See solution P129125 for customizing the dashboard
· Copy any scheduled tasks to <install folder>\server\scheduler\tasks
· Copy any My Tasks configuration
ü Copy current <EAOldInstall>\server\tasks.xml to corresponding place in new install.
ü Copy the scripts themselves, if necessary, that are referenced in the xml
- You can use the Commerce Studio to edit this file (under Configuration|My Tasks)
- Review the scripts to verify that paths, etc., are still correct
· Files in <EAinstall>/server/dashboard may al.so have changes:
ü DashboardMenu.txt
ü AnalyticReports.txt
ü NOTE: The old files can just replace the new ones.
· If security has been turned on for the server, copy changes made to files in <EAinstall>\server\etc. (see Commerce Studio User?s Guide)
ü jetty.xml
ü webdefault.xml
ü NOTE: v10.1 has improved security control in the Studio. It?s very possible that enabling Studio security in the dictionary will provide more security than before (and may replace the current technique). Please see security section in the ?Commerce Studio User?s Guide?.
· Copy any EasyAsk server based UI code, if appropriate, from previous install
5. Test new configuration
="MARGIN: 0in 0in 0pt 63pt; TEXT-INDENT: -0.25in; tab-stops: list 63.0pt; mso-list: l2 level2 lfo1">· Index rebuild and deployment
· Regression test of most common recent searches
· Commerce Studio
ü Start EA Server and open a browser
ü Enter http://<machine>:<port>/EasyAsk/Studio/LaunchPad.jsp
· Web interface and load testing
· Logging and analytics
Overlay for installed 9.7 or 10.0 applications
NOTE: We recommend the above installation process for all versions before 9.7. Optionally, one can overlay an existing 9.7. or 10.0 installations to 10.1 using the following instructions:
1. Install version 10.1 in development environment
If you want multiple EasyAsk instances on the same machine then use same instructions as above.
If a single service, you can use the installer to install the service similarly to how it was created in previous installs. This will allow the system to utilize previous properties and lax files (see step C below).
2. Revise scripts and procedures (same as above)
3. Configure properties for Server and other executables
If a single service (or non-service) installations, the installer will keep your properties and lax files and write out a ?new? file for informational purposes.
For multiple services (same as above)
4. Copy existing application files to new configuration (same as above)
5. Test new configuration (same as above)
.