### Install Apache Web Server on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36 Installs Apache HTTP Server on Ubuntu systems. Includes steps for enabling SSL, loading the proxy_ajp module, and configuring the default SSL site. ```bash $ sudo apt install apache2 ``` ```bash $ sudo a2ensite default-ssl ``` ```bash $ sudo a2enmod ssl ``` ```bash $ sudo a2enmod proxy_ajp ``` ```bash $ systemctl restart apache2 ``` ```bash $ sudo vim /etc/apache2/sites-enabled/default-ssl.conf # Add the line ProxyPass/ajp://127.0.0.1:8010/ ``` ```bash $ sudo vim /etc/hosts # Add the line 127.0.0.1 bwidm-test.scc.kit.edu ``` ```bash $ systemctl restart apache2 ``` -------------------------------- ### Install PostgreSQL on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451&view=inline Installs PostgreSQL, a powerful open-source relational database system. This involves installing the common package, setting up the PostgreSQL APT repository, and then installing the PostgreSQL server. ```bash $ sudo apt install -y postgresql-common -y ``` ```bash $ sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash $ sudo apt install -y postgresql ``` -------------------------------- ### Install PgAdmin4 Desktop on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451&view=parallel Installs the PgAdmin4 desktop client for managing PostgreSQL databases using the apt package manager. ```bash $ sudo apt install pgadmin4-desktop ``` -------------------------------- ### Install PostgreSQL Server on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451&view=parallel Installs PostgreSQL server and related common utilities. This involves adding the PostgreSQL repository and then installing the 'postgresql' package. It also includes commands to restart and check the status of the PostgreSQL service, and to connect to the database. ```bash $ sudo apt install -y postgresql-common -y ``` ```bash $ sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash $ sudo apt install -y postgresql ``` ```bash $ sudo systemctl restart postgresql ``` ```bash $ sudo systemctl status postgresql ``` ```bash $ sudo -u postgres psql ``` -------------------------------- ### Install Apache Web Server on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451&view=inline Installs Apache2, a widely used web server software. This command also enables the default SSL site and necessary Apache modules (ssl, proxy_ajp) for secure connections and proxying. ```bash $ sudo apt install apache2 ``` ```bash $ sudo a2ensite default-ssl ``` ```bash $ sudo a2enmod ssl ``` ```bash $ sudo a2enmod proxy_ajp ``` ```bash $ systemctl restart apache2 ``` -------------------------------- ### Verify Java and Maven Installation (Shell) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Build/diff_version_id=dd6ecd8506ef6a34a700af2247d08706490532c9 This snippet shows the shell commands to verify the installed versions of Java and Apache Maven. It displays example output for both commands, confirming a successful installation. ```sh ~$ java -version java version "1.7.0_85" OpenJDK Runtime Environment (IcedTea 2.6.1) (7u85-2.6.1-6+deb8u1) OpenJDK 64-Bit Server VM (build 24.85-b03, mixed mode) ~$ mvn --version Apache Maven 3.3.1 (cab6659f9874fa96462afef40fcf6bc033d58c1c; 2015-03-13T21:10:27+01:00) ``` -------------------------------- ### Install PostgreSQL Server Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=b2752abe5444bb4e4ea5a7e9c827bf9f580c24d2 Installs the PostgreSQL database server and its common utilities on Ubuntu. It includes steps to configure the PostgreSQL repository and restart the service. ```bash sudo apt install -y postgresql-common -y sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) sudo apt install -y postgresql sudo systemctl restart postgresql sudo systemctl status postgresql ``` -------------------------------- ### Install PostgreSQL Server (Ubuntu) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=9d89400a8d154948aba2ef70d3527fd8a1e60d0f Installs PostgreSQL, a powerful open-source relational database system. This includes common setup utilities and the PostgreSQL server itself. ```bash sudo apt install -y postgresql-common -y ``` ```bash sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash sudo apt install -y postgresql ``` -------------------------------- ### Install PostgreSQL Database (Bash) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36&view=inline Installs PostgreSQL, a powerful open-source object-relational database system, and its common utilities. Includes steps for setting up the repository, installing PostgreSQL, restarting the service, checking its status, and accessing the psql client. ```bash sudo apt install -y postgresql-common -y ``` ```bash sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash sudo apt install -y postgresql ``` ```bash sudo systemctl restart postgresql ``` ```bash sudo systemctl status postgresql ``` ```bash sudo -u postgres psql ``` -------------------------------- ### Install Apache Web Server on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451&view=parallel Installs the Apache HTTP Server, a widely used web server, on Ubuntu using the apt package manager. ```bash $ sudo apt install apache2 ``` -------------------------------- ### Install Java OpenJDK 17 on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=b2752abe5444bb4e4ea5a7e9c827bf9f580c24d2&view=parallel This snippet demonstrates the command to install Java OpenJDK 17 on an Ubuntu system. It is a prerequisite for the development environment setup. ```markdown ```bash sudo apt update sudo apt install openjdk-17-jdk ``` ``` -------------------------------- ### Install PostgreSQL Database Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=956076e15c95606099b5735fdded61428546e7d4 Installs PostgreSQL, a powerful open-source relational database system. This sequence of commands handles common installation steps on Ubuntu, including adding the PostgreSQL repository and installing the server. ```bash sudo apt install -y postgresql-common -y ``` ```bash sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash $ sudo apt install -y postgresql ``` -------------------------------- ### Install PostgreSQL Database Server on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=17f6c7af7d4e6920dd8f8fe80f3fedb5b63e9b2b Installs PostgreSQL, a powerful open-source relational database system. This includes common packages and the PostgreSQL APT repository setup. ```bash sudo apt install -y postgresql-common -y ``` ```bash sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash sudo apt install -y postgresql ``` ```bash sudo systemctl restart postgresql ``` ```bash sudo systemctl status postgresql ``` -------------------------------- ### Verify Java and Maven Installation (Shell) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Build/diff_version_id=be0d3427da591b43ff3ab6412ba61bfe58286e97&view=inline This snippet shows how to verify your Java and Apache Maven installations by running their respective version commands. It displays example outputs for different versions of Java and Maven. ```shell ~$ java -version java version "1.7.0_85" OpenJDK Runtime Environment (IcedTea 2.6.1) (7u85-2.6.1-6+deb8u1) OpenJDK 64-Bit Server VM (build 24.85-b03, mixed mode) openjdk version "11.0.11" 2021-04-20 OpenJDK Runtime Environment (build 11.0.11+9-Ubuntu-0ubuntu2) OpenJDK 64-Bit Server VM (build 11.0.11+9-Ubuntu-0ubuntu2, mixed mode, sharing) ~$ mvn --version Apache Maven 3.3.1 (cab6659f9874fa96462afef40fcf6bc033d58c1c; 2015-03-13T21:10:27+01:00) Apache Maven 3.6.3 ``` -------------------------------- ### Install PostgreSQL on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451 Installs PostgreSQL, a powerful open-source object-relational database system, on Ubuntu. This includes common setup scripts, the PostgreSQL server, and restarting/checking its status. ```bash $ sudo apt install -y postgresql-common -y ``` ```bash $ sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash $ sudo apt install -y postgresql ``` ```bash $ sudo systemctl restart postgresql ``` ```bash $ sudo systemctl status postgresql ``` ```bash $ sudo -u postgres psql ``` ```bash postgres=# ALTER USER postgres WITH ENCRYPTED PASSWORD ''; ``` ```bash postgres=# CREATE USER db_manager ENCRYPTED PASSWORD ''; ``` ```bash postgres=# \q ``` ```bash $ sudo sed -i '/^local/s/peer/scram-sha-256/' /etc/postgresql/17/main/pg_hba.conf ``` ```bash $ sudo systemctl restart postgresql ``` -------------------------------- ### Install PgAdmin4 Desktop Client Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=b2752abe5444bb4e4ea5a7e9c827bf9f580c24d2 Installs the PgAdmin4 desktop client, a graphical user interface for managing PostgreSQL databases. This command is executed on Ubuntu using apt package manager. ```bash $ sudo apt install pgadmin4-desktop ``` -------------------------------- ### Install Maven Build Tool on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451&view=parallel Installs the Maven build automation tool using the apt package manager. Maven is used for managing project builds and dependencies. ```bash $ sudo apt install maven ``` -------------------------------- ### Configure Wildfly Server in Eclipse Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36 Guides through the process of setting up a Wildfly application server within the Eclipse IDE. This involves installing JBoss Tools, configuring server adapters, and specifying runtime details. ```bash # In Eclipse: # Help -> Eclipse Marketplace -> JBoss Tools -> Install # Window -> Show View -> Other -> Servers (Server) -> Open # Click 'No servers are available. Click this link to create a new server…' # JBoss Community -> WildFly 27+ -> Local -> Filesystem and shell operations -> Create new runtime # Home directory: /your/directory/wildfly-29.0.1.Final.tar.gz # Execution environment: JavaSE-17 # Configuration file: standalone-full-ha.xml # Add and Remove -> Select server and add to right panel -> Finish # Right click on WildFly 27+ -> Start ``` -------------------------------- ### Install Apache Web Server (Ubuntu) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=17cb2f73856c18bbf0d3fbcd6d2e771308e804c8 Installs the Apache2 web server and enables default SSL site, SSL module, and proxy_ajp module. It then restarts the Apache service. ```bash $ sudo apt install apache2 ``` ```bash $ sudo a2ensite default-ssl ``` ```bash $ sudo a2enmod ssl ``` ```bash $ sudo a2enmod proxy_ajp ``` ```bash $ systemctl restart apache2 ``` -------------------------------- ### Install Apache Web Server Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=b2752abe5444bb4e4ea5a7e9c827bf9f580c24d2 Installs the Apache web server and enables necessary modules for SSL and proxying AJP connections. It also configures a default SSL site and restarts the Apache service. ```bash $ sudo apt install apache2 $ sudo a2ensite default-ssl $ sudo a2enmod ssl $ sudo a2enmod proxy_ajp $ systemctl restart apache2 ``` -------------------------------- ### Configure WildFly Server in Eclipse Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=956076e15c95606099b5735fdded61428546e7d4 Guides through setting up a WildFly application server within Eclipse IDE. This involves installing JBoss Tools, configuring a new server runtime, and specifying the WildFly installation directory and configuration file. It also covers starting the WildFly server. ```bash Help` → `Eclipse Marketplace` → `JBoss Tools` → `Install` → Follow the steps → `Restart Eclipse` `Window` → `Show View` → `Other` → `Servers (Server)` → `Open` Click on the link “No servers are available. Click this link to create a new server…” provided on the Servers tab. `JBoss Community` →` WildFly 27+` → Choose `The server is`: `Local`, `Controlled by`: `Filesystem and shell operations`, `The selected profile requires a runtime`: `Create new runtime (next page)` Choose your desired wildfly file in `Home directory`: `/your/directory/wildfly-29.0.1.Final.tar.gz`, `Execution environment`: `JavaSE-17`, `Configuration file`: `standalone-full-ha.xml` → `Add and Remove` → Select the server and add it to the right panel → `Finish` Right click on the `WildFly 27+` → `Start` ``` -------------------------------- ### Install PostgreSQL Server (Ubuntu) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=17cb2f73856c18bbf0d3fbcd6d2e771308e804c8 Installs PostgreSQL common packages, sets up the PostgreSQL APT repository, installs the PostgreSQL server, restarts the service, checks its status, and connects to the database as the postgres user. It also includes commands to set the postgres user password and create a new database user. ```bash sudo apt install -y postgresql-common -y ``` ```bash sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash sudo apt install -y postgresql ``` ```bash sudo systemctl restart postgresql ``` ```bash sudo systemctl status postgresql ``` ```bash sudo -u postgres psql ``` ```bash postgres=# ALTER USER postgres WITH ENCRYPTED PASSWORD ''; ``` ```bash postgres=# CREATE USER db_manager ENCRYPTED PASSWORD ''; ``` ```bash postgres=# \q ``` -------------------------------- ### Install OpenJDK 17 on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451&view=parallel Installs the OpenJDK 17 JRE headless package for Java development. This command uses the apt package manager. ```bash $ sudo apt install openjdk-17-jre-headless ``` -------------------------------- ### Install PostgreSQL Database on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env Installs PostgreSQL, a powerful open-source relational database system, and its common utilities. It includes steps for configuring the PostgreSQL repository and restarting the service. ```bash sudo apt install -y postgresql-common -y $ sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) sudo apt install -y postgresql $ sudo systemctl restart postgresql $ sudo systemctl status postgresql ``` -------------------------------- ### Start Wildfly with Configuration Source: https://context7.com/context7/gitlab_kit_edu_kit_reg-app_regapp_wikis/llms.txt Provides the command to start the Wildfly application server using a specific standalone configuration file, 'standalone-full-ha.xml'. This command assumes the Wildfly binaries are in the system's PATH or the user is in the Wildfly installation directory. ```bash /opt/wildfly/bin/standalone.sh -c standalone-full-ha.xml ``` -------------------------------- ### Install Apache Web Server on Debian/Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36&view=parallel Installs Apache HTTP Server, a widely used web server, on Debian/Ubuntu systems. Includes steps for enabling SSL, loading the proxy_ajp module, and configuring virtual hosts. ```shell $ sudo apt install apache2 ``` ```shell $ sudo a2ensite default-ssl ``` ```shell $ sudo a2enmod ssl ``` ```shell $ sudo a2enmod proxy_ajp ``` ```shell $ systemctl restart apache2 ``` ```shell $ sudo vim /etc/apache2/sites-enabled/default-ssl.conf ``` ```shell $ sudo vim /etc/hosts ``` ```shell $ systemctl restart apache2 ``` -------------------------------- ### Wildfly JMS Subsystem Configuration Example Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Appserver/diff_version_id=872dccc6c00307d0d275ef6b303da83ff05c1356 XML snippet for configuring the Java Messaging Service (JMS) subsystem in Wildfly. This setup is necessary for the reg-app to process jobs using queues. ```xml ``` -------------------------------- ### Install PostgreSQL Database on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451 Installs PostgreSQL, a powerful open-source relational database system. This includes common utilities and the PostgreSQL server itself, followed by restarting and checking its status. ```bash sudo apt install -y postgresql-common -y ``` ```bash sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash $ sudo apt install -y postgresql ``` ```bash sudo systemctl restart postgresql ``` ```bash sudo systemctl status postgresql ``` -------------------------------- ### Create PostgreSQL Database and User Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Database/diff_version_id=c300d62a49e4fcf228623dc4fed7c372d37fcf23&view=inline This snippet shows the shell commands required to create a new user and an empty database for the RegApp in PostgreSQL. Ensure you have PostgreSQL installed and the 'postgres' user is accessible. ```shell su postgres createuser -P regapp-user createdb -O regapp-user regapp exit ``` -------------------------------- ### Install Apache Web Server on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=17f6c7af7d4e6920dd8f8fe80f3fedb5b63e9b2b Installs Apache2, a widely used open-source web server. This command also enables default SSL, SSL module, and proxy_ajp module, and restarts the server. ```bash $ sudo apt install apache2 ``` ```bash $ sudo a2ensite default-ssl ``` ```bash $ sudo a2enmod ssl ``` ```bash $ sudo a2enmod proxy_ajp ``` ```bash systemctl restart apache2 ``` -------------------------------- ### Install PgAdmin4 (Bash) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36&view=inline Installs PgAdmin4, a popular graphical administration and development platform for PostgreSQL. This tool simplifies database management tasks. ```bash sudo apt install pgadmin4-desktop ``` -------------------------------- ### Manage PostgreSQL Service and User Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451&view=inline Commands to restart the PostgreSQL service, check its status, connect to the database as the postgres user, set the postgres user's password, create a new database user, and exit the psql shell. ```bash $ sudo systemctl restart postgresql ``` ```bash $ sudo systemctl status postgresql ``` ```bash $ sudo -u postgres psql ``` ```bash postgres=# ALTER USER postgres WITH ENCRYPTED PASSWORD ''; ``` ```bash postgres=# CREATE USER db_manager ENCRYPTED PASSWORD ''; ``` ```bash postgres=# \q ``` -------------------------------- ### Install Apache Web Server (Ubuntu) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=9d89400a8d154948aba2ef70d3527fd8a1e60d0f Installs the Apache HTTP Server, a widely used web server software. It also enables necessary modules for SSL and proxying AJP connections. ```bash $ sudo apt install apache2 ``` ```bash $ sudo a2ensite default-ssl ``` ```bash $ sudo a2enmod ssl ``` ```bash $ sudo a2enmod proxy_ajp ``` ```bash $ systemctl restart apache2 ``` -------------------------------- ### Create PostgreSQL Database and User Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Database/diff_version_id=014c9c65e2858e694750e3aa63b6d2916e5c3994&view=inline This snippet demonstrates how to create a PostgreSQL database named 'regapp' and a user 'regapp-user' with the necessary ownership. It assumes you have PostgreSQL installed and accessible. ```shell createuser -P regapp-user createdb -O regapp-user regapp exit ``` -------------------------------- ### Install PgAdmin4 Desktop Client on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env Installs PgAdmin4, a popular graphical administration tool for PostgreSQL, using the apt package manager. This tool simplifies database management tasks. ```bash sudo apt install pgadmin4-desktop ``` -------------------------------- ### Install Apache Web Server (Bash) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36&view=inline Installs Apache2, a widely used web server, along with modules for SSL and proxying AJP connections. It also configures Apache to use a default SSL site and restarts the service. ```bash sudo apt install apache2 ``` ```bash sudo a2ensite default-ssl ``` ```bash sudo a2enmod ssl ``` ```bash sudo a2enmod proxy_ajp ``` ```bash systemctl restart apache2 ``` -------------------------------- ### PostgreSQL Database Setup Commands Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Appserver/diff_version_id=872dccc6c00307d0d275ef6b303da83ff05c1356&view=parallel Shell commands to create a new database user and an empty database for the reg-app in PostgreSQL. This assumes the PostgreSQL server is running and accessible. It requires a PostgreSQL user with sufficient privileges to create users and databases. ```shell su postgres createuser -P bwidm-user createdb -O bwidm-user bwidm exit ``` -------------------------------- ### Install Apache Web Server on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env Installs the Apache HTTP Server and enables necessary modules like SSL and proxy_ajp. It also includes steps to configure Apache to proxy requests to a WildFly server. ```bash $ sudo apt install apache2 $ sudo a2ensite default-ssl $ sudo a2enmod ssl $ sudo a2enmod proxy_ajp systemctl restart apache2 $ sudo vim /etc/apache2/sites-enabled/default-ssl.conf Add the line ProxyPass/ajp://127.0.0.1:8010/ to the default-ssl.conf file $ sudo vim /etc/hosts Add the line 127.0.0.1 bwidm-test.scc.kit.edu to the /etc/hosts file $ systemctl restart apache2 ``` -------------------------------- ### Install Maven Build Tool (Bash) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36&view=inline Installs Apache Maven, a popular build automation tool used for Java projects. It manages project dependencies and builds. ```bash sudo apt install maven ``` -------------------------------- ### Install Java OpenJDK 17 on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=b2752abe5444bb4e4ea5a7e9c827bf9f580c24d2&view=inline Provides the command to install Java OpenJDK 17 on a Linux Ubuntu system. This is a prerequisite for many development tasks. ```bash sudo apt update && sudo apt install openjdk-17-jdk -y ``` -------------------------------- ### Wildfly Mail Subsystem Configuration Example Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Appserver/diff_version_id=872dccc6c00307d0d275ef6b303da83ff05c1356&view=parallel Example configuration for the mail subsystem in Wildfly, which is necessary for the reg-app to send emails. This involves defining the SMTP server, port, and security credentials. It requires access to the Wildfly configuration files or CLI. ```xml ... ... ``` -------------------------------- ### Install Apache Web Server Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=c73c99024802978dea9239f93362189dbc75cc10 Installs the Apache HTTP Server and enables necessary modules (SSL, proxy_ajp) and sites for serving web content. It also restarts the Apache service. ```bash $ sudo apt install apache2 ``` ```bash $ sudo a2ensite default-ssl ``` ```bash $ sudo a2enmod ssl ``` ```bash $ sudo a2enmod proxy_ajp ``` ```bash $ systemctl restart apache2 ``` -------------------------------- ### Install Java OpenJDK 17 (Bash) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36&view=inline Installs OpenJDK 17 JRE headless, a minimal Java runtime environment, using the apt package manager. This is a prerequisite for running Java applications. ```bash sudo apt install openjdk-17-jre-headless ``` -------------------------------- ### Wildfly Datasource Configuration Example Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Appserver/diff_version_id=872dccc6c00307d0d275ef6b303da83ff05c1356 Example snippet for configuring a datasource in Wildfly, likely via its Command Line Interface (CLI). This is essential for the reg-app to connect to its database. Specific driver JAR and connection properties will vary. ```cli deployment --name=mysql-connector-java-5.1.46.jar --runtime-name=mysql-connector-java.jar /subsystem=datasources/data-source=BwidmDS: add(jndi-name=java:/BwidmDS, enabled=true, use-java-context=true, driver-name=mysql-connector-java.jar, connection-url=jdbc:mysql://localhost:3306/bwidm, pool-name=BwidmPool) ``` -------------------------------- ### Install Lombok in Eclipse IDE Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=956076e15c95606099b5735fdded61428546e7d4 Provides instructions for installing the Lombok plugin in Eclipse IDE via the Marketplace. Lombok reduces boilerplate code in Java applications. It's important to fully restart Eclipse after installation. ```bash Help` → `Install New Software...` and use Updatesite https://projectlombok.org/p2. Restart Eclipse completly afterwards. The offered "Restart" is not enough. Quit eclipse, wait until all java processes have ended. ``` -------------------------------- ### Install PostgreSQL Database Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=c73c99024802978dea9239f93362189dbc75cc10 Installs PostgreSQL, a powerful open-source relational database system. This includes common packages and the main PostgreSQL server. ```bash sudo apt install -y postgresql-common -y ``` ```bash $ sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash $ sudo apt install -y postgresql ``` -------------------------------- ### Install Maven Build Tool on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env Installs Apache Maven, a popular build automation tool used for Java projects, via the apt package manager. Maven is essential for compiling, testing, and managing project dependencies. ```bash sudo apt install maven ``` -------------------------------- ### Install Java OpenJDK 17 on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env Installs the Java Runtime Environment (JRE) Headless version 17 using the apt package manager. This is a core dependency for running Java applications. ```bash sudo apt install openjdk-17-jre-headless ``` -------------------------------- ### Verify Java and Maven Installation (Shell) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Build_version_id=1e32ba624d4dfaf543078153cdfd432fd1906f35 Commands to verify if Java and Apache Maven are installed and accessible in the system's PATH. This is a prerequisite for building the application. ```shell ~$ java -version openjdk version "11.0.11" 2021-04-20 OpenJDK Runtime Environment (build 11.0.11+9-Ubuntu-0ubuntu2) OpenJDK 64-Bit Server VM (build 11.0.11+9-Ubuntu-0ubuntu2, mixed mode, sharing) ``` ```shell ~$ mvn --version Apache Maven 3.6.3 ``` -------------------------------- ### Wildfly JMS Subsystem Configuration Example Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Appserver/diff_version_id=872dccc6c00307d0d275ef6b303da83ff05c1356&view=parallel Example configuration for the JMS subsystem in Wildfly, defining the necessary queues for the reg-app to process jobs. This involves specifying queue names and their attributes within the Wildfly configuration. It requires access to the Wildfly configuration files or CLI. ```xml ``` -------------------------------- ### Verify Java and Maven Installation (Shell) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Build/diff_version_id=cade65b4e7279056caab2e51d1dd8cbcc3c4ad07&view=parallel Commands to verify the installation and versions of Java Development Kit (JDK) and Apache Maven. These commands are executed in a shell environment. ```shell ~$ java -version openjdk version "11.0.11" 2021-04-20 OpenJDK Runtime Environment (build 11.0.11+9-Ubuntu-0ubuntu2) OpenJDK 64-Bit Server VM (build 11.0.11+9-Ubuntu-0ubuntu2, mixed mode, sharing) ~$ mvn --version Apache Maven 3.6.3 ``` ```shell ~$ java -version openjdk version "17.0.9" 2023-10-17 OpenJDK Runtime Environment (build 17.0.9+9-Debian-1deb12u1) OpenJDK 64-Bit Server VM (build 17.0.9+9-Debian-1deb12u1, mixed mode, sharing) ~$ mvn --version Apache Maven 3.8.7 ``` -------------------------------- ### Wildfly Datasource Configuration Example Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Appserver/diff_version_id=872dccc6c00307d0d275ef6b303da83ff05c1356&view=inline Example XML snippet for configuring a datasource in Wildfly. This involves deploying a JDBC driver and defining the datasource connection details. ```xml jdbc:postgresql://localhost:5432/bwidm postgresql bwidm-user bwidm-password org.postgresql.xa.PGXADataSource ``` -------------------------------- ### Install Apache Web Server on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=43a6ddb7f12dd5579863ef0f8a67375c5eeec451 Installs Apache HTTP Server, a widely used web server software. It also enables default SSL site configuration, the SSL module, and the proxy_ajp module, which are often needed for proxying requests to application servers. ```bash $ sudo apt install apache2 ``` ```bash $ sudo a2ensite default-ssl ``` ```bash $ sudo a2enmod ssl ``` ```bash $ sudo a2enmod proxy_ajp ``` ```bash systemctl restart apache2 ``` -------------------------------- ### Install Lombok Plugin for Eclipse Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env Instructions for installing the Lombok plugin within the Eclipse IDE. Lombok reduces boilerplate code by automatically generating getters, setters, constructors, etc. ```bash Help→ Install New Software... and use Updatesite https://projectlombok.org/p2. Restart Eclipse completly afterwards. The offered "Restart" is not enough. Quit eclipse, wait until all java processes have ended. ``` -------------------------------- ### Install Reg-App via Docker Compose Source: https://context7.com/context7/gitlab_kit_edu_kit_reg-app_regapp_wikis/llms.txt Provides instructions for a quick deployment of Reg-App using Docker Compose. This involves creating a directory, downloading the docker-compose.yml file, starting the application, and optionally changing the Wildfly admin password. It outlines the ports used for the main application and the Wildfly admin console. ```bash # Create directory and download docker-compose configuration mkdir regapp-docker cd regapp-docker wget 'https://git.scc.kit.edu/reg-app/regapp-docker/-/raw/main/docker-compose.yml' # Start the application docker-compose up # Change Wildfly admin password docker ps docker exec -it /bin/bash /opt/jboss/wildfly/bin/add-user.sh -u admin -p exit # Access the application # Port 8080: Main application at http://localhost:8080 # Port 9990: Wildfly admin console at http://localhost:9990 # Change reg-app admin password at: http://localhost:8080/admin/user/list-admin-users.xhtml ``` -------------------------------- ### Verify Java and Maven Installation Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Build/diff_version_id=dd6ecd8506ef6a34a700af2247d08706490532c9&view=inline This snippet shows how to verify if Java and Maven are installed and configured correctly by checking their versions. It requires a working Java Development Kit (JDK) and Apache Maven environment. ```shell ~$ java -version java version "1.7.0_85" OpenJDK Runtime Environment (IcedTea 2.6.1) (7u85-2.6.1-6+deb8u1) OpenJDK 64-Bit Server VM (build 24.85-b03, mixed mode) ~$ mvn --version Apache Maven 3.3.1 (cab6659f9874fa96462afef40fcf6bc033d58c1c; 2015-03-13T21:10:27+01:00) ``` -------------------------------- ### Verify Java and Maven Installation (Shell) Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Build_version_id=cade65b4e7279056caab2e51d1dd8cbcc3c4ad07 Commands to verify the installation and versions of Java and Maven on your system. These commands are typically run in a terminal or command prompt. ```shell ~$ java -version openjdk version "17.0.9" 2023-10-17 OpenJDK Runtime Environment (build 17.0.9+9-Debian-1deb12u1) OpenJDK 64-Bit Server VM (build 17.0.9+9-Debian-1deb12u1, mixed mode, sharing) ~$ mvn --version Apache Maven 3.8.7 ``` -------------------------------- ### Install Lombok Plugin in Eclipse Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=9d89400a8d154948aba2ef70d3527fd8a1e60d0f Provides instructions for installing the Lombok plugin within the Eclipse IDE. Lombok reduces boilerplate code in Java. It requires a specific update site and a full restart of Eclipse. ```bash Help` → `Install New Software...` and use Updatesite https://projectlombok.org/p2. Restart Eclipse completly afterwards. The offered "Restart" is not enough. Quit eclipse, wait until all java processes have ended. ``` -------------------------------- ### Wildfly Datasource Configuration Example Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Appserver/diff_version_id=872dccc6c00307d0d275ef6b303da83ff05c1356&view=parallel Example of configuring a JDBC datasource for the reg-app within a Wildfly application server. This typically involves deploying a JDBC driver and then defining the datasource using the Wildfly CLI or configuration files. It assumes a JDBC4 compliant driver is available. ```xml jdbc:postgresql://localhost:5432/bwidm postgresql bwidm-user password ``` -------------------------------- ### Install JBoss Tools for Wildfly in Eclipse Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36&view=parallel Instructions for installing the JBoss Tools plugin within Eclipse IDE, which provides support for developing and managing application servers like Wildfly. This involves using the Eclipse Marketplace. ```text Help → Eclipse Marketplace → JBoss Tools → Install → Follow the steps → Restart Eclipse ``` -------------------------------- ### Configure Wildfly Server in Eclipse Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36&view=parallel Guides through the process of setting up a Wildfly application server within Eclipse. This includes creating a new server instance, specifying the Wildfly runtime, and configuring connection details. ```text Window → Show View → Other → Servers (Server) → Open ``` ```text Click on the link “No servers are available. Click this link to create a new server…” provided on the Servers tab. ``` ```text JBoss Community → WildFly 27+ → Choose The server is: Local, Controlled by: Filesystem and shell operations, The selected profile requires a runtime: Create new runtime (next page) ``` ```text Choose your desired wildfly file in Home directory: /your/directory/wildfly-29.0.1.Final.tar.gz, Execution environment: JavaSE-17, Configuration file: standalone-full-ha.xml → Add and Remove → Select the server and add it to the right panel → Finish ``` ```text Right click on the WildFly 27+ → Start ``` -------------------------------- ### Clone regApp Source Code Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=b2752abe5444bb4e4ea5a7e9c827bf9f580c24d2 Clones the 'regApp' source code repository from GitLab using the git clone command. This downloads the project files to the local machine. ```bash - $ git clone https://gitlab.kit.edu/kit/reg-app/regapp ``` -------------------------------- ### Install PgAdmin4 Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=c73c99024802978dea9239f93362189dbc75cc10 Installs PgAdmin4, a popular graphical management tool for PostgreSQL databases. ```bash sudo apt install pgadmin4-desktop ``` -------------------------------- ### Create PostgreSQL Database Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Database/diff_version_id=b7ace59bb79a84dbe21f210f9794b90b24726587 Command to create a new PostgreSQL database named 'regapp' owned by the 'regapp-user'. Assumes PostgreSQL is installed and accessible. ```bash createdb -O regapp-user regapp ``` -------------------------------- ### Configure Wildfly Datasource in XML Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36 This snippet shows how to modify the `standalone-ha.xml` file to configure the database name, username, and password for the regApp datasource. Ensure these values match your created database credentials. ```xml _regAppDev_ _regapp-dev_ _123_ ``` -------------------------------- ### Verify Java and Maven Installation Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Build/diff_version_id=cade65b4e7279056caab2e51d1dd8cbcc3c4ad07&view=inline This snippet shows the expected output for verifying Java and Maven installations. It is used to ensure that the development environment meets the minimum version requirements for building the application. No specific inputs are required, and the output confirms the installed versions. ```sh ~$ java -version openjdk version "11.0.11" 2021-04-20 OpenJDK Runtime Environment (build 11.0.11+9-Ubuntu-0ubuntu2) OpenJDK 64-Bit Server VM (build 11.0.11+9-Ubuntu-0ubuntu2, mixed mode, sharing) openjdk version "17.0.9" 2023-10-17 OpenJDK Runtime Environment (build 17.0.9+9-Debian-1deb12u1) OpenJDK 64-Bit Server VM (build 17.0.9+9-Debian-1deb12u1, mixed mode, sharing) ~$ mvn --version Apache Maven 3.6.3 Apache Maven 3.8.7 ``` -------------------------------- ### Configure Wildfly Datasource in XML Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=5f25464e15de2419b529335eca590a5232bfbd36&view=parallel This snippet shows how to edit the standalone-full-ha.xml file to configure the database name, username, and password for the regApp project. Ensure the provided credentials match your created database setup. ```xml ... _regAppDev_ ... _regapp-dev_ _123_ ... ``` -------------------------------- ### Install Maven Build Tool Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=c73c99024802978dea9239f93362189dbc75cc10 Installs Apache Maven, a build automation tool used primarily for Java projects. It is used for dependency management and project building. ```bash sudo apt install maven ``` -------------------------------- ### Install Java OpenJDK 17 on Ubuntu Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=c73c99024802978dea9239f93362189dbc75cc10 Provides instructions for installing Java OpenJDK 17 on a Linux Ubuntu distribution. This section outlines the necessary commands to set up the Java development kit. ```markdown ### Java: OpenJDK 17 ``` ... ``` ``` -------------------------------- ### Install PostgreSQL Database System Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=5f25464e15de2419b529335eca590a5232bfbd36 Installs PostgreSQL, a powerful open-source relational database system. This includes common utilities and the PostgreSQL server itself. Commands are for Debian-based systems using apt. ```bash sudo apt install -y postgresql-common -y ``` ```bash $ sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh (Press Enter when prompted.) ``` ```bash $ sudo apt install -y postgresql ``` -------------------------------- ### Clone RegApp Source Code from GitLab Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env/diff_version_id=f73ea941b81832e4b3f730c5d16885d1f2367ba8&view=inline Instructions to clone the RegApp source code using Git from the provided GitLab repository URL. This is a prerequisite for setting up the development environment. ```bash - $ git clone https://gitlab.kit.edu/kit/reg-app/regapp ``` -------------------------------- ### Configure Wildfly Server in Eclipse Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=9d89400a8d154948aba2ef70d3527fd8a1e60d0f Steps to set up and run a Wildfly application server within Eclipse. This involves installing JBoss Tools, configuring the server runtime, and updating its launch configuration. ```bash Help` → `Eclipse Marketplace` → `JBoss Tools` → `Install` → Follow the steps → `Restart Eclipse` ``` ```bash Window` → `Show View` → `Other` → `Servers (Server)` → `Open` ``` ```bash JBoss Community` →` WildFly 27+` → Choose `The server is`: `Local`, `Controlled by`: `Filesystem and shell operations`, `The selected profile requires a runtime`: `Create new runtime (next page)` ``` ```bash Choose your desired wildfly file in `Home directory`: `/your/directory/wildfly-29.0.1.Final.tar.gz`, `Execution environment`: `JavaSE-17`, `Configuration file`: `standalone-full-ha.xml` → `Add and Remove` → Select the server and add it to the right panel → `Finish` ``` ```bash Right click on the `WildFly 27+` → `Start` ``` -------------------------------- ### Install Java OpenJDK 17 Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/dev-env_version_id=c73c99024802978dea9239f93362189dbc75cc10 Installs the Java Runtime Environment (JRE) headless version for OpenJDK 17 on Ubuntu. This is a prerequisite for running Java applications. ```bash sudo apt install openjdk-17-jre-headless ``` -------------------------------- ### Wildfly Mail Subsystem Configuration Example Source: https://gitlab.kit.edu/kit/reg-app/regapp/-/wikis/installation/Appserver/diff_version_id=872dccc6c00307d0d275ef6b303da83ff05c1356 XML snippet illustrating the configuration of the mail subsystem in Wildfly. This enables the application server to send emails, which is a requirement for certain functionalities of the reg-app. ```xml ... ... ```