Difference between revisions of "Basic application knowledge with JBoss"

From OpenKM Documentation
Jump to: navigation, search
 
(27 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{TOCright}} __TOC__
 +
 
== First login ==
 
== First login ==
The default username is '''okmAdmin''' and password is '''admin''' ( note that username and password are case sensitive )
+
The default username is '''okmAdmin''' and its password is '''admin'''. Note that username and password are case sensitive.
  
 +
== Managing users ==
 +
Since OpenKM 3.0, user management is done from the Administration tab. There you can create users, roles and assign roles to users, etc. Older OpenKM versions use text file based user management. These files are located in the ''$JBOSS/server/default/conf/props'' directory, so you need to edit the openkm-users.conf, openkm-roles.conf and openkm-emails.conf files to add or remove a user from the system.
 +
 +
 +
[[File:Okm_admin_46.jpeg|758px|center]]
  
== Managing users ==
 
Since OpenKM 3.0 by default user management is an administration option. There it can create users, roles and assign roles to users, etc...
 
  
 +
There are two important roles called '''AdminRole''' and '''UserRole''' (these roles are case sensitive). All users must have UserRole. This allows them to connect to the OpenKM server. Any user with AdminRole will be able to view the whole repository without limits, and have the Administration tab enabled.
  
Older OpenKM versions use text-based user management. These files are located at $JBOSS/server/default/conf/props, so you need to edit openkm-users.conf, openkm-roles.conf and openkm-emails.conf to add or remove a user from the system.
+
== OpenKM authentication ==
 +
OpenKM can use several authentication systems (Database, LDAP, Active Directory, etc.) but, by default is configured with an embedded database (HSQLDB).
  
 +
== Setting maximum file upload size ==
 +
By default the maximum file upload size is set at 64MB. To increase this, make changes to the [[Application configuration]].
  
There're two important roles called '''AdminRole''' and '''UserRole''' ( these roles are case sensitive ). All users must have UserRole, it's OpenKM grant to be connect to OpenKM server. Any user with AdminRole it'll view all repository without limits and has administration toolbar enabled.
+
== Making OpenKM accessible from other computers ==
 +
By default, JBoss only listens for connections on localhost. If you want to access OpenKM from other computers, you need to start JBoss passing the parameter '''-b 0.0.0.0'''
  
 +
'''GNU/Linux'''
 +
./bin/run.sh -b 0.0.0.0
  
[[File:Okm_003.jpeg]]
+
'''Windows'''
 +
\bin\run.bat -b 0.0.0.0
  
 +
'''Other options'''
 +
./bin/run.sh -Djboss.bind.address=0.0.0.0
  
== OpenKM authentication systems ==
+
or edit the run.bat ( or run.sh ) file, adding the '''-b 0.0.0.0''' parameter to the java startup command (the windows and linux scripts have some minimal differences, but basically it's the same idea)
Yes, OpenKM can use several authentication systems (Database, LDAP, Active Directory, etc.) but, by default it is configured with a simple text file based system.
 
  
 +
:RESTART
 +
"%JAVA%" %JAVA_OPTS% ^
 +
  -Djava.endorsed.dirs="%JBOSS_ENDORSED_DIRS%" ^
 +
  -classpath "%JBOSS_CLASSPATH%" ^
 +
  org.jboss.Main %* '''-b 0.0.0.0'''
  
== Setting max file size uploading ==
+
[[Category: Quick Install]]
By default uploading max file size is set at 25MB, to increse this it must be done some changes in [[OpenKM.cfg]] file.
 

Latest revision as of 19:42, 1 December 2012

First login

The default username is okmAdmin and its password is admin. Note that username and password are case sensitive.

Managing users

Since OpenKM 3.0, user management is done from the Administration tab. There you can create users, roles and assign roles to users, etc. Older OpenKM versions use text file based user management. These files are located in the $JBOSS/server/default/conf/props directory, so you need to edit the openkm-users.conf, openkm-roles.conf and openkm-emails.conf files to add or remove a user from the system.


Okm admin 46.jpeg


There are two important roles called AdminRole and UserRole (these roles are case sensitive). All users must have UserRole. This allows them to connect to the OpenKM server. Any user with AdminRole will be able to view the whole repository without limits, and have the Administration tab enabled.

OpenKM authentication

OpenKM can use several authentication systems (Database, LDAP, Active Directory, etc.) but, by default is configured with an embedded database (HSQLDB).

Setting maximum file upload size

By default the maximum file upload size is set at 64MB. To increase this, make changes to the Application configuration.

Making OpenKM accessible from other computers

By default, JBoss only listens for connections on localhost. If you want to access OpenKM from other computers, you need to start JBoss passing the parameter -b 0.0.0.0

GNU/Linux

./bin/run.sh -b 0.0.0.0 

Windows

\bin\run.bat -b 0.0.0.0

Other options

./bin/run.sh -Djboss.bind.address=0.0.0.0

or edit the run.bat ( or run.sh ) file, adding the -b 0.0.0.0 parameter to the java startup command (the windows and linux scripts have some minimal differences, but basically it's the same idea)

:RESTART
"%JAVA%" %JAVA_OPTS% ^
  -Djava.endorsed.dirs="%JBOSS_ENDORSED_DIRS%" ^
  -classpath "%JBOSS_CLASSPATH%" ^
  org.jboss.Main %* -b 0.0.0.0