Database - FORMCYCLE Wiki

author	version	line-number	content
1	{{content/}}
2
3	{{formcycle/}} requires a pre-existing database for storing system related data. When installing {{formcycle/}}, the database structure is initialized automatically by the system. You only need to provide a connection to working database.
4
5	{{warning}}
6	{{formcycle case="dat"/}}no longer supplies database drivers. It is necessary to install the appropriate database driver for the database management system you are using.
7
8	Further information can be found [[here>>doc:Formcycle.SystemSettings.DatabaseDrivers]].
9	{{/warning}}
10
11	== Database connection ==
12
13	{{figure image="database_settings_en.png" width="600"}}
14	The settings for the database connection. After you change these settings, the database and the system gets updated automatically.
15	{{/figure}}
16
17	; Database type
18	: Select the database type of the database you would like to use.
19	; JDBC connection URL
20	: Every database has got slightly different URL for establishing a connection. Click on the //example// button to the right to see a list of common URLs.
21	; Database user
22	: User name for the database login.
23	; DB password
24	: Password for the database login.
25
26	== Advanced settings
27
28	; Connections
29	: The maximum number of connections between {{formcycle/}} and the database at any given time.
30	; Timeout
31	: The time an open connection between must remain idle for the connection between {{formcycle/}} and the database to be closed. When set to 0, no timeout is applied.
32
33	== Database encryption ==
34
35	{{formcycle/}} provides the option to enable encryption for the database to prevent against unauthorized access. Meta data is always encrypted and form data may be encrypted optionally.
36
37	To activate encryption, you must set the following options:
38
39	; Algorithm ===
40	: The encryption alogrithm to be used. The default is //PBE with SHA and Twofish-CBC (recommended)//.
41	; Encrypt form data
42	: Enable this option to encrypt data of submitted forms including all attachments. When you use a mySQL database, [[form specific data tables>>Formcycle.UserInterface.MyForms.Inbox]] are encrypted as well.
43	; Update encryption of data sets
44	: When thic option is checked, the data gets encrypted with the entered password.
45	; Password confirmation
46	: The password used to encrypt the data with the selected algorithm.
47
48	{{info}}
49	When you enter a passwort, the system checks whether that password is valid. This prevents data loss and data from being encrypted twice. Please note that this feature is available only since version 6. When you update from version 5 to version 6, the password cannot be checked.
50	{{/info}}
51
52	{{warning}}
53	Depening on the chosen encryption algorithm, the password and the Java version you are using it may become necessary to install the //Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files//. If these files are missing, an appropriate error message will be displayed.
54	{{/warning}}
55
56	== Migrating data sets ==
57
58	Enable the option //Update encryption of data sets// to migrate existing, encrypted data. The encrypted data is decrypted with the password entered in //Password confirmation// and encrypted again with the new password.
59
60	== Create or update the database ==
61
62	Click on //Save and update// to continue to update the database and system. If the database is empty, new tables will be created. Otherwise, the database is updated. Once the database is up-to-date, all necessary system updates are run automatically.

{{formcycle/}} requires a pre-existing database for storing system related data. When installing {{formcycle/}}, the database structure is initialized automatically by the system. You only need to provide a connection to working database.

4

5

6

{{formcycle case="dat"/}}no longer supplies database drivers. It is necessary to install the appropriate database driver for the database management system you are using.

7

8

Further information can be found [[here>>doc:Formcycle.SystemSettings.DatabaseDrivers]].

9

10

11

== Database connection ==

12

13

14

The settings for the database connection. After you change these settings, the database and the system gets updated automatically.

; Database type

: Select the database type of the database you would like to use.

19

; JDBC connection URL

20

: Every database has got slightly different URL for establishing a connection. Click on the //example// button to the right to see a list of common URLs.

21

; Database user

22

: User name for the database login.

23

; DB password

24

: Password for the database login.

== Advanced settings

; Connections

: The maximum number of connections between {{formcycle/}} and the database at any given time.

30

; Timeout

31

: The time an open connection between must remain idle for the connection between {{formcycle/}} and the database to be closed. When set to 0, no timeout is applied.

32

33

== Database encryption ==

34

35

{{formcycle/}} provides the option to enable encryption for the database to prevent against unauthorized access. Meta data is always encrypted and form data may be encrypted optionally.

36

37

To activate encryption, you must set the following options:

38

39

; Algorithm ===

40

: The encryption alogrithm to be used. The default is //PBE with SHA and Twofish-CBC (recommended)//.

41

; Encrypt form data

42

: Enable this option to encrypt data of submitted forms including all attachments. When you use a mySQL database, [[form specific data tables>>Formcycle.UserInterface.MyForms.Inbox]] are encrypted as well.

43

; Update encryption of data sets

44

: When thic option is checked, the data gets encrypted with the entered password.

45

; Password confirmation

46

: The password used to encrypt the data with the selected algorithm.

47

48

49

When you enter a passwort, the system checks whether that password is valid. This prevents data loss and data from being encrypted twice. Please note that this feature is available only since version 6. When you update from version 5 to version 6, the password cannot be checked.

Depening on the chosen encryption algorithm, the password and the Java version you are using it may become necessary to install the //Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files//. If these files are missing, an appropriate error message will be displayed.

54

55

56

== Migrating data sets ==

57

58

Enable the option //Update encryption of data sets// to migrate existing, encrypted data. The encrypted data is decrypted with the password entered in //Password confirmation// and encrypted again with the new password.

59

60

== Create or update the database ==

61

62

Click on //Save and update// to continue to update the database and system. If the database is empty, new tables will be created. Otherwise, the database is updated. Once the database is up-to-date, all necessary system updates are run automatically.

Wiki source code of Datenbank

Navigation