2.2.2. Install SimpleELN Team Edition Web Server with Embedded Database

The SimpleELN Team Edition is preconfigured with an embedded database, ideal for testing purposes. For production usage, kindly refer to the instructions outlined in Install SimpleELN Team Edition with an External Database for integrating with external databases such as MySQL, SQL Server, or Oracle. Please adhere to the outlined steps below to test its functionalities:

  1. Download the application archive file (SimpleELN-Team-Server-{platform}-{arch}-{version}.zip or SimpleELN-Team-Server-{platform}-{arch}-{version}.tar.gz) for the target platform from the official website or a trusted source.

  2. Rename the downloaded archive file to simpleeln-team.zip or simpleeln-team.tar.gz for convenient identification.

  3. Extract the archive file.

    • For Windows:

      Extract the simpleeln-team.zip file into a designated folder, as outlined in the Microsoft support documentation.

    • For macOS or Linux:

      • Open a terminal from the Applications menu or use the Spotlight search (⌘ + Space).

      • Extract the simpleeln-team.tar.gz file as outlined below.

        1# Extract the simpleeln-team.tar.gz file
        2tar -xzvf <path/to/simpleeln-team.tar.gz> -C <path/to/target/folder>
        
  4. Open a terminal window

    • On Windows, you can press Win + R and type cmd to open a command prompt.

    • On macOS or Linux, you can open a terminal from the Applications menu or use the Spotlight search (⌘ + Space).

  5. Navigate to the directory where the archive file has been extracted.

  6. Modify the web server settings. (Create the application.properties file and place it in the ‘config’ folder if not exist)

    Listing 2.4 contents of the config/application.properties file
    1# contents of the config/application.properties file
    2# server.port=32780 #default
    3server.port=32780
    
  7. Run the application web server

    • For Windows:

      1# run the script
      2startserver.bat
      
    • For macOS or Linux:

      1# run the script
      2./startserver.sh
      
  8. Use a web browser to access the web server

    1. Start the web server.

    2. Open a web browser in the local or remote computer (such as Google Chrome, Mozilla Firefox, Microsoft Edge, etc.).

    3. Navigate to http://<host_ip>:<port>, making sure to replace <host_ip> with the IP address of your server host machine and <port> with the designated port number. For example, replace the <port> with the server.port number specified in the application.properties file: 32780

    4. If the connection is successful, you will be able to access the SimpleELN interface, similar to the following screenshot.

      SimpleELN Homepage