Skip to content

Commit 2379879

Browse files
ktoliverktoliver
authored
Merge pull request #57715 from rotycenh/rotycenh-IBM-Db2-pureScale-articles
Publish IBM Db2 pureScale documents
2 parents 485b916 + b3c7b73 commit 2379879

File tree

4 files changed

+269
-0
lines changed

4 files changed

+269
-0
lines changed

‎articles/virtual-machines/linux/deploy-ibm-db2-purescale-azure.md

Lines changed: 156 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,156 @@
1+
---
2+
title: Deploy IBM Db2 pureScale on Azure
3+
description: Learn how to deploy an [example architecture](ibm-db2-purescale-azure.md) used recently to migrate an enterprise from their IBM Db2 environment running on z/OS to IBM Db2 pureScale on Azure.
4+
services: virtual-machines-linux
5+
documentationcenter: ''
6+
author: njray
7+
manager: edprice
8+
editor: edprice
9+
tags:
10+
11+
ms.assetid:
12+
ms.service: virtual-machines-linux
13+
ms.workload: infrastructure-services
14+
ms.tgt_pltfrm: vm-linux
15+
ms.devlang: na
16+
ms.topic: article
17+
ms.date: 11/09/2018
18+
ms.author: njray
19+
20+
---
21+
22+
# Deploy IBM Db2 pureScale on Azure
23+
24+
This article describes how to deploy an [example architecture](ibm-db2-purescale-azure.md) used recently to migrate an enterprise from their IBM Db2 environment running on z/OS to IBM Db2 pureScale on Azure.
25+
26+
To follow the steps used during the migration, see the installation scripts in [Db2onAzure](http://aka.ms/db2onazure) repository on GitHub. These scripts are based on the architecture used for a typical, medium-sized online transaction processing (OLTP) workload.
27+
28+
## Get started
29+
30+
To deploy this architecture, download and run the deploy.sh script found in the [Db2onAzure](http://aka.ms/db2onazure) repository on GitHub.
31+
32+
The repository also includes scripts you can use to set up a Grafana dashboard that can be used to query Prometheus, the open-source monitoring and alerting system included with Db2.
33+
34+
> [!NOTE]
35+
> The deploy.sh script on the client creates private SSH keys and passes them to the deployment template over HTTPS. For greater security, we recommend using [Azure Key Vault](https://docs.microsoft.com/azure/key-vault/key-vault-overview) to store secrets, keys, and passwords.
36+
37+
## How the deployment script works
38+
39+
The deploy.sh script creates and configures the Azure resources that are used in this architecture. The script prompts you for the Azure subscription and virtual machines used in the target environment, and then performs the following operations:
40+
41+
- Sets up the resource group, virtual network, and subnets on Azure for the installation.
42+
43+
- Sets up the NSGs and SSH for the environment.
44+
45+
- Sets up multiple NICs on both the GlusterFS and the Db2 pureScale virtual machines.
46+
47+
- Creates the GlusterFS storage virtual machines.
48+
49+
- Creates the jumpbox virtual machine.
50+
51+
- Creates the Db2 pureScale virtual machines.
52+
53+
- Creates the witness virtual machine that Db2 pureScale pings.
54+
55+
- Creates a Windows virtual machine to use for testing but does not install anything on it.
56+
57+
Next, the deployment scripts set up iSCSI virtual storage area network (vSAN) for shared storage on Azure. In this example, iSCSI connects to GlusterFS. This solution also gives you the option to install the iSCSI targets as a single Windows node. (iSCSI provides a shared block storage interface over TCP/IP that allows the Db2 pureScale setup procedure to use a device interface to connect to shared storage.) For GlusterFS basics, see the [Architecture: Types of volumes](https://docs.gluster.org/en/latest/Quick-Start-Guide/Architecture/) topic in Getting started with GlusterFS.
58+
59+
The deployment scripts execute these general steps:
60+
61+
1. Set up a shared storage cluster on Azure. GlusterFS is used to set up the shared storage cluster. This involves at least two Linux nodes. For setup details, see [Setting up Red Hat Gluster Storage in Microsoft Azure](https://access.redhat.com/documentation/en-us/red_hat_gluster_storage/3.1/html/deployment_guide_for_public_cloud/chap-documentation-deployment_guide_for_public_cloud-azure-setting_up_rhgs_azure) in the Red Hat Gluster documentation.
62+
63+
2. Set up an iSCSI Direct interface on target Linux servers for GlusterFS. For setup details, see [GlusterFS iSCSI](https://docs.gluster.org/en/latest/Administrator%20Guide/GlusterFS%20iSCSI/) in the GlusterFS Administration Guide.
64+
65+
3. Set up the iSCSI Initiator on the Linux virtual machines that will access the GlusterFS cluster using iSCSI Target. For setup details, see the [How To Configure An iSCSI Target And Initiator In Linux](https://www.rootusers.com/how-to-configure-an-iscsi-target-and-initiator-in-linux/) in the RootUsers documentation.
66+
67+
4. Installs GlusterFS as the storage layer for the iSCSI interface.
68+
69+
After creating the iSCSI device, the final step is to install Db2 pureScale. As part of the Db2 pureScale setup, [IBM Spectrum Scale](https://www.ibm.com/support/knowledgecenter/SSEPGG_11.1.0/com.ibm.db2.luw.qb.server.doc/doc/t0057167.html) (formerly known as GPFS) is compiled and installed on the GlusterFS cluster. This clustered file system enables Db2 pureScale to share data among the multiple virtual machines that run the Db2 pureScale engine. For more information, see the [IBM Spectrum Scale](https://www.ibm.com/support/knowledgecenter/en/STXKQY_4.2.0/ibmspectrumscale42_welcome.html) documentation on the IBM website.
70+
71+
## Db2 pureScale response file
72+
73+
The GitHub repository includes Db2server.rsp, a response (.rsp) file that enables you to generate an automated script for the Db2 pureScale installation. The following table lists the Db2 pureScale options that the response file uses for setup. You can customize the response file as needed for your installation environment.
74+
75+
> [!NOTE]
76+
> A sample response file, Db2server.rsp, is included in the [Db2onAzure](http://aka.ms/db2onazure) repository on GitHub. If you use this file, you must edit it before it can work in your environment.
77+
78+
**Db2 pureScale response file options**
79+
80+
| Screen name | Field | Value |
81+
|---------------------------|----------------------------------------------|-------------------------------------------------------------------------------------------------------|
82+
| Welcome | | New Install |
83+
| Choose a Product | | Db2 Version 11.1.3.3. Server Editions with Db2 pureScale |
84+
| Configuration | Directory | /data1/opt/ibm/db2/V11.1 |
85+
| | Select the installation type | Typical |
86+
| | I agree to the IBM terms | Checked |
87+
| Instance Owner | Existing User For Instance, User name | Db2sdin1 |
88+
| Fenced User | Existing User, User name | Db2sdfe1 |
89+
| Cluster File System | Shared disk partition device path | /dev/dm-2 |
90+
| | Mount point | /Db2sd\_1804a |
91+
| | Shared disk for data | /dev/dm-1 |
92+
| | Mount point (Data) | /Db2fs/datafs1 |
93+
| | Shared disk for log | /dev/dm-0 |
94+
| | Mount point (Log) | /Db2fs/logfs1 |
95+
| | Db2 Cluster Services Tiebreaker. Device path | /dev/dm-3 |
96+
| Host List | d1 [eth1], d2 [eth1], cf1 [eth1], cf2 [eth1] | |
97+
| | Preferred primary CF | cf1 |
98+
| | Preferred secondary CF | cf2 |
99+
| Response File and Summary | first option | Install Db2 Server Edition with the IBM Db2 pureScale feature and save my settings in a response file |
100+
| | Response file name | /root/DB2server.rsp |
101+
102+
### Notes about this deployment
103+
104+
- The values for /dev-dm0, /dev-dm1, /dev-dm2, and /dev-dm3 can change after a reboot on the virtual machine where the setup takes place (d0 in the automated script). To find the right values, you can issue the following command before completing the response file on the server where the setup will be run:
105+
106+
```
107+
[root\@d0 rhel]\# ls -als /dev/mapper
108+
total 0
109+
0 drwxr-xr-x 2 root root 140 May 30 11:07 .
110+
0 drwxr-xr-x 19 root root 4060 May 30 11:31 ..
111+
0 crw------- 1 root root 10, 236 May 30 11:04 control
112+
0 lrwxrwxrwx 1 root root 7 May 30 11:07 db2data1 -\> ../dm-1
113+
0 lrwxrwxrwx 1 root root 7 May 30 11:07 db2log1 -\> ../dm-0
114+
0 lrwxrwxrwx 1 root root 7 May 30 11:26 db2shared -\> ../dm-2
115+
0 lrwxrwxrwx 1 root root 7 May 30 11:08 db2tieb -\> ../dm-3
116+
```
117+
118+
- The setup scripts use aliases for the iSCSI disks so that the actual names can be found easily.
119+
120+
- When the setup script is run on d0, the **/dev/dm-\*** values may be different on d1, cf0 and cf1. The Db2 pureScale setup does not care.
121+
122+
## Troubleshooting and known issues
123+
124+
The GitHub repo includes a Knowledge Base maintained by the authors. It lists potential issues you may encounter and resolutions you can try. For example, known issues can occur when:
125+
126+
- Trying to reach the gateway IP address.
127+
128+
- Compiling GPL.
129+
130+
- The security handshake between hosts fails.
131+
132+
- The Db2 installer detects an existing file system.
133+
134+
- Manually installing GPFS.
135+
136+
- Installing Db2 pureScale when GPFS is already created.
137+
138+
- Removing Db2 pureScale and GPFS.
139+
140+
For more information about these and other known issues, see the kb.md file in the [Db2onAzure](http://aka.ms/Db2onAzure) repo.
141+
142+
## Next steps
143+
144+
- [GlusterFS iSCSI](https://docs.gluster.org/en/latest/Administrator%20Guide/GlusterFS%20iSCSI/)
145+
146+
- [Creating required users for a Db2 pureScale Feature installation](https://www.ibm.com/support/knowledgecenter/en/SSEPGG_11.1.0/com.ibm.db2.luw.qb.server.doc/doc/t0055374.html?pos=2)
147+
148+
- [Db2icrt - Create instance command](https://www.ibm.com/support/knowledgecenter/en/SSEPGG_11.1.0/com.ibm.db2.luw.admin.cmd.doc/doc/r0002057.html)
149+
150+
- [Db2 pureScale Clusters Data Solution](http://www.ibmbigdatahub.com/blog/db2-purescale-clustered-database-solution-part-1)
151+
152+
- [IBM Data Studio](https://www.ibm.com/developerworks/downloads/im/data/index.html/)
153+
154+
- [Platform Modernization Alliance: IBM Db2 on Azure](https://www.platformmodernization.org/pages/ibmdb2azure.aspx)
155+
156+
- [Azure Virtual Data Center Lift and Shift Guide](https://azure.microsoft.com/resources/azure-virtual-datacenter-lift-and-shift-guide/)

0 commit comments

Comments
 (0)