Project

General

Profile

VA Installation » History » Version 6

François Poirotte, 10/22/2017 07:07 PM
Add steps to check the download for possible corruption

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