fa4205a3ccc2cba98d28a9ed55651e438711a98f
wiki/howto/onboarding.md
| ... | ... | @@ -9,7 +9,7 @@ First of all, make sure you've looked at [http://www.amazon.de/Patterns-Elements |
| 9 | 9 | #### Installations |
| 10 | 10 | |
| 11 | 11 | 1. Eclipse (Eclipse IDE for Eclipse Committers, version 4.15.0 ["2020-03"]https://www.eclipse.org/downloads/packages/release/2020-03/r/eclipse-ide-eclipse-committers)), [http://www.eclipse.org](http://www.eclipse.org) |
| 12 | -2. Get the content of the git repository (see |
|
| 12 | +2. Get the content of the git repository (see |
|
| 13 | 13 | Steps to build and run the Race Analysis Suite below) |
| 14 | 14 | 3. Install the eclipse plugins (see Automatic Eclipse plugin installation below) |
| 15 | 15 | 4. Git (e.g. Git for Windows v2.18), [http://git-scm.com](http://git-scm.com) / [https://git-for-windows.github.io](https://git-for-windows.github.io) |
| ... | ... | @@ -28,9 +28,12 @@ The necessary Eclipse plugins described above can be automatically be installed |
| 28 | 28 | |
| 29 | 29 | Be aware that with this script it's not possible to update the plugins to newer versions. Instead you can install a new version by unpacking the base package and executing the script. |
| 30 | 30 | |
| 31 | -On Windows you need a Git Bash or Cygwin shell to run the script. In addition you need to replace all backslashes with forward slashes. |
|
| 31 | +###### On Windows |
|
| 32 | +You need a Git Bash or Cygwin shell to run the script. In addition you need to replace all backslashes with forward slashes. |
|
| 32 | 33 | |
| 33 | -On Mac OS, it's not sufficient to provide the path to the app, instead you need to get the path to the directory inside of the app package hosting the "eclipse" binary (.../Eclipse.app/Contents/MacOS). |
|
| 34 | +###### On Mac OS: |
|
| 35 | +- Before running the script, start eclipse and install **GWT Plugin** manually from repository [http://storage.googleapis.com/gwt-eclipse-plugin/v3/release](http://storage.googleapis.com/gwt-eclipse-plugin/v3/release) |
|
| 36 | +- It's not sufficient to provide the path to the app, instead you need to get the path to the directory inside of the app package hosting the "eclipse" binary (.../Eclipse.app/Contents/MacOS). |
|
| 34 | 37 | |
| 35 | 38 | Be aware hat the installation may take several minutes depending on your Internet connection. When the script finished running, please check that no errors occurred (the installation process only logs errors but doesn't fail). |
| 36 | 39 | |
| ... | ... | @@ -95,7 +98,7 @@ The primary Git repository for the project is hosted on sapsailing.com. It is mi |
| 95 | 98 | * In Eclipse go to "Window->Preferences->Java->Build Path->Classpath Variables" and create a new classpath variable called ``ANDROID_HOME``. Set its value to the install location of your Android SDK, e.g., ``c:\apps\android-sdk-windows`` or ``/usr/local/android-sdk-linux``. |
| 96 | 99 | * Install GWT SDK and add the SDK in Eclipse (Preferences -> GWT -> GWT Settings -> Add...) |
| 97 | 100 | * In "Window->Preferences->GWT->Errors/Warnings, set "Missing SDK" to "Ignore" |
| 98 | - * In "Window->Preferences->General->Editors->TextEditors" check Insert Spaces for Tabs |
|
| 101 | + * In "Window->Preferences->General->Editors->TextEditors" check Insert Spaces for Tabs |
|
| 99 | 102 | * In "Window->Preferences->Web->HTML Files->Editor" indent using Spaces |
| 100 | 103 | * In "Window->Preferences->General->Content Types" select on the right side CSS, now add in the lower file association list *.gss to get limited syntax highlighting and content assist in GSS files |
| 101 | 104 | * Install Eclipse debugger for GWT SuperDevMode |
| ... | ... | @@ -108,12 +111,15 @@ The primary Git repository for the project is hosted on sapsailing.com. It is mi |
| 108 | 111 | * Set the Eclipse target platform to race-analysis-p2-remote.target (located in com.sap.sailing.targetplatform/definitions) |
| 109 | 112 | * Wait until the target platform has been resolved completely |
| 110 | 113 | * Rebuild all projects |
| 111 | -4. Run the Race Analysis Suite |
|
| 112 | - * Start the MongoDB (cd /somePathTo MongoDB/mongodb/bin; rm c:/data/SAP/sailing/mongodb/mongod.lock; ./mongod --dbpath c:/data/SAP/sailing/mongodb) |
|
| 114 | +4. On clear workspace additional steps should be performed once: |
|
| 115 | + 1. Run "GWT Dashboards SDM" launch configuration. After successful start, launch configuration can be stopped. |
|
| 116 | + 2. Run "GWT Security SDM" launch configuration. After successful start, launch configuration can be stopped. |
|
| 117 | +5. Run the Race Analysis Suite |
|
| 118 | + * Start the MongoDB (cd /somePathTo MongoDB/mongodb/bin; rm c:/data/SAP/sailing/mongodb/mongod.lock; ./mongod --dbpath c:/data/SAP/sailing/mongodb) |
|
| 113 | 119 | * Start the appropriate Eclipse launch configuration (e.g. 'Sailing Server (no Proxy)') You´ll find this in the debug dropdown |
| 114 | 120 | * <del>Run "Security UI sdm" in the debug dropdown</del> (obsolete) |
| 115 | - * Run "SailingGWT sdm" in the debug dropdown |
|
| 116 | -5. Import races within the Race Analysis Suite |
|
| 121 | + * Run "GWT Sailing SDM" in the debug dropdown |
|
| 122 | +6. Import races within the Race Analysis Suite |
|
| 117 | 123 | * <del>Choose "Security UI sdm" in the upper left corner of the "Development Mode" Tab in Eclipse and open "...Login.html" in your browser</del> (obsolete) |
| 118 | 124 | * Choose "GWT Sailing SDM" in the "Development Mode" Tab and open "...AdminConsole.html..." (It is normal that the first try fails. Reload the page after the first try) |
| 119 | 125 | * Default Login: user "admin", password "admin" |
| ... | ... | @@ -178,7 +184,7 @@ The Android Apps can be built in Android Studio or gradle command line. Android |
| 178 | 184 | * choose "add root" from "Unregistered VCS root detected" (you can add this later, if you missed it) |
| 179 | 185 | 3. Setup the Android SDK |
| 180 | 186 | * in Android Studio press Tools -> Android -> SDK Manager |
| 181 | - * Install from section "Tools" (hint: carefull not to update |
|
| 187 | + * Install from section "Tools" (hint: carefull not to update |
|
| 182 | 188 | * Android SDK Tools |
| 183 | 189 | * Android SDK Platform-tools |
| 184 | 190 | * Android SDK Build-tools 22.0.1 (latest version at the time of writing) |