# After Installation

## Demonstration views

NagVis contains several demo maps on initial installation. There is also a rotation defined to give you an example of the features of NagVis. Certainly Nagvis has a lot more features than we can show you with this demo configurations. So you should read the documentation and be creative.

If you are familiar with NagVis you can delete these demonstration maps and rotation without problems.

## Configuration Files

NagVis is based on several configuration files. The main configuration file stores the basic and global configuration options. The map specific configuration options are stored in map configuration files located in `etc/maps`. A special type of maps are the automaps which have a configuration file directory of their own (`etc/automaps`). The automap configuration files use the same syntax as the map configuration files but have some additional options.

The whole NagVis configuration can be changed using the web based configuration dialogs.

## Authentication/Authorisation

By default NagVis uses an internal user and permission database (SQLite) for handling authentication and authorisation. Nagvis uses a role based permission system. After installation there are two default users defined:

- Username: admin, Password: admin
- Username: guest, Password: guest

The following roles with these permissions are available:

- Administrators: Full permissions on the whole installation
- Users: Read access to all maps, automaps and rotations in the installation
- Guests: Read access to all demo maps, automaps and rotations

These default users and roles should be ok for beginning. You may delete these users and roles but please be aware not to delete the last administrative user.

## Troubleshooting

During installation

- The installer complains about missing prerequisites/modules.

  Please be sure that you have a current PHP version, that all required modules are installed for NagVis and the backend you want to use and that GraphViz is already there. Some PHP modules might already be included in the base package (please use "php -m" to check).

  Please check `install.log` for errors.

After installation

- You only get a blank page while trying to access the main page.

  Please check the Apache logs for "permission denied" messages. It is most likely that SElinux is active. Please disable it (setenforce 0) or allow NagVis to access the files.

- After adding objects to a map it isn't displayed any more.

  Please check the Apache logs for "memory limit exceeded" messages. It is most likely that the memory settings in php.ini have to be increased. Please restart your WebServer afterwards.

Please take a look at the doc section of the official website (namely "FAQ" and "Often reported errors") as well. If this doesn't help then read on.

HELP

You might seek help at the official NagVis website or use the monitoring portal which offers a board for NagVis questions.

In any case please provide at LEAST information about

- the operating system (distribution, version)
- the NagVis version (including if installed from os provided package or source)
- `grep "^[^;|^$]" <config file>` (if you have a configuration related issue). Replace "<config file>" by the name of the config file which might be in error
- Apache log messages (error log)
</lu>