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)