User Tools

Site Tools


navhome

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
navhome [2007/09/19 08:52]
faltin
navhome [2008/06/02 09:46] (current)
morten
Line 4: Line 4:
  
 ===== The main view ===== ===== The main view =====
 +
 +{{screenshot:​3.3:​frontpage.png?​600|}}
  
 The home page of NAV consists of the following elements; The home page of NAV consists of the following elements;
  
-  - A welcome message to anonymous and logged in NAV users. \\ Edit the files webfront/​welcome-anonymous.txt and webfront/​welcome-registered.txt. 
-  - A display of operational messages, if any. \\ You add and modifiy messages with the messages tool. 
-  - An overview of boxes that are down, if any. \\ A link to the Status tool is provided for further details. 
-  - Contact information. \\ Edit the file webfront\contact-information.txt. Relevant information is typically email and phone number to network and/or system operations. 
  
-:!: Prior to NAV 3.the home page had a NAV link box and an external link box. These are no longer availablePlease note that toolbar +  - A welcome message ​to anonymous and logged in NAV users\\ Edit the files ''​webfront/​welcome-anonymous.txt''​ and ''​webfront/​welcome-registered.txt''​. 
-provides a quicklink that is per user configurable (see navigational preferences below).+  - A display of operational messages, if any. \\ You add or modifiy messages using the [[messagestool|messages tool]]. 
 +  - An overview of boxes that are down, if any. \\ A link to the [[statustool|Status tool]] is provided for further details. 
 +  - A NAV link box. \\  Edit the file ''​webfront/​nav-links.conf''​. If the config file is empty or missing the box will not show up. 
 +  - An external link box. \\  Edit the file ''​webfront/​external-links.txt''​. If the config file is empty or missing the box will not show up
 +  - Contact information. \\ Edit the file ''​webfront/​contact-information.txt''​. Relevant information ​is typically email and phone number to network and/or system operations
  
-===== The tool bar =====+===== The NAV bar =====
    
-The tool bar is always available, not only on the home page. It provides buttons for login / logout, link to the toolbox, user-defines ​quicklinks, userinfo, and preferences. +The NAV bar is always available, not only on the home page, as a navigating bar on the top It provides buttons for login / logout, link to the toolbox, user-defined ​quicklinks, userinfo, and preferences.
- +
  
 ==== Login / logout ==== ==== Login / logout ====
    
 Login to get access to more NAV tools. The NAV administrator must first add you as a user using  Login to get access to more NAV tools. The NAV administrator must first add you as a user using 
-[[useradminpanel|the user administration panel]]. Each user has a certain set of privileges that i.e.  +[[useradminpanel|the user administration panel]]. Each user has a certain set of privileges that   
-regulates ​which tools he or she may access.+controls ​which tools he or she may access.
  
-==== The tool box ====+The user will be automatically logged out from NAV after a configurable time of inactivity. Adjust this parameter by altering the ''​timeout''​ value in ''​webfront/​webfront.conf''​. The default value is 1 hour (3600 seconds). ​
  
-The toolbox lists all the NAV tools with a brief explaination and lets you navigate to your tool of interest.+=== Use LDAP authentication ===
  
-==== Userinfo ====+If you will have many NAV users and your organization'​s user database is available through LDAP, you should consider enabling LDAP authentication for the NAV web interface.  
 +LDAP configuration and usage [[ldapauthentication|is documented here]]
  
-Userinfo displays information about you and lets you change your password. 
  
 +==== The tool box ====
  
 +The toolbox lists all the NAV tools with a brief explanation and lets you navigate to your tool of interest. \\ The buildup of the tool box is based upon ''​*.tool''​-files in the ''/​usr/​share/​nav/​tools''​ directory. Each tool file points to an icon, has a name, url, textual description and priority. The priority is basis for the order the various tools are presented in the toolbox. ​
 +
 +
 +==== Userinfo ====
  
 +Userinfo displays information about you: your username, name, organization and group memberships. Userinfo also lets you change your password. For "​normal"​ users this is the place to change password, as they do not have access to the user admin panel.
  
  
Line 57: Line 63:
  
 Use this tool to alter the view of the status page. You may include more monitoring status on the status page (add new section). You may also adopt filters to suppress certain alarms and thus only displays those of your interest. Use this tool to alter the view of the status page. You may include more monitoring status on the status page (add new section). You may also adopt filters to suppress certain alarms and thus only displays those of your interest.
 +
 +
 +==== Quicklinks ====
 +
 +If you have activated quicklink #1 and/or quicklink #2 using navigational preferences they will be visible from the NAV bar.
 +
 +
  
 ====== Configuration files ====== ====== Configuration files ======
Line 62: Line 75:
 ''/​etc/​nav/​webfront''​ is the directory for configuring the NAV home page. Add your welcome message to users in the ''/​etc/​nav/​webfront''​ is the directory for configuring the NAV home page. Add your welcome message to users in the
 the  various welcome-files,​ edit your contact information and more. the  various welcome-files,​ edit your contact information and more.
 +
 +If you would like to use [[ldapauthentication|LDAP]] or adjust the user inactivity timer, make changes in ''​webfront.conf''​.
  
 ====== Log files ====== ====== Log files ======
  
-''​webfront.log'' ​gives information on failed logins ​and other issues.+NAV's web interface logs to the file ''​webfront.log''​.   This file doesn'​t exist by default. ​ It must be created in NAV's log directory ​and the user that the Apache server is running as must have write privileges to this file.  NAV uses the Python logging framework when logging to this file. You can create the config file ''​logging.conf''​ to define which log levels should be used for individual loggers. ​ If you wish to se debug messages for all parts of NAV from the web interface, create a ''​logging.conf''​ file containing the following:​ 
 + 
 +<​code>​ 
 +[levels] 
 +root = DEBUG 
 +</​code>​ 
 + 
 +If you only wish to se debug message for specifically web related modules, use this: 
 +<​code>​ 
 +[levels] 
 +nav.web = DEBUG 
 +</​code>​
  
navhome.1190191932.txt.gz · Last modified: 2007/09/19 08:52 by faltin