Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Next revision Both sides next revision
getting-started [2018/04/11 07:27]
poulm added links to dev guide 		getting-started [2019/02/18 07:20]
cirkval [Requirements]
Line 1: Line 1:
 +====== Getting Started ======
  
 +{{tag>tutorial installation}}
 +
 +An overview of CzechIdM, how to download it, setup and use in a presentation environment.
 +
 +<note>
 +This howto is intended for quick demo environment that can be prepared in 5 minutes. It nicely serves for first look on application and its GUI.
 +Note that it relies on bundled in-memory database H2. After you stop the application server, you will lose all its data.
 +
 +If you want to use CzechIdM with standard database see full-blown [[tutorial:adm:server_preparation| server preparation guide]] and [[tutorial:adm:czechidm_installation|installation tutorial]].
 +</note>
 +
 +===== Requirements =====
 +  * Java 1.8, patchset at least 101
 +  * Windows or Unix/Linux operating system or Mac OS
 +  * Web browser Firefox, Chrome, IE
 +  * Databases - MS-SQL and PostgreSQL
 +  * Application servers - Apache Tomcat and JBOSS WildFly 
 +
 +
 +==== Server sizing ====
 +[[faq:prerequisites_and_system_requirements|Here is recomended HW configuration]].
 +==== Java ====
 +  * [[http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html|Download]] and install a Java (1.8) SE Runtime Environment (JRE).
 +  * Install steps depend on your system. Please follow [[https://docs.oracle.com/javase/8/docs/technotes/guides/install/install_overview.html|this guide]] to install Java. You can also use a full Java Development Kit (JDK).
 +==== Tomcat ====
 +  * [[http://archive.apache.org/dist/tomcat/tomcat-8/v8.0.35/bin/apache-tomcat-8.0.35.zip|Download]] and unzip Tomcat (v.8.0.35) binary archive to newly created folder: "apache-tomcat-8.0.35".
 +  * For advanced Tomcat setup, you can follow instructions in file **RUNNING.txt** in the downloaded tomcat archive.
 +==== CzechIdM ====
 +  * [[http://download.czechidm.com/CzechIdM/nightly/current/idm.war|Download]] current nightly build.
 +  * Copy **idm.war** to folder **apache-tomcat-8.0.35/webapps/**.
 +
 +===== Starting the application =====
 +To start the application, go to folder **apache-tomcat-8.0.35/bin/** and run this command:
 +<note tip>For unix-like system you may need to set permissions to  allow execution of these files: startup.sh, shutdown.sh, catalina.sh</note>
 +
 +
 +**For unix-like systems:**
 +   ./startup.sh
 +**For windows systems:**
 +   startup.bat
 +   
 +
 +After its start, Tomcat will load the CzechIdM application. This process may take a while. You can check the progress in Tomcat's logfile: //apache-tomcat-8.0.35/logs/catalina.out//. After the application finishes loading, you can access it with a web browser on this URL:
 +   http://localhost:8080/idm/
 +To log in, you can use this administrator account:
 +<code>
 +Username: admin
 +Password: admin
 +</code>
 +
 +<note tip>After the CzechIdM has started, you can follow [[tutorial:adm:basic_operations| basic steps tutorial]] or more generally read our product [[devel:documentation:start|documentation]] which will show you how to actually use the identity manager.</note>
 +
 +===== Stopping the application =====
 +To stop the application go to folder **apache-tomcat-8.0.35/bin/** and run this command:
 +
 +**For unix like systems:**
 +   ./shutdown.sh
 +**For windows systems:**
 +   shutdown.bat
 +
 +===== Demo =====
 +To get a quick glance onto the CzechIdM's user interface and its workings, you can also access a [[http://demo.czechidm.com/|live demo]] with the last nightly build.
 +
 +===== Full deploy =====
 +<note important>To install CzechIdM e.g. in test or production environment, you probably want to use proper DB. Read this CzechIdM [[tutorial:adm:czechidm_installation|installation tutorial]]. We also prepared a cookbook for [[tutorial:adm:server_preparation|server preparation]] </note>
 +
 +===== Developing CzechIdM =====
 +If you want to develop CzechIdM, the best way is to follow tutorial [[tutorial:dev:creating_a_development_environment|]] or for a quick glance [[tutorial:dev:quick_start_with_devstack|]]
 +
 +===== Contact us =====
 +If you need some other information, you can use [[https://www.czechidm.com/#contact|this form]] to contact us.
 +
 +For complete listing of contact options, pricing and such, please see the [[https://wiki.czechidm.com/support|support wiki page]].
  • by koulaj