1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
> **⚠️ DEPRECATED:** This project is no longer maintained. No further updates, bug fixes, or feature additions will be made. Use at your own risk.
Quick howto for the NetCalendar
===============================
```
I. HOW TO START THE NETCALENDAR STAND ALONE (WITHOUT SSL):
II. HOW TO START THE NETCALENDAR DISTRIBUTED (WITHOUT SSL):
III. HOW TO START THE NETCALENDAR DISTRIBUTED (WITH SSL):
IV. MORE OPTIONS
V. INFORMATIONS CONCERNING THE COLORS BEING USED WITHIN THE NETCALENDAR CLIENT:
VI. USING THE UNIX CALENDAR DATABASE
```
## I. HOW TO START THE NETCALENDAR STAND ALONE (WITHOUT SSL):
You need at least a JRE 6 or higher. The command
```
java -jar NetCalendar.jar --client-and-server
```
is starting the client and the server of the NetCalendar within the same
process as two different threads. The option "server_address" will be set
automatically to "localhost". The communication between both threads is done
per TCP/IP.
## II. HOW TO START THE NETCALENDAR DISTRIBUTED (WITHOUT SSL):
1. Server and client should use, if possible, the same version of the JRE.
2. You should copy the complete NetCalendar suite to the client and the server
computer.
3. Start the server with `java -jar NetCalendar.jar --server-only`
4. Start the client with `java -jar NetCalendar.jar --client-only --server-address=$SERVERHOST`
In order to stop the server, select "Server -> Shutdown server" in the GUI of
the client.
## III. HOW TO START THE NETCALENDAR DISTRIBUTED (WITH SSL):
1. Server and client should use, if possible, the same version of the JRE.
2. You should copy the complete NetCalendar suite to the client and the server
computer. On edit on both sides (server and client) the netcalendar.conf and
set use_ssl to true.
3. You should create clientKeys,clientTrust,serverKeys and serverTrust as
discribed in http://www.ibm.com/developerworks/java/library/j-customssl/ and
save them for example into ./SSL.
3. Start the server with
```
java \
-Djavax.net.ssl.keyStore=./SSL/serverKeys \
-Djavax.net.ssl.keyStorePassword=$PASSWORD \
-Djavax.net.ssl.trustStore=./SSL/serverTrust \
-Djavax.net.ssl.trustStorePassword=$PASSWORD \
-jar NetCalendar.jar --server-only
```
4. Start the client with
```
java \
-Djavax.net.ssl.keyStore=./SSL/clientKeys \
-Djavax.net.ssl.keyStorePassword=$PASSWORD \
-Djavax.net.ssl.trustStore=./SSL/clientTrust \
-Djavax.net.ssl.trustStorePassword=$PASSWORD \
-jar NetCalendar.jar --client-only --server-address=$SERVERHOST
```
## IV. MORE OPTIONS
All options will be set to their default values while starting the NetCalendar
without any explicit options given.
If you want to see more available parameters, then run the command
```
java -jar NetCalendar.jar --help
```
It is possible to configure the NetCalendar by editing the configuration file
which is "netcalendar.conf". However, the preferred way is using the client
GUI via "Session -> Preferences".
## V. INFORMATIONS CONCERNING THE COLORS BEING USED WITHIN THE NETCALENDAR CLIENT:
* Blue in the "Date" column: Yearly event
* Green in the "Date" column: The event will take place only once
* Red: Event takes place within the next 24h
* Orange: Event takes place within the next week
* Yellow: Event takes place within the next 28 days
* Dark: Event takes place within the next 168 days (~ 1/2 year)
* Light beige: Event takes place within the next 365 days (1 year)
* Grey: Event takes place after 365 days
## VI. USING THE UNIX CALENDAR DATABASE
If you are using the `calendar` tool on UNIX, you can use `~/.calendar`` as your
NetCalendar database dir :)
|
