Disk assignment and the provisioning of the data directories for the MOI BYOOS release

Products

• Mainframe Operational Intelligence

Issue/Introduction

Disk assignment is the process of formatting and adding provisioned disk drives both for x86 and s390x environments in order to add them to LVM's that are needed by MOI for the Bring Your Own Operating System release.  The required script, moi-diskutil.sh is attached to this KD.  

Environment

Release : MOI 2.1 

Component : MF OPERATIONAL INTELLIGENCE

Resolution

Provisioning data directories

Typically following steps are involved in provisioning data directories for MOI installation:

1. Formatting Disks
2. Adding Disks to Logical data volumes (LVMs)
3. Creating data directories

 

In order to run these following steps, please download the moi-diskutil_1635858526775.sh script and place it on the machine you wish to run MOI on. Make sure the script is executable

 

chmod +x moi-diskutil_1635858526775.sh

 

Formatting Disks

If the Disks are already formatted and ready to be used, skip this first step. First time disk assignment will need to format Disks.

Formatting will wipe all data from the disks. This action is not reversible.  DO NOT FORMAT IF YOU DON'T WANT TO LOSE THE DATA!!!  Please contact Broadcom MOI Support if in doubt.  

         ./moi-diskutil_1635858526775.sh  expose 0.0.0301

 

To display the available disks for the MOI installation, execute the following command: 

./moi-diskutil_1635858526775.sh disks

Format each additional disk i.e. devpath from the moi-diskutil.sh disks command above using the following command:  

./moi-diskutil_1635858526775.sh format /dev/disk/by-path/<devpath name as displayed by ./moi-diskutil_1635858526775.sh disks>

This step may take time to process. A successful run will be denoted by ‘Finished formatting the device' .

 

By running this script,   ./moi-diskutil_1635858526775.sh disks, you can confirm that the devstat for the formatted Disks reads ‘Free’ now that disk has been successfully formatted,  

Repeat these steps for all remaining disks.

 

Adding Disks to Logical data volumes (LVMs)

Once the disks are formatted, it can be added to logical data volumes (LVMs).

Create three different LVMs - lvm1, lvm2, and lvm3 which can be used to mount data1, data2, and data3 directories. Additionally a lvm0 will be created.

 

Follow these steps for all 4 LVMs (lvm0, lvm1, lvm2, lvm3)

In order to create LVMs, run the following command by providing the LVM name and the devpath :

./moi-diskutil_1635858526775.sh lvmadd <lvmN> <devpath name displayed by moi-diskutil.sh disks>

Verify the disk assignment status after the lvm is added using the following command: 

./moi-diskutil_1635858526775.sh AnalyzeFileSystem /<lvmN>

The fsstatus should be Healthy.

Repeat these steps for all remaining disks.

Here is an example output of the command mount | grep lvm to show the LVM mounts once ready: 

 

Creating data directories

As LVMs are ready, create directories to hold the MOI data.

 

mkdir -p /lvm1/data

mkdir -p /lvm2/data

mkdir -p /lvm3/data

mkdir -p /lvm1/share

 

mkdir /var/opt/moi

 

Create soft links to MOI’s default data location as follows :

 

ln -sfn /lvm1/data /var/opt/moi/data1

ln -sfn /lvm2/data /var/opt/moi/data2

ln -sfn /lvm3/data /var/opt/moi/data3

ln -sfn /lvm1/share /var/opt/moi/share

 

Now the required data directory structure is ready for MOI. Here is an example output of the command ls -lart /var/opt/moi | grep data  :  

Once the data directories are ready to be used for MOI, ensure that directories are accessible and of expected size.

Additional Information