Skip to content
GitLab
Explore
Sign in
Register
Primary navigation
Search or go to…
Project
C
caosdb-server
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Iterations
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Locked files
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container registry
Model registry
Operate
Environments
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Code review analytics
Issue analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
caosdb
Software
caosdb-server
Commits
7b425e9a
Verified
Commit
7b425e9a
authored
3 years ago
by
Daniel Hornung
Browse files
Options
Downloads
Patches
Plain Diff
DOC: Mention the caosdb-proto submodule.
parent
3a55d6fa
Branches
Branches containing commit
Tags
Tags containing commit
1 merge request
!58
REL: prepare release 0.7.2
Pipeline
#18665
failed
3 years ago
Stage: info
Stage: setup
Stage: test
Stage: deploy
Changes
1
Pipelines
20
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README_SETUP.md
+11
-9
11 additions, 9 deletions
README_SETUP.md
with
11 additions
and
9 deletions
README_SETUP.md
+
11
−
9
View file @
7b425e9a
...
@@ -58,12 +58,14 @@ libpam0g-dev`. Then try again.
...
@@ -58,12 +58,14 @@ libpam0g-dev`. Then try again.
After a fresh clone of the repository, this is what you need to setup the
After a fresh clone of the repository, this is what you need to setup the
server:
server:
1.
Compile the server with
`make compile`
. This may take a while and there
1.
Install the
`proto`
submodule (and submodules for those extensions you want, see above):
`git submodule update --init caosdb-proto`
2.
Compile the server with
`make compile`
. This may take a while and there
needs to be an internet connection as packages are downloaded to be
needs to be an internet connection as packages are downloaded to be
integrated in the java file.
integrated in the java file.
1.
It is recommended to run the unit tests with
`make test`
. It may take a
1.
It is recommended to run the unit tests with
`make test`
. It may take a
while.
while.
2
.
Create an SSL certificate somewhere with a
`Java Key Store`
file. For
3
.
Create an SSL certificate somewhere with a
`Java Key Store`
file. For
self-signed certificates (not recommended for production use) you can do:
self-signed certificates (not recommended for production use) you can do:
-
`mkdir certificates; cd certificates`
-
`mkdir certificates; cd certificates`
-
`keytool -genkey -keyalg RSA -alias selfsigned -keystore caosdb.jks -validity 375 -keysize 2048 -ext san=dns:localhost`
-
`keytool -genkey -keyalg RSA -alias selfsigned -keystore caosdb.jks -validity 375 -keysize 2048 -ext san=dns:localhost`
...
@@ -77,11 +79,11 @@ server:
...
@@ -77,11 +79,11 @@ server:
Alternatively, you can create a keystore from certificate files that you already have:
Alternatively, you can create a keystore from certificate files that you already have:
-
`openssl pkcs12 -export -inkey privkey.pem -in fullchain.pem -out all-certs.pkcs12`
-
`openssl pkcs12 -export -inkey privkey.pem -in fullchain.pem -out all-certs.pkcs12`
-
`keytool -importkeystore -srckeystore all-certs.pkcs12 -srcstoretype PKCS12 -deststoretype pkcs12 -destkeystore caosdb.jks`
-
`keytool -importkeystore -srckeystore all-certs.pkcs12 -srcstoretype PKCS12 -deststoretype pkcs12 -destkeystore caosdb.jks`
3
.
Install/configure the MySQL back-end: see the
`README_SETUP.md`
of the
4
.
Install/configure the MySQL back-end: see the
`README_SETUP.md`
of the
`caosdb-mysqlbackend`
repository
`caosdb-mysqlbackend`
repository
4
.
Create an authtoken config (e.g. copy
`conf/core/authtoken.example.yaml`
to
5
.
Create an authtoken config (e.g. copy
`conf/core/authtoken.example.yaml`
to
`conf/ext/authtoken.yml`
and change it)
`conf/ext/authtoken.yml`
and change it)
5
.
Copy
`conf/core/server.conf`
to
`conf/ext/server.conf`
and change it
6
.
Copy
`conf/core/server.conf`
to
`conf/ext/server.conf`
and change it
appropriately:
appropriately:
*
Setup for MySQL back-end:
*
Setup for MySQL back-end:
specify the fields
`MYSQL_USER_NAME`
,
`MYSQL_USER_PASSWORD`
,
specify the fields
`MYSQL_USER_NAME`
,
`MYSQL_USER_PASSWORD`
,
...
@@ -94,7 +96,7 @@ server:
...
@@ -94,7 +96,7 @@ server:
`CERTIFICATES_KEY_STORE_PATH`
, and
`CERTIFICATES_KEY_STORE_PASSWORD`
.
`CERTIFICATES_KEY_STORE_PATH`
, and
`CERTIFICATES_KEY_STORE_PASSWORD`
.
Make sure that the conf file is not readable by other users because the
Make sure that the conf file is not readable by other users because the
certificate passwords are stored in plaintext.
certificate passwords are stored in plaintext.
-
Set the path to the authtoken config (see step 4)
*
Set the path to the authtoken config (see step 4)
*
Set the file system paths:
*
Set the file system paths:
-
`FILE_SYSTEM_ROOT`
: The root for all the files managed by CaosDB.
-
`FILE_SYSTEM_ROOT`
: The root for all the files managed by CaosDB.
-
`DROP_OFF_BOX`
: Files can be put here for insertion into CaosDB.
-
`DROP_OFF_BOX`
: Files can be put here for insertion into CaosDB.
...
@@ -112,8 +114,8 @@ server:
...
@@ -112,8 +114,8 @@ server:
-
`INSERT_FILES_IN_DIR_ALLOWED_DIRS`
: add mounted filesystems here that
-
`INSERT_FILES_IN_DIR_ALLOWED_DIRS`
: add mounted filesystems here that
shall be accessible by CaosDB
shall be accessible by CaosDB
*
Maybe set another
`SESSION_TIMEOUT_MS`
.
*
Maybe set another
`SESSION_TIMEOUT_MS`
.
*
See also
[
CONFIGURATION.rst
](
src/doc/administration/configuration.rst
)
*
See also
[
CONFIGURATION.rst
](
src/doc/administration/configuration.rst
)
6
.
Copy
`conf/core/usersources.ini.template`
to
`conf/ext/usersources.ini`
.
7
.
Copy
`conf/core/usersources.ini.template`
to
`conf/ext/usersources.ini`
.
*
You can skip this if you do not want to use an external authentication.
*
You can skip this if you do not want to use an external authentication.
Local users (CaosDB realm) are always available.
Local users (CaosDB realm) are always available.
*
Define the users/groups who you want to include/exclude.
*
Define the users/groups who you want to include/exclude.
...
@@ -128,7 +130,7 @@ server:
...
@@ -128,7 +130,7 @@ server:
Especially that there are no
`properties`
(aka
`keys`
) without a
Especially that there are no
`properties`
(aka
`keys`
) without a
`value`
. An emtpy value can be represented by
`""`
. Comments are
`value`
. An emtpy value can be represented by
`""`
. Comments are
everything from
`#`
or
`;`
to the end of the line.
everything from
`#`
or
`;`
to the end of the line.
7
.
Possibly install the PAM caller in
`misc/pam_authentication/`
if you have
8
.
Possibly install the PAM caller in
`misc/pam_authentication/`
if you have
not do so already. See above.
not do so already. See above.
Done!
Done!
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment