| ... |
... |
@@ -11,6 +11,10 @@ |
| 11 |
11 |
* the latest release of the reference implementation of JAX-WS, currently version 2.2.6 ([[http:~~/~~/jax-ws.java.net/>>url:http://jax-ws.java.net/||shape="rect"]]), and |
| 12 |
12 |
* the current version of graphviz ([[http:~~/~~/www.graphviz.org/Download.php>>url:http://www.graphviz.org/Download.php||shape="rect"]]). |
| 13 |
13 |
|
|
14 |
+{{info title="Note for Mac OS Users"}} |
|
15 |
+In case you start the server under Mac OS and have Security issues, try this [[fix >>doc:KIELER Pragmatics Release 0\.11\.0]]described in the //Viewing Ptolemy Models// section. |
|
16 |
+{{/info}} |
|
17 |
+ |
| 14 |
14 |
The server of KWebS is implemented in java. Therefore we begin the installation with the java runtime environment. The server uses a SOAP web service based on JAX-WS and the java platform comes with support for JAX-WS already. The included version is quite old, therefore, after you installed the java runtime, you need to update the built-in version by using the endorsed-mechanism from java: |
| 15 |
15 |
|
| 16 |
16 |
1. create a folder named {{code language="none"}}endorsed{{/code}} in the {{code language="none"}}lib{{/code}}-directory of the java runtime, and |
| ... |
... |
@@ -27,7 +27,7 @@ |
| 27 |
27 |
de.cau.cs.kieler.kwebs.graphviz.path=/usr/bin/dot |
| 28 |
28 |
{{/code}} |
| 29 |
29 |
|
| 30 |
|
-The next step is to decide which //service variants// you want to provide. There are three of them: |
|
34 |
+The next step is to decide which //service variants// you want to provide. There are two of them (plus the HTTP Post which is available via the support server): |
| 31 |
31 |
|
| 32 |
32 |
* SOAP over HTTP, |
| 33 |
33 |
* SOAP over HTTPS |
| ... |
... |
@@ -65,3 +65,11 @@ |
| 65 |
65 |
{{/code}} |
| 66 |
66 |
|
| 67 |
67 |
In the given example the key store is located at {{code language="none"}}security/my.jks{{/code}} relative to the servers root directory and the password is {{code language="none"}}MyPassword{{/code}}. |
|
72 |
+ |
|
73 |
+== Using the Start/Stop Scripts == |
|
74 |
+ |
|
75 |
+After an initial start of the {{code language="none"}}kwebs{{/code}} binary, kwebs_start.* and kwebs_stop.* scripts will be unpacked to the root directory. They can be used to properly start and stop the server via a management application. The application can only be contacted via local host. For the stop script to work properly the correct password and keystore have to be passed. The default values are shown next.\\ |
|
76 |
+ |
|
77 |
+{{code}} |
|
78 |
+-kp=mserver -kl=server/kwebs/security/keystores/mserver.jks |
|
79 |
+{{/code}} |