Difference between revisions of "Basic application knowledge with JBoss"

From OpenKM Documentation
Jump to: navigation, search
m (Managing users)
Line 5: Line 5:
  
 
== Managing users ==
 
== 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. 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.
+
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.
  
  
Line 11: Line 11:
  
  
There're two important roles called '''AdminRole''' and '''UserRole''' ( these roles are case sensitive ). All users must have UserRole, it's OpenKM grant to connect to OpenKM server. Any user with AdminRole will view all repository without limits and have administration toolbar enabled.
+
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 authentication ==  
OpenKM can use several authentication systems (Database, LDAP, Active Directory, etc.) but, by default is configured with an embeded database (HSQLDB).
+
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 ==
 
== Setting maximum file upload size ==
By default maximum file upload size is set at 25MB, to increse this it must be done some changes in [[Application configuration]] file.
+
By default maximum file upload size is set at 25MB, to increase this it must be done some changes in [[Application configuration]] file.
  
== Making OpenKM accesible to other computers ==
+
== Making OpenKM accessible from other computers ==
By default, JBoss only listen for connections on localhost. If you want to access from other computer, you need to start JBoss passing the parameter -b 0.0.0.0  
+
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'''
 
'''GNU/Linux'''
Line 31: Line 31:
 
  ./bin/run.sh -Djboss.bind.address=0.0.0.0
 
  ./bin/run.sh -Djboss.bind.address=0.0.0.0
  
or add into run.bat ( or run.sh ) file at ends de -b 0.0.0.0 parameter ( depending if you're in windows or linux script some minimal diference, but basically it's the same idea )
+
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
 
  :RESTART
Line 37: Line 37:
 
   -Djava.endorsed.dirs="%JBOSS_ENDORSED_DIRS%" ^
 
   -Djava.endorsed.dirs="%JBOSS_ENDORSED_DIRS%" ^
 
   -classpath "%JBOSS_CLASSPATH%" ^
 
   -classpath "%JBOSS_CLASSPATH%" ^
   org.jboss.Main %* -b 0.0.0.0
+
   org.jboss.Main %* '''-b 0.0.0.0'''
  
 
[[Category: Quick Install]]
 
[[Category: Quick Install]]

Revision as of 17:55, 26 August 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 maximum file upload size is set at 25MB, to increase this it must be done some changes in Application configuration file.

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