Defining the base configuration - IBM Websphere

There are two methods to define the base configuration: the manual procedure and the startup command to invoke the DataPower Installation Wizard. Both methods use the command line interface (CLI).

We recommend that you use the startup procedure, because it provides the most user assistance. We describe this approach first. If necessary, the manual procedure is provided in case there is a need to make changes or if you prefer this approach.

To avoid unpredictable behavior and delays:

  1. Make sure that the device has no other activity during this process.
  2. Failing to initialize the file system on the disk,or not waiting until the initialization of the filesystem completes, before enabling the RAID volume can have “unpredictable” results. The system is
    attempting to mount a disk full of random data.
  3. It will take up to an hour for the contents of the primary drive to be copied to the secondary drive (synchronization) after you receive the “Action Completed Successfully” message when initializing or synchronizing the RAID volume. During this time, the performance of the disk array might be slower than normal. Do not touch the device during this process.
  4. The directory name must not be the same as any domain name.Ensure that the name chosen will never be used as a domain name.

Startup method

Configuring the network interface
Prior to beginning the startup procedure, obtain all the necessary network information, including static IPaddresses, subnet masks, default gateway address, and Domain Name System (DNS) address.

In this example, we make the following assumptions:

  • You connected your network to the MGMT Ethernet interface on the Data Power device®.
  • The IP address and subnet mask for the Ethernet interface is 10.10.13.35/24.
  • The IP address of the default gateway for the Ethernet interface is 10.10.13.7.
  • The IP address of the DNS is 10.10.13.2.
  • The specialized HTTP server to support WebGUI access listens on port 9090.
  • The CLI is accessed via Secure Shell (SSH) over port 22.

While using the wizard, the default reply contained in the brackets is indicated by the Enter key. This shows both default responses and keyed-in responses.

Startup steps 1 and 2

Step 1 - Do you want to configure network interfaces? [y]:y
The interfaces that are physically connected
  1. The physical interface mode (Auto, Full-Duplex, and so forth)
  2. Whether to use DHCP or a static IP address and subnet mask
  3. The IP address of the default gateway
Do you have this information? [y]:y
Do you want to configure the mgt0 interface? [y]:y
Do you want to configure the eth0 interface? [y]:n
Interface configuration mode (mgt0 )Choose one of the following interface modes:
  1. Auto
  2. 1000baseTx-FD
  3. 100baseTx-FD
  4. 100baseTx-HD
  5. 10baseT-FD
  6. 10baseT-HD
Enter the number of the interface mode [1]: 1
Interface operational parameters set (Auto) Do you want to enable DHCP? [y]:n
Enter the IP address for the interface: 10.10.13.35
Enter the subnet mask: 255.255.255.0
Operation succeeded
Enter the IP address for the default gateway: 10.10.13.7
Operation succeeded
Do you want to configure the eth1 interface? [y]:n
Do you want to configure the eth2 interface? [y]:n
Step 2 - Do you want to configure network services? [y]:y
Do you want to configure DNS? [y]:y
This configuration requires the IP address of the DNS server.
Do you have this information? [y]:y
Enter the IP address of the DNS server: 10.10.13.2
Modify DNS Settings configuration

Configuring management access
It is crucial to set up access for administering and configuring the DataPower appliance after it is initialized in the network. The CLI operates over SSH on port 22 by default, and the WebGUI operates over HTTPS on port 9090 by default.

Startup step 3

Step 3 - Do you want to configure management access? [y]:y
These configurations require the IP address of local interface that manages the appliance.
Do you have this information? [y]:y
Do you want to enable SSH? [y]:y
Enter the local IP address [0 for all]: 0
Enter the port number [22]: 22
% Pending
SSH service listener enabled
Do you want to enable WebGUI access [y]:y
Enter the local IP address [0 for all]: 0
Enter the port number [9090]: 9090
Modify Web Management Service configuration

Configuring the hard drive
The hard disk array configuration requires patience, because it takes time to build the array and the volume and to synchronize the mirrored hard drive. The synchronization process can take about an hour. Completion of the startup wizard does not depend on the completion of the synchronization of the hard drives.

Example below shows the dialog for configuring the hard drive.

Example Startup step 4

Step 4 - Do you want to configure the hard disk array? [y]:y
This configuration is required for a fully functional B2B appliance.
This configuration requires the name of the file system to mount.
Data in this file system will be available in the local: directory.
Attention: This action destroys all data on array volume.
Do you want to continue? [y]:
Enter name for the file system [ondisk]: ondisk
Modify Hard Disk Array configuration
Array volume successfully initialized.

Reviewing and saving the base configuration
In this final step of the startup wizard, the base configuration is displayed, checked, and saved.Changes to the hard disk in Step 4 are saved immediately, and you do not have an option to back out the changes. If changes need to be made, there is no provision to delete an existing setting. However, there is an option to overwrite an existing setting in a subsequent pass through the startup wizard. We recommend that you make changes to the configuration after this initial pass by using the manual procedure. Example below provides a typical configuration of the IP addresses.

Startup step 5

Step 5 - Do you want to review the current configuration? [y]:y
interface IP Address RX (kb/pkts/errs) TX (kb/pkts/errs)
--------- ------------- ----------------- -----------------
mgt0 10.10.13.35/24 8567/98196/0 132603/110001/0
eth0 0/0/0 0/0/0
eth1 0/0/0 0/0/0
eth2 0/0/0 0/0/0
Do you want to save the current configuration? [y]:
Overwrite previously saved configuration? [y/n]: y
Configuration saved successfully.
You have completed the Installation Wizard.
xb60(config)#

Manual procedure

Prior to beginning the manual procedure, make sure to obtain all the necessary network information,including static IP addresses, subnet masks, the default gateway address, and the DNS address.

Thedefault reply contained in the brackets is indicated by the Enter key.In this example, we make thefollowing assumptions:

  • You connected your network to the MGMT Ethernet interface on the DataPower device.
  • The IP address and subnet mask for the Ethernet interface is 10.10.13.35/24.
  • The IP address of the default gateway for the Ethernet interface is 10.10.13.7.
  • The IP address of the DNS is 10.10.13.2.
  • The specialized HTTP server to support WebGUI access listens on port 9090.
  • The CLI is accessed via SSH over port 22.

Configuring the network interface and management access
To define the base configuration,use the following procedure from a CLI session (which is run over the serial port during this phase of the device initialization):

  1. Access Global configuration mode by entering the following command:
  2. configure terminal
  3. Access the configuration mode for the MGMT Ethernet interface by entering the following
    command:
  4. int mgt0
  5. Configure the IP address and subnet mask for the Ethernet interface by entering the
    following command:
  6. ip address 10.10.13.35/24
  7. Configure the IP address of the default gateway for the Ethernet interface by entering the
    following command:
  8. ip default-gateway 10.10.13.7
  9. Exit the configuration mode for the Ethernet interface by entering the following command:
  10. exit
  11. Define the specialized HTTP server to support WebGUI access by entering the following
    command:
  12. web-mgmt 10.10.13.35 9090
  13. Enable SSH by entering the following command:
  14. ssh 10.10.13.35
  15. Save the changes to the configuration by entering the following command:
  16. write memory
  17. You are prompted to confirm that you want to overwrite the existing configuration. Enter y.

Configuring the hard drive
The hard disk array configuration requires patience, because time is required to build the array and the volume and to synchronize the mirrored hard drive.The synchronization process can take about anhour. Completion of this step continues after you complete and exit the CLI, because synchronization of the hard drives can take about an hour:

xb60# config
xb60(config)#raid-initialize raid0
xb60(config)# raid-volume-initialize-filesystem raid0 (this step will take a
few minutes)
xb60(config)# raid-volume raid0
xb60(config raid-volume raid0)# directory ondisk
(The directory name appears in the file manager. This name must not be the same as any domain name.)
xb60(config raid-volume raid0)# admin-state enabled
xb60(config raid-volume raid0)# exit
xb60(config)# write mem
When prompted about overwrite {y/n,}, y
Exit the command line session by entering the following command: exit.

Verifying the configuration

Continuing the examples one step further, because the IP address for the Ethernet interface is 10.10.13.35 and the specialized HTTP server to support WebGUI access listens on port 9090, we access the WebGUI from any browser, using the following procedure:

  1. Open the Web browser.
  2. Type the following value in the Address field:https://10.10.13.35:9090. If the Web page displays successfully, the base firmware configuration is successful.
  3. Log in to the device with the local admin account and password.If the DataPower Control Panel displays,authentication of the local admin account is successful.

You can use the WebGUI or the CLI to verify the successful configuration of persistent storage (the harddrives) and to perform additional interface, network, and service configurations.

Checking and managing storage

The appliance uses persistent storage to store metadata about transactions.Access to the configuration of the B2B persistence object is limited to administrators in the default domain. To properly plan for archiving and the persistence store size, you need to estimate the traffic characteristics for your appliance.

By default, electronic data interchange (EDI) documents transferred through B2B Gateway objects are stored on the appliance hard disk and can eventually be transferred to a permanent archive.Each B2B Gateway object shares document store space. Additionally, metadata that is extracted from each transaction isretained in a separate B2B persistence store on the “onboard” hard disk.

Specifying document storage

Specifying document storage

Checking synchronization progress
Time is required to synchronize the mirrored hard drives.It is important to wait on further configuration andtesting until after the synchronization process completes.

The synchronization progress.From the left navigation menu, select Status RAID

Resync in progress

Resync in progress

Managing store size
To check and optionally change persistent storage on the appliance, use the following procedure:

  1. Select Objects System Settings B2B Persistence.
  2. Place the object in an inactive administrative state by clicking disabled.
  3. Select raid0 from the RAID Volume drop-down list box.
  4. Specify the maximum size for the store in megabytes in the Storage Size field. Use an integer in the range of 1024 up to 65536 megabytes.The default is 1024 megabytes.A good starting value in a
    development environment is 4096 megabytes.
  5. Checking B2B Persistence Storage Size

    Checking B2B Persistence Storage Size

  6. Click Apply to save the object to the running configuration.
  7. Optionally, click Save Config to save the object to the startup configuration.

You can use the CLI to check the document store size by using the show b2bp encrypted-space command.You can also use the CLI to check the persistent store size by using the service show b2bp size command.

The service show b2bp size command

xb60# service show b2bp encrypted-space
B2B encrypted space: 28037 MB free of 28166 MB total
xb60# service show b2bp size
B2B persistence storage size used:4032 KB

Important: When you change the B2B Persistence Store value, you are allocating the maximum size that the embedded database can grow on the hard drive. After you change the value of the B2B Persistence Store to a higher number, it cannot be changed to a lower number.

Managing encryption settings
During the installation of a B2B XB60 appliance, the document storage partition on the hard disk drive is encrypted with the internal system key.After installation,an administrator in the default domain can change the encryption settings either to be encrypted with a passphrase or to be unencrypted.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM Websphere Topics