Skip to end of metadata
Go to start of metadata


Soffid IAM Console installation



Soffid IAM solution requires the following requirements:

  • Linux (CentOs and Ubuntu are the most used) or Windows
  • Java JDK 7 or higher
  • 4GB RAM
  • 10GB disk space
  • Supported database installed

Video tutorial



You will need access to the root user to install Soffid IAM console. If your Linux is a sudo based distribution you will have to execute:

sudo bash

In order to execute i686 executables on 64 bits platforms it is necessary to install the appropriate package:

On RedHat Enterprise 6.3 64 bits you have to install glibc.i686 package:

rpm -i glibc-2.12-1.80.el6.i686.rpm nss-softokn-freebl-3.12.9-11.el6.i686.rpm

Or using yum:

yum install glibc.i686

On Ubuntu Server 12.04, you can install it using the command:

sudo apt-get install ia32-libs

If you have iptables firewall configured you must permit access to 8080 and 760 ports.

Download Soffid Console Installer

Open your favorite browser. Surf on the internet to Soffid Download Manager.

Click on Soffid Console Installer and choose the latest version for your OS.

As soon as the file is in your computer, copy the file into a path of your server.

Console installation

Go to the path where the Soffid Console Installer file (  is stored. Execute it typing the sentence below:

./ -c

It will install Soffid IAM console in the default directory.

The installer will require the database admin user name and password to create the database objects. It is recommended to use Soffid as the database name.

System installer for Oracle will prompt to specify which tablespace should be used for index and data. If the tablespaces already exist they will be reused. Otherwise, they will be created.

Soffid IAM will create soffid user on the database and assign a random password to it. You can set a different password to the soffid user in the installation process. The soffid user will be the schema owner.

The installer will create the database owner and the console will create the database objects during the first run. Console will also create a default administrator user:


Default admin user: admin

Default admin password: changeit

Configure Soffid to start at boot time

Execute these commands as root to start Soffid IAM console service on boot:

For version 1.x:

ln -fs /opt/soffid/iam-console/jboss/bin/soffid-iamconsole /etc/init.d/soffid-iamconsole 
ln -fs /etc/init.d/soffid-iamconsole /etc/rc2.d/S98soffid-iamconsole
ln -fs /etc/init.d/soffid-iamconsole /etc/rc3.d/S98soffid-iamconsole 
ln -fs /etc/init.d/soffid-iamconsole /etc/rc2.d/K10soffid-iamconsole
ln -fs /etc/init.d/soffid-iamconsole /etc/rc3.d/K10soffid-iamconsole

For version 2.x:

ln -fs /opt/soffid/iam-console-2/bin/soffid-iamconsole /etc/init.d/soffid-iamconsole 
ln -fs /etc/init.d/soffid-iamconsole /etc/rc2.d/S98soffid-iamconsole
ln -fs /etc/init.d/soffid-iamconsole /etc/rc3.d/S98soffid-iamconsole 
ln -fs /etc/init.d/soffid-iamconsole /etc/rc2.d/K10soffid-iamconsole
ln -fs /etc/init.d/soffid-iamconsole /etc/rc3.d/K10soffid-iamconsole


Note that if you are running Centos, Redhat7 o version higher than Ubuntu 16.04, you should enable the service in systemctl

sudo systemctl enable soffid-iamconsole

Once you have installed Soffid console, you should start it by executing:

service soffid-iamconsole start

Please check if everything is running correctly with:

service soffid-iamconsole status

Please access the web console by redirecting your browser to:

If something is not running as expected, please check the log at:

  • /opt/soffid/iam-console/jboss/server/default/log/server.log

Add-on installations

There are several Addons available to be installed to add functionalities to the Soffid Console.

To install these addons, please log in to the web console, by browsing to:

Then navigate to:

  • Start > Soffid Configuration > Addon management and select Upload

Select the .jar file and click upload.

  • Please confirm to restart the server in order for the changes to be applied correctly.

Connectors installations

The connectors available for Soffid IAM can be found in the project website in the Connectors section.

The process to install the connectors is exactly the same as the Addons. Please find the instructions in the section above.

Process definitions upload

Workflows to be deployed are very dependent on the business processes. Nevertheless, there are some workflows that any Soffid IAM installation would need and are recommeded:

  •  add-agent-wf: Necessary to attach sync servers and proxys. (Already installed with console).

  •  purge-process: Workflow used to archive already finished processes.

  •  read-logs: Utility workflow to retrieve console log files.

These workflows can be downloaded from the project download page.

To install those processes we have to access for the first time to the web console. Browse to:

Click on:

  • Start > Soffid Configuration > Business process definition
  • Clicking on deploy button will open a new window
  • Select the Workflow definition file (.par extension) and click on upload button


  • No labels