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 Both sides next revision
getting-started [2018/04/11 07:27]
poulm added links to dev guide 		getting-started [2019/01/15 05:42]
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
 +  * Web browser
 +
 +
 +==== 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