Getting Started On A PC

From the Start – How to Setup Device42 from the Beginning on a PC

Prerequisites:

To use Device42 you will need a hypervisor such as VMWare or Virtualbox to manage and use virtual machines. If you do not have one, you can download one for free from https://www.virtualbox.org
Download VirtualBox

To install VirtualBox, open the downloaded file and double-click the “VirtualBox.pkg” icon, then you can find VirtualBox in your Applications list.

VirtualBox Installation

Discovery Account WARNING: Please do not set up an auto-discovery / scan using critical [production] account credentials! Please create a separate, dedicated account to use only for discovery

Depending on permissions granted & your configured password policies, account lock-out could result in an otherwise completely avoidable outage. You, the customer, are responsible for any such behavior that might result if you choose to ignore this requirement.

Installing Device42

To download Device42, visit Device42 and enter your name and email address. You will receive a download link in your email momentarily. Once you receive the link, download the VirtualBox version from the options given, as seen in the screenshot below:
Download Device42

Once the file has downloaded, you can unzip it using 7-Zip, which is a free program available through the App store or from their website, 7-Zip.
7-Zip installation

From VirtualBox, click the “New” icon, and name your virtual machine, we will use “Device42” in this tutorial:
Create new VM

We recommend 2GB of memory at a minimum and suggest 4GB to be sure Device42 runs smoothly.
Memory settings

On the Hard Disk screen, choose “Use an existing virtual hard disk file” and browse to the Device42 vmdk file that you extracted using 7-Zip.

Choose Device42 hard disk vmdk file

After choosing the hard disk you can follow through with any further default settings, but uncheck “Power on after Create” if it is selected.

Additional VM Settings

Right click on the newly created virtual machine in VirtualBox that appears on the left and choose “Settings”.
In the window that pops up, select the “System” tab, and then “Processor”, and click the checkbox in “Extended Features” to “Enable PAE/NX”:

Enable PAE

Continuing to the “Network” tab, enable adapter 1 and set it to bridged (note, NAT will also work), and choose the physical NIC/network card you will be using. You can then click OK and close the settings window.

Enable Network Adapter

Starting the Virtual Machine

Once the VM settings have been configured you can power on the virtual appliance. If you receive an audio driver warning you can ignore it.
At the login screen, the username is “device42” and the password is “adm!nd42”. Please change these when you first login under option 10.

Device42 Console Login

After you are logged in, you can configure your IP settings(dhcp or static) under option 1 [Please use a STATIC IP for all production Device42 VMs to avoid connectivity issues]:

Device42 menu

You can apply updates and do other menu-related work using by connecting through ssh using the terminal. Please note that root login has been disabled via ssh.
Last, point your browser to the address at the top of the console menu and you’re ready to go…

You will receive a “Your Connection is not private” warning in your browser as you are accessing a local server that does not have a signed security certificate but it is safe to click “show advanced” in Chrome or “I understand the risks” in Firefox and proceed through to the Device42 login screen:
SSL Warning that you can ignore

At the login screen you can log in using the default name and password: admin/adm!nd42 and you can now start using Device42!

Device42 Web UI Login

What’s next?

To continue through our documentation, you may want to view our tutorials next.