Deploying NPS toolkit VM

NPS toolkit is deployed as a VM. The host operating system of the machine where the NPS toolkit is deployed can be Linux or Windows. The VM is deployed using Vagrant and which uses Virtual box or VMware Workstation as hypervisor layer.

This procedure is applicable for Linux host machine.

NOTE:

For Windows or other host machines, bring up virtual machine as specified in Specifications of NPS Toolkit Virtual Machine.

Prerequisites

Networking and switches
- Ensure that all connections are as per the port map.
- Ensure that the management interface of HPE FlexFabric 5900 (management switch) is connected with the customer infrastructure switch and part of iLO VLAN.
- Ensure that the out-of-band management port (M0/0/0) of HPE FlexFabric 5900 is defined and statically assigned in the range of iLO-OOBM range.
- Ensure that the OAM and iLO IP addresses of the core switch are defined.
NPS toolkit host
- Ensure that customer network IP (OAM IP) is assigned to the NPS toolkit host.
- Ensure that there is Internet connectivity available for NPS toolkit host.
- Ensure that the capacity of the directory for copying the install bits is more than 300 GB.
- Ensure that the NPS toolkit host has minimum 4 GB RAM and 4 CPUs allocation.
- Ensure that the latest RHEL OS is installed in the NPS toolkit host. This must be a virtualization host.
  NOTE:
  During RHEL OS installation in the host machine, select Software Selection > Base Environment and click Virtualization Host.
- Ensure that the NPS toolkit host is not registered with an existing Red Hat subscription. If the NPS toolkit host is registered, unsubscribe from the subscription. For more information, see Unregistering Red Hat Subscription.
NPS toolkit VM
- Ensure that you have downloaded the latest NPS and VIM bits from the HPE My Software Center kiosk.
- Ensure that a Customer Network IP address is provided for the NPS toolkit VM in the TICG while creating the input.json file. NPS toolkit VM is accessed remotely using the assigned Customer Network IP address.

Procedure

Log in to the NPS toolkit host.
Create a sync folder using the following commands:
```
mkdir /var/nps
cd /var/nps
```
Copy the nps*.tar.gz and Cloud_RHOSP13_*.tar.gz files that you downloaded from the My HPE Software Center to the sync folder.
NOTE:
You can change the sync folder from /var/nps to any other folder of your choice. However, ensure that the same input is mentioned in the source_input.rc for sync_folder variable, otherwise the NPS toolkit VM creation will fail.
Rename nps2*.tar.gz to nps2.tar.gz and Cloud_RHOSP13_*.tar.gz to cloud.tar.gz using the following commands:
```
mv nps2*.tar.gz nps2.tar.gz
mv Cloud_RHOSP13_*.tar.gz cloud.tar.gz
```
Extract the nps2.tar.gz using the following commands:
```
tar -zxvf nps2.tar.gz
```
NOTE:
After the untar operation, the "nps2" folder is created.

Update the source_input.rc file available in /var/nps/nps2/install/utils folder with all the information required for NPS toolkit VM installation. navigate using the following command: .

Navigate to /var/nps/nps2/install/utils/source_input.rc file using the following command:
```
cd /var/nps/nps2/install/utils
```
Edit the source_input.rc

vi source_input.rc

The following is a sample file and can be used for reference only:

export customer_interface=eno1
export customer_ip=xx.xx.xx.xx
export customer_gw=xx.xx.xx.xx
export vm_name=NPS
export host_name=NPSVM
export root_password=************
export vagrant_user_password=************
export sync_folder=/var/nps
export resize=yes
export vm_size=300
export vm_vcpu=2
export vm_memory=2
export VIM_TYPE=rhosp
export infrastructure=baremetal
export release_name=nps2
export proxy_port=8080
export proxy_hostname=xx.xx.xx.xx
export pool_id_physical=1425ehfur7393ikde639ej
export pool_id_virtual=123346778908987635374gar7829e4
export rhel_username=*****
export rhel_password=******
export unregister_host=yes
export unregister_vm=no

For more information about the parameters, see source_input.rc file update for deploying NPS toolkit VM.

NOTE:

If user wants to deploy RHOSP using NPS, then provide RHOSP pool IDs (pool_id_physical and pool_id_virtual). See Retrieving Pool ID from Red Hat Subscription.

Perform RHEL subscription and update the packages using the following command:

source update_packages.sh

The following prompt is displayed:

Reboot required !! type yes/y and press Enter to reboot now, else press
any other key followed by Enter key if you want to manually reboot later :

Type yes/y to reboot the NPS toolkit host.
Log in to the NPS toolkit host as root user.
Create the NPS toolkit VM using the following commands:
```
cd /var/nps/nps2/install/utils
source create_nps_vm.sh
```
The NPS toolkit VM is created.
Navigate to <sync_folder>/nps and run the following command to verify that the NPS VM is operational:
```
cd <sync_folder>/nps
source source.rc
vagrant status
```
Where, <sync_folder> is the folder that you created to copy the NPS toolkit and VIM automation tar balls.
Log in to the NPS toolkit VM.
Verify the size of the root partition in the NPS toolkit VM:
1. Login to the NPS toolkit VM using the credentials defined in the source_input.rc file and run the following command:
```
df -h
```
  - If the <resize> parameter was set to yes the <vm_size> parameter displays the user-defined size.
  - If the <resize> parameter was set to no, the <vm_size> parameter displays the default size (29GB).