Installing the OVA

Prerequisites

  • Log in to the IP address of a VMware ESXi server running 6.5 and above via a web browser with your user credentials (username and password).

  • Ensure that you meet the VMware server machine (VM CPU and memory) requirements as listed below.

    • 24 GB memory

    • 4 vCPUs

    • Hard disk: 450 GB

To install the OVA:


Attention

From IoT FND 4.12 onwards, use the following credentials for SSH access after installing OVA. The existing credentials username/password (root/cisco123) is disabled for 4.12 and later releases:

  • Username: fnduser

  • Password: C!sco123

    See Step 10 for guidelines to reset the default password.

Procedure

Step 1

Log in to the IP address of a VMware ESXi server running 6.5 and above via a web browser with your user credentials (username and password).

  1. Enter the ESXi IP address in the URL.

  2. Provide the ESXi root login credentials and click Log In.

Step 2

In the Host page, select Create/ Register VM.

Step 3

In the New virtual machine window, select Deploy a virtual machine from an OVF or OVA file in Select creation type tab and click Next.

Step 4

In the Select OVF and VMDK files tab, provide a name for the virtual machine and browse to an OVF package from the internet or a file accessible from your computer (for example, iot-fnd-4.10.0-40.ova). Click Next.

Step 5

Select a storage location for the virtual machines from the listed options (example - Datastore-2).

Step 6

After selecting the data store, select the provisioning type and enable the Power on automatically option. This ensures to power on the virtual machine once the deployment process is complete. Click Next.

Note

 

  • Thick Provisioning — Absolute reservation on the disk space. For the IoT FND OVA deployment, the disk space required is 600 GB on the ESXi server.

  • Thin Provisioning — The disk space grows on demand. For the IoT FND OVA deployment, the disk space is approximately 50 GB initially and the disk space occupied by VM will grow as per the scale of deployment.

Note

 

If the selected storage location does not have sufficient storage for the largest file installation option, a message displays noting insufficient storage. If the warning message appears, select another storage resource with greater capacity and click Next.

Step 7

Do a final review of the Ready to Complete window. If you do not want to change any settings, click Finish.

Note

 

If you see the following warning message while deployment, then cancel the upload, disconnect the Esxi from vCenter Server (Actions > Disconnect from vCenter Server) and then re-upload OVA. The upload will be successful.

"Failed: Access to resource settings on the host is restricted to the server that is managing it 'vCenter Server IP'"

The virtual machine deployment is initiated. After completion of the install, the "Completed successfully" message appears in the Recent tasks pane at the bottom of the install window.

Step 8

Click Virtual Machines in the left pane and select the newly deployed VM.

Step 9

The deployed VM gets listed in the left pane. Select the IoT FND machine name.

Step 10

Click Console and login with root/cisco123 once the OS is up. Once you enter the default password, you are prompted to reset your password.

Important

 
From IoT FND release 4.12 onwards:

  • The default root user password is C!sco123.

  • The following conditions are applicable to reset the default password.

    • The password must be at least 8 characters in length

    • The password must have at least 1 uppercase character

    • The password must have at least 1 lowercase character

    • The password must have at least 1 special character

    • The password must have at least 1 digit

    • The password cannot be the same as any of the previous 5 passwords used

Step 11

Reset the default root password. After you complete the password reset, IoT FND is fully deployed. From FND 4.12 release, the conditions mentioned in Step 10 are applicable to reset the default password.

Step 12

Once logged in, navigate to Applications > System Tools > Settings > Network.

Step 13

Click the cog icon under Wired, navigate to IPv4 tab to assign a static IP address or set up a DHCP server in the network.

  • Under IPv4 tab, select the method as Manual and provide the IPv4 address as below and click Apply.

  • Set up a valid, reachable working DNS server on the Host VM. (mandatory) Use this IP address to access the FND GUI.

Important

 

Follow the same steps for TPS OVA installation as well. In order to upgrade the TPS OVA, delete the existing TPS and reinstall the TPS OVA iot-tps-version_number.ova with the updated version number.

Step 14

Open a terminal window, and set up Health Monitoring for the Fog Director Container from FND.

[root@iot-fnd ~]# cd /opt/monitor/

After completing these steps, IoT FND starts monitoring the Fog Director container on the ADMIN > SERVERS page.

Note

 

Starting from Cisco IoT FND Release 4.3.1 and later releases, you can fetch the Host VM's hostnames and their corresponding IP addresses. Use the hostnames while onboarding Cisco IoT FND.

Domain names are configured in the /etc/hosts file. Use this configuration for the Zero Touch Deployment (ZTD) and Plug and Play (PNP) of FAR devices. The domain name helps in resolving FND or TPS hostname with an IP address. They help in the communicating with FND.

To view the Host VM hostnames refer to the example given.

Example: 
[root@iot-fnd ~]# cat /etc/hosts
127.0.0.1  iot-fnd-oracle localhost localhost.localdomain localhost4 localhost4.localdomain4
::1        iot-fnd-oracle localhost localhost.localdomain localhost6 localhost6.localdomain6
209.165.200.225  fnd.iot.cisco.com
209.165.201.1  tps.iot.cisco.com

To configure the FND domain name refer to the example given.

Example:
root@iot-fnd ~]# nano /etc/hosts
127.0.0.1  iot-fnd-oracle localhost localhost.localdomain localhost4 localhost4.localdomain4
::1        iot-fnd-oracle localhost localhost.localdomain localhost6 localhost6.localdomain6
209.165.200.225  fnd.iot.cisco.com
209.165.201.1  tps.iot.cisco.com

Save the configuraration.

To validate the configured FND domain name refer to the example given.

Example: 

[root@iot-fnd-oracle ~]# ping fnd.iot.cisco.com
PING fnd.iot.cisco.com (209.165.200.225) 56(84) bytes of data.
64 bytes from fnd.iot.cisco.com (209.165.200.225): icmp_seq=1 ttl=64 time=0.053 ms

The hostnames are configured on both the TPS and Cisco IoT FND servers.