Using the installer

In order to install IAM.tfopen in new window, a Java Development Kit is required (not a JRE). The JDK provides tools that are used by the IAM transforming engine to transform models into running identity appliances. We do support both OpenJDK and Oracle's JDK.

Make sure to have the JAVA_HOME variable properly set before running the installer. In our example, we are using the headless mode:

Tips

"Headless install: run the installer with the -console flag"

Let's take a look at our example. We will ensure that we use the correct java settings and install IAM.tfopen in new window.

    echo $JAVA_HOME
    /usr/lib/jvm/java-8-openjdk
    which java
    /usr/lib/jvm/java-8-openjdk/bin/java
    java -jar iamtf-1.6.0-1-unix.jar -console

The process will prompt for the target location where the server will be installed, we'll refer to it as IAMTF_HOME.

The server is the component providing identity services to users and applications. You normally have multiple server instances running in your organization: different environments (prod, qa, dev), cluster nodes, etc.

Server layout

Since IAM.tfopen in new window is based on JOSSO, the IAMTF_HOME folder contains the familiar layout used by all JOSSO 2 and 3 servers installations. Below is a tree of the most relevant server folders. Let's take a look at what type of content we will find in each one.

IAMTF_HOME
├── bin
├── data
│    ├── log
│    └─  ...
├── etc
├── extensions
├── features
└─  ...

  • bin: contains scripts used to start/stop IAM.tfopen in new window, as well as to create Linux startup configurations(rc,systemd)

  • data/log: the server logs folder, in particular atricore.log contains useful information about system status, errors, etc.

  • etc: this folder contains the server configuration. These are server-wide settings like HTTP options or logging settings.

  • extensions: this folder us used to deploy custom extensions. IAM.tfopen in new window extensions are actually OSGi bundles; you can copy them in this folder following the proper conventions

  • features: this folder contains configuration files about all installed extensions or plugins; there is a specific file to configure custom extensions. (in IAM.tfopen in new window your custom extensions and all the built-in services are actually OSGi bundles)

Starting the Server

In order to get the server started, you can just go to IAMTF_HOME/server/bin and run the atricore script to run the server as a foreground process.

Use Ctrl-d or type shutdown in JOSSO's command line to stop the server.

If you want you can start the server in background mode by using the start script instead. Use the stop script to shutdown the server.

The bin folder also contains scripts to use as OS service configuration. Windows servers require a different setup.

In the following example we will:

Last Updated:
Contributors: Sebastian