Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Download distribution file.

    wget http://www.openiam.com/downloads/builds/rpm/3.5/openiam-3.56-<VERSION>.el6.el7.x86_64.rpm

  2. Install rpm file:
    sudo rpm -i openiam-3.56-<VERSION>.el6.el7.x86_64.rpm
  3. OpenIAM will be installed at /usr/local/ folder. If by any reasons this folder doesn't exist in your system, please create it manually before installation. Relocatable rpm files will be implemented in future.
  4. Database installation. Right now OpenIAM distributes Oracle and MySQL (Maria DB) database schemas. Support of Postgres and MS-SQL will be implemented in the closest future,
    1. MySQL. 

      For MySQL support is implemented automatic way to fill the openiam schema. By default script will create schemas, and database user with name=idmuser and password=idmuser. If you need to modify the logic you could change a mysql.sql script based on your system requirements. The source db sql script is located here: /usr/local/OpenIAM/utility/createDatabase/mysql/mysql.sql. 

      1. Go to /usr/local/OpenIAM/utility/createDatabase/mysql: cd /usr/local/OpenIAM/utility/createDatabase/mysql

      2. Open file /usr/local/OpenIAM/utility/createDatabase/mysql: cd /usr/local/OpenIAM/utility/createDatabase/mysql/mysql.properties with any text editor. Edit the follwoing properties is required

        Info
        titlemysql.properties example

        #URL to database. could be remote. be sure that port is open for remote access
        url=jdbc:mysql://localhost:3306?useUnicode=true&amp;characterEncoding=UTF-8
        #username and password of admin
        name=root
        password=rootPassword


      3. Save and close mysql.properties file

      4. Run create.sh script to apply MySQL schema to your mysql instance.

      5. Go to folder /usr/local/OpenIAM/data/openiam/conf

      6. Open file datasource.properties with any text editor

      7. Find the following properties and change the values of Url, UserName and Password if required:

        Info
        titleDatasource.properties example

        openiam.db.driverClassName=com.mysql.jdbc.Driver
        openiam.db.connection.string=jdbc:mysql://localhost:3306/openiam?useUnicode=true&amp;characterEncoding=UTF-8
        openiam.db.username=idmuser
        openiam.db.password=idmuser
        openiam.db.pool.min=10
        openiam.db.pool.max=50

        activiti.db.driverClassName=com.mysql.jdbc.Driver
        activiti.db.connection.string=jdbc:mysql://localhost:3306/activiti?useUnicode=true&amp;characterEncoding=UTF-8
        activiti.db.username=idmuser
        activiti.db.password=idmuser
        activiti.db.pool.min=10
        activiti.db.pool.max=50


      8. Save and close file

    2. Oracle. 

      For Oracle RDBMS you should copy sql files and perform them on your Oracle manually. 

      1. SQL files are located in folder:  /usr/local/OpenIAM/utility/createDatabase/oracle. There are two sql scripts: openiam.sql and activti.sql. It should be 2 different schemas in your RDBMS. 

      2. Go to folder /usr/local/OpenIAM/data/openiam/conf

      3. Open file datasource.properties with any text editor

      4. Find the following properties and change the values of Url, UserName and Password if required: 

        Info
        titledatasource.properties example

        openiam.dbType=ORACLE_INSENSITIVE

        openiam.hibernate.dialect=org.hibernate.dialect.Oracle10gDialect openiam.databaseSchema.name=IAMUSER openiam.db.driverClassName=oracle.jdbc.driver.OracleDriver openiam.db.connection.string=jdbc:mysql://localhost:3306/openiam?useUnicode=true&amp;characterEncoding=UTF-8 openiam.db.username=OPENIAM

        openiam.db.password=OPENIAM openiam.db.pool.min=10

        openiam.db.pool.max=50 activiti.db.driverClassName=oracle.jdbc.driver.OracleDriver

        activiti.db.connection.string=jdbc:mysql://localhost:3306/activiti?useUnicode=true&amp;characterEncoding=UTF-8

        activiti.db.username=ACTIVITI

        activiti.db.password=ACTIVITI

        activiti.db.pool.min=10

        activiti.db.pool.max=50


      5. Save and close file

  5. To run Backend use a command: sudo service jbossas7 start

  6. To view an deploying process use command: sudo service jbossas7 log. When backend deployment will be completed you should encrypt passwords
  7. Go to /usr/local/OpenIAM/utility/encryptPassword/
  8. Run generate_password.sh scripts: sh generate_password.sh.
  9. To run UI use a command: sudo service tomcat start
  10. In 2 minutes try to reach your OpenIAM instance from browser. It will be listen at 8080 port by default. URL will be someting like: http://localhost:8080/webconsole
  11. to run OpenIAM on OS startup run the following commands:

    Code Block
    languagebash
    titleAutorun
    chkconfig jbossas7 on
    chkconfig tomcat on


  12. httpd revers proxy module is one of the important OpenIAM components. To have complete functionality and stability please install this using documents: Installing Apache Proxy Module and Configuring the Reverse Proxy.
    OpenIAM proxy module rpm file is located: /usr/local/OpenIAM/proxy/

...