After installing a new application you will normally want to read any documentation it
may have included, edit any configuration files that are required, ensure that the
application starts at boot time (if it is a daemon), and so on.
The exact steps you need to take to configure each application will obviously be
different. However, if you have just installed a new application and are wondering
“What now?” these tips might help:
Use pkg_info(1) to find
out which files were installed, and where. For example, if you have just installed
FooPackage version 1.0.0, then this command
#pkg_info -L foopackage-1.0.0 | less
will show all the files installed by the package. Pay special attention to files in
man/ directories, which will be manual pages, etc/ directories, which will be configuration files, and doc/, which will be more comprehensive documentation.
If you are not sure which version of the application was just installed, a command
like this
#pkg_info | grep -i foopackage
will find all the installed packages that have foopackage in the package name. Replace foopackage in your command line as necessary.
Once you have identified where the application's manual pages have been installed,
review them using man(1). Similarly,
look over the sample configuration files, and any additional documentation that may have
been provided.
If the application has a web site, check it for additional documentation, frequently
asked questions, and so forth. If you are not sure of the web site address it may be
listed in the output from
#pkg_info foopackage-1.0.0
A WWW: line, if present, should provide a URL for the
application's web site.
Ports that should start at boot (such as Internet servers) will usually install a
sample script in /usr/local/etc/rc.d. You should review this
script for correctness and edit or rename it if needed. See Starting Services for more
information.
