[jira] [Created] (UNOMI-797) glitches and minor bugs in unomi 2 migration documentation

["Romain Gauthier (Jira)" <ji...@apache.org>]

Romain Gauthier created UNOMI-797:
-------------------------------------

             Summary: glitches and minor bugs in unomi 2 migration documentation
                 Key: UNOMI-797
                 URL: https://issues.apache.org/jira/browse/UNOMI-797
             Project: Apache Unomi
          Issue Type: Task
            Reporter: Romain Gauthier




*Upgrade jCustomer to 1.5.7+*
=> Ensure that jCustomer is already running in a version equal or superior to 1.5.7 

https://unomi.apache.org/manual/latest/index.html#_from_version_1_6_to_2_0 
*7.1. FROM VERSION 1.6 TO 2.0*
=> We mention 1.5.7+ in the academy and on unomi it says 1.6.0 

*Enable debug mode*
=> link not working 

*what_s_new* 
=> link not working 

*with all of the necessary JSON Schemas for its own operation*
=> + as well as all operations generated from the unomi web tracker 


*When creating your new schemas, reviewing debug messages in the logs (using: `log:set DEBUG org.apache.unomi.schema.impl.SchemaServiceImpl` in Karaf console), will point to errors in your schemas or will help you diagnose why the events are not being accepted.*
=> since https://jira.jahia.org/browse/UNOMI-796 , we should mention "Set UNOMI_LOGS_JSONSCHEMA_LEVEL env variable to DEBUG then restart jCustomer" 


*This requires making sure that you don’t allow open properties by using JSON schema keywords such as [unevaluated properties](https://json-schema.org/understanding-json-schema/reference/object.html#unevaluated-properties)*
=> Is it grammatically correct? 

*Your Elasticsearch cluster has enough capacity to handle the migration*
=> How are people supposed to know?

*Start an Apache Unomi 2.0 migration node*
- => Does the migration start automatically? 


We do not mention how https://issues.apache.org/jira/browse/UNOMI-754 / /cxs/jsonSchema/validateEvent can help 



--
This message was sent by Atlassian Jira
(v8.20.10#820010)