Troubleshooting
Problem
Resolving The Problem
BRMS can be set up to use an TCP/IP interface during backups that are done in restricted state so the system can take ownership of volumes from other systems in the BRMS network that are not in restricted state. This will allow backups that are run in restricted state to continue even if no volumes are available on the system at the start of the backup.
It is worth noting, when a system is in restricted state, other systems in the BRMS network will not be able to send updates to it or request media from it. If multiple systems in the BRMS network will be restricted state at the same time, it may be useful to run the Start Media Balancing for BRM (STRBALBRM) command before the systems are put into restricted state. STRBALBRM will attempt to equally distribute scratch media between systems in the BRMS network, which may prevent backups from being run without available media on systems that are in restricted state.
In releases IBM i 6.1 and later, the BRMS GUI interface can be used to enable BRMS restricted state communication.
Notes:
- The restricted state interface must use a line type *ELAN, *TRLAN or *DDI, or a line description of *VIRTUALIP and line type *NONE. To view the line type for your interface, at a command line interface enter CFGTCP and select option 1 - Work with TCP/IP interfaces. The *VIRTUALIP interface, by itself, cannot communicate externally with other hosts. To communicate externally with other hosts. a *VIRTUALIP interface must be bound to a physical interface. Therefore, when using a *VIRTUALIP interface in BRMS, there must also be a corresponding physical interface defined.
- The line description may not be attached to an NWID or NWSD. To verify the interface is not attached to a NWID or NWSD, from a command line interface enter DSPLIND lindesc (where lindesc is the name of your line description) and verify that the Resource name is not *NWID or *NWSD.
- BRMS can only start one interface per line description type.
- Restricted state TCP will only be used to communicate out with other systems in the BRMS network that are not in restricted state. Other systems in the network will not be able to send updates to this system or request media from the system when in restricted state.
- Systems that own media need to have TCP/IP up in order for other systems to take ownership of it's media. If a system is in a restricted state, or TCP/IP is ended, it's media cannot be shared with other systems in a BRMS network
- The system has to be in restricted state for this to work. If any subsystems are started after going into a restricted state, this will function will not work.
- To verify the IP address entered you may use the BRMS GUI plugin, or from a command line interface run this command:
In release IBM i V5R4M0, the following commands can be used to add, remove or display the TCP/IP or VIPA interfaces that BRMS will used during restricted state backups:
QSYS/CALL QBRM/Q1AOLD PARM('TCPIPIFC' '*ADD' 'interface')
QSYS/CALL QBRM/Q1AOLD PARM('TCPIPIFC' '*REMOVE' 'interface')
QSYS/CALL QBRM/Q1AOLD PARM('TCPIPIFC' '*REMOVE' '*ALL')
QSYS/CALL QBRM/Q1AOLD PARM('TCPIPIFC' '*DISPLAY' '*ALL')
Where: 'interface' is the internet address of the system from which you issued this command and which you are using to communicate with the remote systems. Specify the interface in the form of nnn.nnn.nnn.nnn. Note: This is not the IP address of other systems.
Example:
QSYS/CALL QBRM/Q1AOLD PARM('TCPIPIFC' '*ADD' '19.71.1.28')
Notes:
- All parameters for this command must be entered in upper-case.
- BRMS will not start any TCP/IP interfaces if the system is not completely in restricted state. Therefore any user-defined exit that is used to bring system to restricted state must make sure that system is completely in restricted state before starting the backup process.
- Multiple interfaces can be specified by using the *ADD function for each interface. If the first interface listed is not started, BRMS will attempt to start the next one listed.
- Once this command is run, it need not be run again unless you want to disable or re-enable restricted state TCP/IP.
- If multiple systems in the BRMS network will be in a restricted state at the same, using STRBALBRM can be used to assign media before systems go into a restricted state
- In releases IBM 6.1 and V5R4M0, to *REMOVE or *DISPLAY all interfaces by specifying *ALL for the interface parameter, the following PTFs or superseding PTFs are required:
- V6R1 - SI37276
- V5R4 - SI37269
More can be found here:
https://helpsystemswiki.atlassian.net/wiki/spaces/IWT/pages/165642515/Using+TCP+IP+in+Restricted+State
Was this topic helpful?
Document Information
More support for:
IBM i
Component:
Save Restore->BRMS
Software version:
All Versions
Operating system(s):
IBM i
Document number:
666281
Modified date:
12 November 2024
UID
nas8N1020784