Installing the DB2 pureScale Feature using the DB2 Setup wizard (AIX and Linux)

This topic walks you through the DB2 Setup wizard to install the IBM® DB2® pureScale® Feature. The DB2 Setup wizard is a GUI installer, invoked by running the db2setup command.

1. Log in as root.
2. Ensure the DB2 installation image available. After downloading the DB2 database product image, extract and untar the product file:
   1. Extract the product file using the gzip -d product.tar.gz command, where product represents the name of the downloaded product.
   2. Untar the product file using the gnutar -xvf product.tar command, where product represents the name of the downloaded product.
   3. Change directory using the cd ./product command, where product represents the name of the downloaded product.
3. Ensure you export your display. For example:

   export DISPLAY=IP_Address:0.0

   Where IP_Address represents the IP address of the workstation you are using to launch the installation.
4. Start the DB2 Setup wizard by running the db2setup command from the directory where the DB2 installation image resides:

   ./db2setup -l /tmp/db2setup.log -t /tmp/db2setup.trc

   The -l and -t recommended parameters that enable DB2 logging and tracing. The IBM DB2 Setup Launchpad opens.
   Figure 1. DB2 Setup Launchpad

   
   From this window, you can view the DB2 pureScale Feature release information, upgrade options, architectural overview, and pre-installation planning, or you can proceed directly to the installation.
5. Click Install a Product and the Install a Product window displays the products available for installation.
   Figure 2. Install a Product window

   
   Click Install New under DB2 Enterprise Server Edition Version 10.1 with the IBM DB2 pureScale Feature. Installation help can guide you through each of the installation panels. To invoke the installation help, click Help or press F1. You can click Cancel at any time to end the installation. If you are performing an upgrade, select the Install New option.
6. Welcome Panel.
   Figure 3. DB2 Setup wizard Welcome Panel

   
   Click View Features to view the features to be installed. The View Features dialog box opens and displays the features to be installed. Click Close to close the View Features dialog box.

   Click Next to continue.

7. Software License Agreement Panel.
   Figure 4. Software License Agreement Panel

   
   After reviewing the software licensing agreement, select Accept to accept the terms. Click Next.
8. Select installation, response file creation, or both Panel
   Figure 5. Select installation, response file creation, or both Panel

   
   You can use the DB2 Setup wizard to:
   • Install the product. When you are finished stepping through the DB2 Setup wizard, your DB2 database product is installed on your system. No response file is saved.
   • Create and save the installation settings in a response file, but not install the product. You can use this response file to install this product later. The DB2 database product is not installed. The DB2 Setup wizard generates the response file that is only based on your selections.
   • Install the product and create and save a response file that you can use as a record of your choices.
   If you choose to create a response file, you can specify the name and location of the response file in the Response file name field. This same response file can be updated to use on another set of hosts as well. Click Next.
9. Select installation directory Panel
   Figure 6. Select installation directory Panel

   
   Specify the directory path where you want to install your DB2 database product. If you are installing the DB2 pureScale Feature, the DB2 installer installs the DB2 copy to the same location on each host and this specified location must be valid on all hosts.

   The DB2 database resides on the shared disk and the DB2 code is installed on all DB2members.

   Click Next.

10. Select the language to install Panel
    Figure 7. Select language to install Panel

    
    Specify the directory path where you want to install your DB2 languages. If you are installing the DB2 pureScale Feature, the DB2 installer installs the DB2 copy to the same location on each host and this specified location must be valid on all hosts.

    Click Next.

11. Specify the location of the DB2 Information Center Panel
    Figure 8. Specify the location of the DB2 Information Center Panel

    
    Specify the directory path of your DB2 Information Center. You can select the IBM website or specify the intranet server with the host name and port number.

    Click Next.

12. Set up a DB2 instance Panel.
    Figure 9. Set up a DB2 instance Panel

    
    Use this panel to create a DB2 pureScale instance. If you would like to add the current host to an existing DB2 pureScale instance, you should start the instance extension (db2isetup or db2iupdt -add) from a host that already belongs to the instance.
    • To create a DB2 instance, select Create a DB2 instance.
    • If you do not want the DB2 Setup wizard to create a DB2 instance, select Do not create a DB2 instance. The DB2 installer still performs the installation, but, you can create an instance at a later point by running the db2icrt or db2isetup command.
    In addition, you would have to manually create the required users in the host for the instance owner, for ssh, and fenced user.

    If you are upgrading from a previous DB2 version, select "Do not create a DB2 instance".

    Click Next.

13. Set user information for the DB2 instance owner Panel
    Figure 10. Set user information for the DB2 instance owner Panel

    
    Specify the user information that the DB2 installer uses to perform instance functions and store instance information in the user's home directory. The new user and group is created on all hosts. The name of the instance is the same as the user name. You can also specify an existing user. If you select "Existing user", the user name must comply with the conditions outlined in the "Required users for a DB2 pureScale Feature installation" topic. The SSH user name is required to use a Secure Shell (SSH) network protocol between hosts. If this name is not specified, the instance owner user ID is used. Click Next.
14. Set user information for the fenced user.
    Figure 11. Set user information for the fenced user Panel

    
    Create a new user or use an existing user:

    • To create a new fenced user, select New user and provide information about the fenced user in the fields. In a DB2 pureScale environment the user account is created on all the hosts.
    • To use an existing fenced user, select Existing user. You can type a valid user name or click [...] to select an existing user name. If you select "Existing user", the user name you enter must exist on all hosts with the same UID and GID.
    Click Next.
15. Setting up a DB2 Cluster File System Panel
    Figure 12. Setting up a DB2 Cluster File System

    
    Use this panel to specify both of the shared disk partitions required for the DB2 pureScale Feature installation:
    • One partition where the database data resides (Shared disk partition device).
    • One partition for cluster recovery purposes (DB2 Cluster Services tiebreaker).

    The partitions specified cannot be the same. They should be raw disks and not be used by anything else.

    Click Next.
16. Host List Panel
    Figure 13. Host List Panel

    
    Add the hosts that are part of the DB2 pureScale environment. Hosts are validated as they are added to the list. The available disk space for the installation files is checked on every host as part of the validation process. The installation-initiating host (IIH) is automatically loaded into the host list.

    To add a remote host, click Add.

    Figure 14. Add Remote Host window

    
    Enter the remote host name and click OK. If you receive an error during host remote validation, you can fix the problem on the Host List panel or return to any of the previous panels of DB2 Setup wizard to make changes to the installation settings. You can also click Advanced on the Host List page to change the DB2 pureScale instance settings. In addition, regardless of the status of the hosts, a Secure Shell check is done at this point to confirm the passwordless SSH availability between the hosts. Ensure that root SSH access is installed, setup, and configured on the host you want to add.

    Error information is available by clicking the button displayed in the "Errors" column. If you cannot resolve a host error, you can remove the host from the list entirely with the Remove button. You can then later fix the issue and add the host to the instance after the initial deployment.

    You can also specify custom settings for the DB2 pureScale instance. See the next step for more details.
17. Advanced Instance Settings dialog. After adding all the hosts you want to participate in the DB2 pureScale environment, you can make changes to the default instance settings by clicking on Advanced. Optionally, you can make changes to the default instance settings using the options in the Instance Setting box.

    The following tabs can be displayed:

    Cluster caching facility

    Figure 15. Advanced Instance Settings - Cluster caching facility tab

    

    You can manually select the hosts to be used as CFs, or allow the installer to automatically assign them. The automatic CF assignment option is selected by default. At least one CF is required to run a DB2 pureScale instance.

    If you choose to manually assign the CF, you must specify which CF acts as the preferred primary CF. You can also optionally designate which CF acts as the preferred secondary CF. These designations indicate which cluster caching facility the cluster manager attempts to start in the primary CF role.

    You can also select the option of specifying that a host can act as both a CF and a member.

    CF Ports

    Figure 16. Advanced Instance Settings - CF Ports tab

    

    The CF requires that you specify service ports. The same ports must be available on all hosts that are running cluster caching facilities. The port numbers can be in the range of 1024 to 65535.

    Instance Communication

    Figure 17. Advanced Instance Settings - Instance Communication tab

    

    The TCP/IP port number is used by a DB2 instance to listen for incoming DB2 connections. The port number value must be in the range 1024 to 65535 and must be available on all hosts.

    Logical Members and FCM Ports

    Figure 18. Advanced Instance Settings - Logical members and FCM Ports tab

    

    You can set the number of logical members to be created on each host. The maximum number of members is 128. The same logical number is applied to all hosts. Ensure that the port numbers used by the DB2 pureScale instances are free on all hosts. The Fast Communications Manager (FCM) requires a port range of the three mandatory ports plus the value provided for the logical members field. This port range can designate up to 130 hosts (128 member + 2 CFs). The default FCM start port is 60000 and must be in the range of 1024 to 65535.

    Click OK to close the Advanced dialog. The DB2 installer revalidates the added hosts if you have updated any of the default instance settings. Click Next on the Host List Panel.
18. DB2 Prerequisite Panel Use this panel to determine if your system satisfies the DB2 pureScale Feature prerequisites (such as operating system level, Linux distribution, AIXTechnology Level, and other DB2 pureScale specific requirements.) The status field indicates whether the prerequisites are met. Click Next.
19. Summary Panel
    Figure 19. Summary Panel

    
    You have made all the choices necessary to complete the DB2 installation or to create a response file. Review all the features listed in this window before clicking Finish. To change any of these settings, click Back to go back to the previous pages in the DB2 Setup wizard and change your choices. Clicking Finish launches the installation process across all specified hosts.
20. Setup Complete
    Figure 20. Setup Complete Panel

    

    To use your DB2 database product, you must have a valid license. For information about obtaining and applying DB2 license files, see DB2 database product licensing and support.

    Once the installation is complete, you can review the post-installation steps, the log file for more details on what was setup, and the status of each remote host. Click Finish to exit.