| // |
| // Licensed under the Apache License, Version 2.0 (the "License"); |
| // you may not use this file except in compliance with the License. |
| // You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, software |
| // distributed under the License is distributed on an "AS IS" BASIS, |
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| // See the License for the specific language governing permissions and |
| // limitations under the License. |
| // |
| === Five Minutes QuickStart |
| |
| 1) Install JDK 8 (https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) and make sure you set the |
| JAVA_HOME variable https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/ (see our <<JDK compatibility,Getting Started>> guide for more information on JDK compatibility) |
| |
| 2) Download ElasticSearch here : https://www.elastic.co/downloads/past-releases/elasticsearch-7-4-2 (please <strong>make sure</strong> you use the proper version : 7.4.2) |
| |
| 3) Uncompress it and change the `config/elasticsearch.yml` to include the following config : <code>cluster.name: contextElasticSearch</code> |
| |
| 4) Launch ElasticSearch using : `bin/elasticsearch` |
| |
| 5) Download Apache Unomi here : https://unomi.apache.org/download.html |
| |
| 6) Start it using : `./bin/karaf` |
| |
| 7) Start the Apache Unomi packages using `unomi:start` in the Apache Karaf Shell |
| |
| 8) Wait for startup to complete |
| |
| 9) Try accessing https://localhost:9443/cxs/cluster with username/password: `karaf/karaf` . You might get a certificate warning in your browser, just accept it despite the warning it is safe. |
| |
| 10) Request your first context by simply accessing : http://localhost:8181/context.js?sessionId=1234 |
| |
| 11) If something goes wrong, you should check the logs in `./data/log/karaf.log`. If you get errors on ElasticSearch, |
| make sure you are using the proper version. |
| |
| Next steps: |
| |
| - Connect to http://localhost:8181 to try our some live examples (such as the web tracker) |
| - Trying our integration <<Samples,samples page>> |
| - Learning more about the <<Web Tracker,web tracker>> |