We strongly recommend that you check and ensure that you meet the minimum systems requirements outlined below, and understand the server rquirements. We also created a video that follows along with the installation instructions for those who may benefit from additional guidance. If you are already familiar with this process, then skip ahead to Getting Started.
The Indeni .OVA file is preconfigured to launch with 4GB of RAM, 4 Cores and 146.5 GB of hard drive space. A new install of the Indeni Virtual Lab will use ~3.19 GB. For a live production environment, we recommend the use of 5 – 8GB of RAM.
Please Note: As you continue to use the Indeni server memory on the volume will start to increase, so it is best to monitor memory usage as you go. If you run a virtualized Indeni environment and max out your system resources, you may encounter severe performance issues.
To check your hardware settings on Windows:
- Go to Start > right click on Computer and go to Properties.
- You will see system settings under the performance rating. Look for System > Processor and Installed Memory.
- Go to Window Explorer > Computer > Look under your Main Drive to find the amount of free storage.
To check your hardware settings on Mac OS X:
- Click on the Apple Icon (top left corner) > About this Mac > Systems Report
- Virtual Machine: VMware Workstation, ESX or other VM offering such as Virtual Box. VMware Workstation 12.5 was used in this documentation. It is free to use for home, or educational purposes, when you register with a valid email address.
Please Note: Testing has been done exclusively on VMware’s product suite.
- Network Monitoring: Wireshark
- CLI (command-line-interface): Putty for PC users, Terminal for Mac OS X users.
- File Transfer: WinSCP for PC users and Cyberduck for Mac users.
Loading the .OVA
As stated in Helpful Tools  virtual machine, you can use most virtual machines, including freeware versions. However, VMware Workstation was preferred for this exercise due to the ease of DHCP assignment to the Indeni server and connectivity to devices over a VPN.
To Load the OVA, do the following:
- Launch VMware Workstation Player, or preferred virtual machine, and select Open a virtual machine.
Please Note: Typically the default file type VMware looks for is .ISO. You might need to change the file type from .ISO to All Support File Types to find and load the .OVA. Also, if you load multiple images of the .OVA for testing purposes, be sure to delete them in VMware and then check that they have also been removed from the directory.
- Before launching the OVA click on Player > Manage > Virtual Machine Settings > Network Adapter. Make sure that NAT is selected, then load/play the instance.
Installing Indeni on a Virtual Instance
Once the instance launches, login with User: indeni Password: indeni4it
Please Note: It is good to get in the habit of changing default passwords after you have logged in. But do not forget it because Indeni support cannot reset or recover your password after it has been changed. If this happens, please see the following thread on how to reset your admin password in askubuntu.com.
Once you have logged in, it will ask you to continue with the Configuration Wizard. To access the configuration after initial setup, type in ‘isetup‘:
Once the Configuration Wizard continues, you can configure the following:
Proxy: If you manage your own network, then input the appropriate settings for Proxy, if necessary, and open the following ports (8181, 443, 8080) on any firewalls you may have running.
1) Configure-apt proxy
Network Settings: If you have a static IP already configured for this, then you can configure the static IP network settings, otherwise, you can leave at default settings.
2) Configure network interface
NTP: Simply change your timezone, NTP server.
3) Configure NTP Servers 4) Change time zone 5) Change hostname 6) Quit the wizard (also 'q')
Host Name is optional, but you will need to adjust the time zone and make sure the virtual machine clock is correct. Once you have your preferred settings, select (6) Quit to exit the setup.
Please Note: It is best practice to also check the system time on Ubuntu since issues may occur if times are not in sync. To check, type in date +’%:z %Z’. To reset the timezone, type in sudo dpkg-reconfigure tzdata.
After you exit the Configuration Wizard, you should see the currently installed versions. It is okay if the versions differ on your system, the process is still the same:
Please Note: Indeni will not work properly if the collector and server versions do not match.
To complete the installation, type ‘imanage’ then press [enter]. This will take you to Indeni tools:
Select  Show available Indeni packges in source to make sure you have all the indeni packages. You should have indeni-collector, indeni-ds, indeni-server, indeni-tools:
Next, you will want to select  Upgrade all installed Indeni packages:
It will show you the versions available to upgrade. Type ‘y’ or ‘yes’ then [enter] to proceed with the upgrade if Candidate shows a higher version.
Please Note: Depending on your internet connection and system, it may stay at 0-1% Working for up to 20-30 minutes.
After the upgrade, it is always best practice to make sure that it did in fact upgrade. Select  to check installed packages. If they match, select  to Quit Indeni tools:
Please Note: There is no need to restart Ubuntu or services after updating versions. Though you will also want to launch and connect to the Indeni server through your preferred CLI. The virtual machine must remain running in the background.
Next, in the command line, type in ‘ifconfig -a’ to find the IP address that was assigned to the virtual machine. It should be assigned to eth0. Once you have the IP address, make sure and take note of it.
- Launch a browser and enter in the following into the address bar: ’https://[YOUR-eht0-IP]/‘.
Click on continue. The default login is Username: admin and Password: admin123!
Congratulations! You have now successfully setup your Indeni Virtual Lab! You are now ready to add devices to monitor!
Still want more help setting up your virtual lab? We got you covered in this video.