Deploying NPS toolkit VM

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 the 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 the management switch is defined and statically assigned in the iLO-OOBM range.
- Ensure that the OAM and iLO IP addresses of the customer infrastructure 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 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.
- Contact HPE Sales and Support team to ascertain the NPS toolkit (nps2-*.tar.gz) and VIM automation (<rhocp_tar>.tar.gz) tar files for deployment.

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 toolkit and VIM automation tar files to sync folder.
Rename nps2*.tar.gz to nps2.tar.gz and <rhocp_tar>.tar.gz to cloud.tar.gz using the following commands:
```
mv nps2-*.tar.gz nps2.tar.gz
mv <vim_tar>.tar.gz cloud.tar.gz
```
Extract the nps2.tar.gz using the following command:
```
tar -zxvf nps2.tar.gz
```
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.

NOTE:

For pool_id_virtual and pool_id_physical, search for the subscription name "Red Hat OpenShift, Standard Support (10 Cores, NFR, Partner Only)" and pick the respective IDs.

Update using the following:

Navigate to /var/nps/nps2/install/utils/ 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=NPSVM
export host_name=nps.domainname.com
export root_password=*****
export sync_folder=/var/nps
export resize=yes
export vm_size=300
export vm_vcpu=2
export vm_memory=2
export VIM_TYPE=rhocp
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
export vagrant_user_password=vagrant

For more information about the parameters, see Parameter descriptions in source_input.rc file.

Perform the 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 and press Enter to reboot the NPS toolkit host.
Log in to the NPS toolkit host.
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 toolkit VM is operational:
```
cd <sync_folder>/nps
source source.rc
vagrant status
```
The NPS toolkit VM must be in running state.
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 (29 GB).