data_crow_client_server_howto.pdf

(586 KB) Pobierz
Data Crow
Client - Server
Written by Robert Jan van der Waals | July 3, 2015 |
Version 1.4 | Based on Data Crow 4.1
I
NTRODUCTION
Since Data Crow 4.0 it is possible to run Data Crow as a server. With version 4.1
a web module has been added. The server is a hybrid between an old fashioned
application server and a web server. To one server both full clients and web
clients can connect. This delivers ultimate flexibility.
Please note that the non-web clients will be slower compared to the web
clients as they required more bandwidth as the actual (encrypted) data is
transferred to the connecting client. A web client just downloads the pages
from the server.
2
D
ATA
C
ROW
S
ERVER
S
ETUP
Download the server distribution from
http://www.datacrow.net#downloads
as well as a client version (either the installer or the zipped version).
D
ATA
C
ROW
U
SER
F
OLDER
Data Crow can use existing user folders (databases and settings) or can initialize
a new user folder to start with a clean slate.
I
NSTALL
THE
S
ERVER
Here we’ll setup the server software:
Unzip the zipped Data Crow Server distribution to the installation location.
3
R
UNNING
THE
S
ERVER
The server has no graphical user interface (GUI) which means it relies fully on
the command line. Open the terminal (Linux and Mac users) / command
prompt (Windows users) and navigate to the Data Crow Server installation
folder.
In the below example I will show
<command>
for the Data Crow start
command;
For Windows users substitute this with:
o
datacrow-server32bit.exe or
This is in case you have installed the 32bit version of
Java.
datacrow-server64bit.exe
This is in case you have installed the 64bit version of
Java.
o
For other platforms use:
o
Java –Xmx1024m –jar datacrow-server.jar
The –Xmx1024m parameter specifies the amount of memory
available to Data Crow. You can change this to another number if
necessary.
Now we are ready to start the server.
<command> -userdir:<user folder> –port:<portnumber>
–imageserverport:<portnumber> -webserverport:<portnumber>
–credentials:<username>/<password>
Explanation:
The <Command> I have explained above, make sure you use the correct
syntax for the platform you are using.
-userdir:
specifies the user folder location.
Example
(Windows):
-userdir:c:/server-data
-port:
specifies the main port number for the application server. The
default port is 9000. If you do not supply the port parameter, port 9000
will be used.
Example:
-port:9000
When the server has been started, clients connect by starting the Data
Crow Client in client mode (-client parameter):
datacrow64bit.exe -client, datacrow32bit.exe -client or java –Xmx512m
datacrow.jar -client (depending on your environment).
4
-imageserverport:
specifies the port to use for the HTTP image
server. The default is port 9001. If you do not supply the port parameter,
port 9001 will be used.
Example:
- imageserverport:9001
-webserverport:
specifies the port to use for the web server. If not
supplied, the web server module will not be started.
Example:
- webserverport:8080
When started, clients connect to the server as follows:
http://<server address>:<webserverport>/datacrow
Example:
http://192.168.178.12:8080/datacrow
-credentials:
username and password for the administrator. This is a
required parameter for security reasons. The default user for Data Crow is
SA with a blank password. It is recommended to set a password for each
user when using the client-server setup.
Example #1 (user rwaals, pw 123456):
-credentials:rwaals/123456
Example #2 (default user):
-credentials:SA
A tip on the credentials; you can also supply these within the
datacrow.credentials
file. When this file is present in the installation folder of
the Data Crow server Data Crow will read the credentials from this file and they
don’t have to be supplied anymore as a parameter. The file does not exist by
default; create the file (a plain text file) and enter the credentials within this
file: <username>/<password>. For example
rwaals/123456
5
Zgłoś jeśli naruszono regulamin