Project

General

Profile

VA Installation » History » Version 3

François Poirotte, 10/22/2017 05:34 PM
Various updates

1 1 François Poirotte
{{>TOC}}
2 1 François Poirotte
3 1 François Poirotte
h1. Vigilo OSS Virtual Appliance (VA) Installation
4 1 François Poirotte
5 1 François Poirotte
h2. General Information
6 1 François Poirotte
7 3 François Poirotte
Vigilo is now available as a virtual appliance for those who want to quickly
8 3 François Poirotte
test it without having to deal with the whole installation process.
9 3 François Poirotte
The appliance is primarily intended for evaluation purposes and can be used
10 3 François Poirotte
to monitor small information systems (< 100 hosts).
11 1 François Poirotte
12 1 François Poirotte
The virtual appliance contains:
13 1 François Poirotte
* Vigilo (OSS / Community Edition)
14 3 François Poirotte
* A web interface for easy configuration based on "GLPI":http://glpi-project.org/
15 3 François Poirotte
* A knowledge base based on "Dokuwiki":https://www.dokuwiki.org/
16 1 François Poirotte
17 1 François Poirotte
Miscelleanous information about the VA:
18 1 François Poirotte
19 1 François Poirotte
| Operating system             | CentOS 7.4 for 64-bit processors |
20 1 François Poirotte
| Language & keyboard layout   | English (United States)          |
21 1 François Poirotte
| Image format                 | OVF 1.0                          |
22 1 François Poirotte
| Tested against               | VirtualBox, VMware Player        |
23 1 François Poirotte
24 1 François Poirotte
Default passwords:
25 1 François Poirotte
26 3 François Poirotte
|_. Entry point                |_. Login/password                       |
27 3 François Poirotte
| Remote administration (SSH)  | @vigilo@/@vigilo@ or @root@/@vigilo@   |
28 3 François Poirotte
| Vigilo's web interfaces      | @admin@/@vigilo@                       |
29 3 François Poirotte
| GLPI's web interface         | @glpi@/@glpi@                          |
30 1 François Poirotte
31 3 François Poirotte
The @vigilo@ user account can use @sudo@ to run privileged commands.
32 1 François Poirotte
33 1 François Poirotte
34 3 François Poirotte
h2. Prerequisites
35 3 François Poirotte
36 3 François Poirotte
We recommend allocating the following resources for the VA:
37 3 François Poirotte
38 3 François Poirotte
|_. Resource    |_. Minimum     |_. Recommended     |
39 3 François Poirotte
| CPU           | dual-core     | quad-core         |
40 3 François Poirotte
| RAM           | 2 GB          | 4 GB              |
41 3 François Poirotte
| Disk storage  | 15 GB         | 30 GB             |
42 3 François Poirotte
43 3 François Poirotte
44 1 François Poirotte
h2. Getting started
45 1 François Poirotte
46 3 François Poirotte
h3. Downloading the Virtual Appliance
47 1 François Poirotte
48 3 François Poirotte
First, you must download the virtual appliance
49 3 François Poirotte
from "this address":https://www.vigilo-nms.org/pkg/va/Vigilo-VA-OSS-4.1.0.zip.
50 1 François Poirotte
51 3 François Poirotte
Next, extract the archive using your favorite manager.
52 3 François Poirotte
We recommend using "7-zip":http://www.7-zip.org/download.html.
53 1 François Poirotte
54 3 François Poirotte
Now, load the description file (@Vigilo-VA-OSS-4.1.0.ovf@)
55 3 François Poirotte
into your virtual machine manager.
56 1 François Poirotte
57 3 François Poirotte
Depending on your installation, you may need to change the configuration
58 3 François Poirotte
of the VA's network interface from NAT to bridged inside your virtual
59 3 François Poirotte
machine manager to receive an IP address.
60 1 François Poirotte
61 3 François Poirotte
h3. Initial setup
62 1 François Poirotte
63 3 François Poirotte
Once the VA is fully booted, log into the VA through your virtual machine
64 3 François Poirotte
manager using the @root@/@vigilo@ login and password.
65 3 François Poirotte
Now run @/usr/local/bin/vigilo-menu@.
66 3 François Poirotte
67 3 François Poirotte
The @vigilo-menu@ command allows you to configure various aspects of the
68 3 François Poirotte
virtual machine, like the default keyboard layout, date/time synchronization,
69 3 François Poirotte
network settings, and so on. It also contains commands to perform various
70 3 François Poirotte
periodic administrative tasks.
71 3 François Poirotte
72 3 François Poirotte
By default, the virtual appliance will try to retrieve an IP address
73 3 François Poirotte
using the DHCP protocol. If you'd rather use a static address, navigate to
74 3 François Poirotte
@System configuration@ > @Network@ > @Network configuration@, then follow
75 3 François Poirotte
the on-screen instructions to reconfigure the network interface.
76 3 François Poirotte
77 3 François Poirotte
Once the network is properly configured, you can use the SSH protocol
78 3 François Poirotte
for future remote management, with either one of the following accounts:
79 3 François Poirotte
* @vigilo@/@vigilo@ (regular user account)
80 3 François Poirotte
* @root@/@vigilo@ (privileged account)
81 3 François Poirotte
82 1 François Poirotte
h3. Using the VA
83 1 François Poirotte
84 3 François Poirotte
Once the VA has been properly set up (see previous chapter), you can access
85 3 François Poirotte
the virtual appliance's web applications by directing your web browser at:
86 3 François Poirotte
<pre>http://<VA IP address>/</pre>
87 1 François Poirotte
88 3 François Poirotte
To start monitoring a new host:
89 3 François Poirotte
# Click on the link to the configuration interface (@http://<VA IP address>/glpi/@) on the homepage
90 3 François Poirotte
# Log in using the @glpi@/@glpi@ username and password, then click on: @Assets@ > @Computers@
91 3 François Poirotte
# In the newly-loaded page, click on the "+" sign in the top-left corner
92 3 François Poirotte
# Select "Blank Template" as the initial template to use
93 3 François Poirotte
# Fill in the host's name and inventory number
94 3 François Poirotte
# Optionally, select one of the default monitoring templates from the "Vigilo Template" dropdown
95 3 François Poirotte
# Click on "Add" to save your changes
96 3 François Poirotte
# Now, in the menu, select @Plugins@ > @Vigilo@
97 3 François Poirotte
# Click the bouton entitled "Deploy the configuration" to apply your changes
98 3 François Poirotte
99 3 François Poirotte
The new host is now monitored. If problems are detected, they will appear
100 3 François Poirotte
automatically in the Alarm dashboard.
101 3 François Poirotte
102 3 François Poirotte
103 1 François Poirotte
h2. Getting help
104 1 François Poirotte
105 3 François Poirotte
The VA includes several documentations (in French).
106 3 François Poirotte
This documentation is available by browsing to @http://<VA IP address>/vigilo/docs/@,
107 3 François Poirotte
or by clicking on the buoy icon in the web interfaces.
108 3 François Poirotte
109 3 François Poirotte
You may also ask others for help on our "community forums":https://vigilo-nms.org/projects/vigilo/boards