Child pages
  • Developing

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

FenixEdu applications run on any of the major operating systems (Linux, Mac OS and Windows) without any issue. However, the setup process on *nix machines tends to be much easier.

You must ensure that your OS is 64-bit, or else some weird behavior might happen.

Java

Most FenixEdu applications run on top of the Java platform. As such, to develop and run any application, you must have JDK 8 installed on your machine. You may choose between Oracle's JDK and OpenJDK, as long as they are on the latest version. Refer to your OS/distribution's documentation for the installation procedure.

...

This will set the initial heap size to 4GB, maximum heap size to 8GB, initial metaspace size to 256MB (to prevent full GC collections on startup), ensure the application runs in headless mode, enable the G1 Garbage Collector. The last flag is required for some legacy applications, see 

Jira
serverFenixEdu JIRA
columnskey,summary,type,created,updated,assignee,reporter,priority,status,resolution
serverId4731d9a1-2830-3e4a-87ac-7427a397e68b
keyACDM-472
. You may want to tune the heap size values according to your computer's hardware configuration.

MySQL/MariaDB

...

FenixEdu applications run on top of a MySQL or MariaDB database, using the InnoDB engine. As such, if you want to run a local database, you will have to install it on your machine. If you want to run a "large" database, you may need to tweak some configurations in your my.cnf file. The most important settings to tweak are the following:

Code Block
languagetext
titlemy.cnf
open_files_limit = 500000
max_connections		= 1000
max_allowed_packet	= 1G
thread_cache_size       = 128
default_storage_engine	= InnoDB
innodb_buffer_pool_size	= 20G
# Match this to the size in gigabytes of buffer_pool_size
innodb_buffer_pool_instances = 20
innodb_log_buffer_size	= 128M
innodb_log_file_size	= 1G
innodb_file_per_table	= 1
innodb_open_files	= 200000
innodb_io_capacity	= 400
innodb_flush_method	= O_DIRECT
innodb_autoinc_lock_mode = 2
innodb_flush_log_at_trx_commit = 0
innodb_read_io_threads = 32
innodb_write_io_threads = 32
innodb_io_capacity = 10000
innodb_fast_shutdown = 0

You will need to adjust the exact values according to your machine's hardware configuration. These values are for a dedicated machine with 8 cores and 32GB or RAM.

Hardware

This section contains some guidelines regarding the best hardware choices for developing FenixEdu applications.

...