Installing OpenStack on a Single Node via Packstack

The Packstack scripts will deploy an OpenStack environment on one node. Two VM instances will be running after the installation.

About this task

Two VMs will be running on a single server connected via a VLAN network when the installation is complete.

Before you begin

The SmartNIC is updated with an appropriate FPGA image. See Updating the FPGA image.
Start with a clean installation of a Linux system
Note: Choose Server on the Base Environment list for Software Selection at the Installation Summary screen.

Note: Packstack will download and install all the additional dependencies.
Prepare a VM base image and place on the host.

Note: According to the Packstack official documentation, there is no process to uninstall OpenStack in general. You must reinstall the base OS to uninstall and reinstall OpenStack.

Procedure

Unpack the packstack-napatech package.
```
cd <package_root_directory>/openstack/
tar zxvf packstack-napatech-<version>.main.tar.gz
```
where:
- version is the Napatech Packstack package version identifier.

Copy the RPM packages for the Napatech tools and Napatech OVS/DPDK to the correct directory.

cd packstack/singlenode/Napatech
cp <package_root_directory>/software/nt-driver-vswitch-<version>.x86_64.rpm .
cp <package_root_directory>/software/nt-driver-vswitch-devel-<version>.noarch.rpm .
cp <package_root_directory>/software/nt-driver-vswitch-modules-<version>.x86_64.rpm .
cp <package_root_directory>/tools/nt-tools-vswitch-<version>.x86_64.rpm .
cp <package_root_directory>/ovs-hwaccel/ovs-hwaccel-<version>.x86_64.rpm .
cp <package_root_directory>/dpdk-hwaccel/dpdk-hwaccel-<version>.src.rpm .

where:

package_root_directory is the directory to the unpacked Napatech package.
version is the version identifier of the corresponding package.

Edit local.conf.
```
cd <package_root_directory>/openstack/packstack/singlenode/
vim local.conf
```
Update the file path and the file name of the VM base image as well as the image name. The default values are set as follows:
```
IMAGE="/root/Fedora-Cloud-Base-33-1.2.x86_64.qcow2"
IMAGE_NAME="fedora"
```
Run the prepare.sh script.
```
./prepare.sh
```
The prepare.sh script configures the server as follows.
- Configure kernel parameters and huge page memory.
- Update the system and install required software packages.
- Install the Napatech tools and services.
- Install Packstack.
- Disable SELinux.
- Reboot the server.
An output example:
```
...
Do you wish to reboot system now?
```
Type y to reboot the system.

Run the deploy.sh script after the system is restarted.

cd <package_root_directory>/openstack/packstack/singlenode/
./deploy.sh

The deploy.sh script deploys OpenStack.

Prepare the configuration file for Packstack deployment.
Validate the Packstack configuration file.
Deploy OpenStack via Packstack.

An output example:

...
  **** Installation completed successfully ******

Additional information:
 * Time synchronization installation was skipped. Please note that unsynchronized time on server instances might be problem for some OpenStack components.
 * Warning: NetworkManager is active on <host_IP>. OpenStack networking currently does not work on systems that have the Network Manager service enabled.
 * File /root/keystonerc_admin has been created on OpenStack client host <host_IP>. To use the command line tools you need to source the file.
 * To access the OpenStack Dashboard browse to http://<host_IP>/dashboard .
Please, find your login credentials stored in the keystonerc_admin in your home directory.
 * The installation log file is available at: /var/tmp/packstack/20220124-083821-jfp3mpke/openstack-setup.log
 * The generated manifests are available at: /var/tmp/packstack/20220124-083821-jfp3mpke/manifests
 * Note temporary directory /var/tmp/packstack/d4b225adf8ca4018834945c25720ab22 on host <host_IP> was not deleted for debugging purposes.

where: host_IP is the IP address of the host.

Run the configure-os.sh script.
```
./configure-os.sh
```
The configure-os.sh script applies the Napatech OpenStack configurations as follows.
- Replace the default Open vSwitch with the Napatech Open vSwitch.
- Apply the OpenStack patches.
- Apply the OpenStack configuration parameters.
- Set up a demo network configuration in OpenStack (optional).
  Note: By default, the m1.medium flavor is used to create a VM instance. Change to a suitable flavor for your system. See Note: The flavor types and the number VM instances to determine required hardware configurations
An output example:
```
...
Do you wish to setup a demo network?
```
Type y if you would like to get a demo network configured automatically.

Check the status of the VMs.

source /root/keystonerc_admin
openstack server list

An output example:

...
++ openstack server list
+--------------------------------------+----------+--------+--------------------+----------+-----------+
| ID                                   | Name     | Status | Networks           | Image    | Flavor    |
+--------------------------------------+----------+--------+--------------------+--------- +-----------+
| a441bc43-097a-40e0-8467-21e156c938d5 | server20 | ACTIVE | net10=192.168.1.20 | vm-image | m1.medium |
| 17fb4ce4-09ca-4a45-8354-dfe0bad8a66f | server10 | ACTIVE | net10=192.168.1.10 | vm-image | m1.medium |
+--------------------------------------+----------+--------+--------------------+----------+-----------+

Two VMs are listed if you typed y in step 6.