Skip to content

Ubuntu Janssen Installation#

Supported Versions#

  • Ubuntu 22.04
  • Ubuntu 20.04

Before you install, check the VM system requirements.

  • Download the GPG key zip file , unzip and import GPG key
wget https://github.com/JanssenProject/jans/files/11814522/automation-jans-public-gpg.zip

unzip automation-jans-public-gpg.zip

sudo gpg --import automation-jans-public-gpg.asc;

Install the Package#

Ubuntu 22.04#

  • Download the release package from the Github Janssen Project Releases
wget https://github.com/JanssenProject/jans/releases/download/vreplace-janssen-version/jans_replace-janssen-version.ubuntu22.04_amd64.deb -P /tmp

  • Verify integrity of the downloaded package by verifying published sha256sum.

    Download sha256sum file for the package

    wget https://github.com/JanssenProject/jans/releases/download/vreplace-janssen-version/jans_replace-janssen-version.ubuntu22.04_amd64.deb.sha256sum -P /tmp

    Check the hash if it is matching.

    cd /tmp
sha256sum -c jans_replace-janssen-version.ubuntu22.04_amd64.deb.sha256sum

    Output similar to below should confirm the integrity of the downloaded package.

    jans_replace-janssen-version.ubuntu22.04_amd64.deb.sha256sum: OK

  • Install the package

sudo apt install  ./jans_replace-janssen-version.ubuntu22.04_amd64.deb

Ubuntu 20.04#

  • Download the release package from the Github Janssen Project Releases
wget https://github.com/JanssenProject/jans/releases/download/vreplace-janssen-version/jans_replace-janssen-version.ubuntu20.04_amd64.deb -P /tmp

  • Verify integrity of the downloaded package by verifying published sha256sum.

    Download sha256sum file for the package

    wget https://github.com/JanssenProject/jans/releases/download/vreplace-janssen-version/jans_replace-janssen-version.ubuntu20.04_amd64.deb.sha256sum -P /tmp

    Check the hash if it is matching.

    cd /tmp
sha256sum -c jans_replace-janssen-version.ubuntu20.04_amd64.deb.sha256sum

    Output similar to below should confirm the integrity of the downloaded package.

    jans_replace-janssen-version.ubuntu20.04_amd64.deb.sha256sum: OK

  • Install the package

sudo apt install  ./jans_replace-janssen-version.ubuntu20.04_amd64.deb

Run the setup script#

  • Run the setup script in interactive mode:
sudo python3 /opt/jans/jans-setup/setup.py

See more detailed instructions on the setup script if you're confused how to answer any of the questions, for details about command line arguments, or you would prefer to use a properties file instead of interactive mode.

Verify the Installation#

After the successful completion of setup process, verify the system health.

Log in to Text User Interface (TUI)#

Begin configuration by accessing the TUI with the following command:

sudo /opt/jans/jans-cli/jans_cli_tui.py

Full TUI documentation can be found here

If you have selected casa during installation you can access casa using url https://<host>/jans-casa

Let's Encrypt#

To enable communication with Janssen Server over tls (https) in production environment, Janssen Server needs details about CA certificate.

To generate Let’s Encrypt CA certificate follow this let's encrypt.

Uninstall#

Uninstall process involves two steps and removes all the Janssen Server components.

Note

For removal of the attached persistence store, please refer to this note.

  1. Delete files installed by Janssen
  2. Remove and purge the jans package

Use the command below to uninstall the Janssen server

sudo python3 /opt/jans/jans-setup/install.py -uninstall

You'll see the following confirmation:

This process is irreversible.
You will lose all data related to Janssen Server.



Are you sure to uninstall Janssen Server? [yes/N] yes

Uninstalling Jannsen Server...
Removing /etc/default/jans-config-api
Stopping jans-config-api
Removing /etc/default/jans-scim
Stopping jans-scim
Removing /etc/default/jans-fido2
Stopping jans-fido2
Removing /etc/default/jans-auth
Stopping jans-auth
Removing /etc/default/jans-client-api
Stopping jans-client-api
Stopping OpenDj Server
Executing rm -r -f /etc/certs
Executing rm -r -f /etc/jans
Executing rm -r -f /opt/jans
Executing rm -r -f /opt/amazon-corretto*
Executing rm -r -f /opt/jre
Executing rm -r -f /opt/node*
Executing rm -r -f /opt/jetty*
Executing rm -r -f /opt/jython*
Executing rm -r -f /opt/opendj
Executing rm -r -f /opt/dist
Removing /etc/apache2/sites-enabled/https_jans.conf
Removing /etc/apache2/sites-available/https_jans.conf

The command below removes and purges the jans package

apt-get --purge remove jans

Which should result in the following:

Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following packages were automatically installed and are no longer required:
  apache2 apache2-bin apache2-data apache2-utils libapr1 libaprutil1 libaprutil1-dbd-sqlite3 libaprutil1-ldap liblua5.2-0 python3-distutils python3-ldap3 python3-lib2to3 python3-prompt-toolkit
  python3-pyasn1 python3-pygments python3-pymysql python3-ruamel.yaml python3-wcwidth
Use 'sudo apt autoremove' to remove them.
The following packages will be REMOVED:
  jans*
0 upgraded, 0 newly installed, 1 to remove and 124 not upgraded.
After this operation, 1,257 MB disk space will be freed.
Do you want to continue? [Y/n] y
(Reading database ... 166839 files and directories currently installed.)
Removing jans (replace-janssen-version~ubuntu20.04) ...
Checking to make sure service is down...
Last update: 2024-01-31
Created: 2022-05-18