Configuring memory settings for Yang model-based drivers

UOWs can fail due to out of memory errors on device drivers based on vendor-supplied Yang models. Configure the memory settings to prevent these errors.

About this task

Due to the large size of some Yang model-based drivers, device imports and other UOWs might fail due to out of memory errors, which can be seen in the UOW logs. These drivers are supported only on client and server 64-bit architectures. Increase the client and server memory settings to avoid these errors.

Note: Drivers 24 contains some drivers that are based on Yang models. These drivers cannot be installed with their non-Yang counterparts because the model and OS supported lists overlap. These drivers include the Juniper SRX v18.0, Juniper MX v17.0, and Juniper MX v18.0. Cisco VG* models are added in Driver CiscoRouterISRG215xSmartModel and removed from Driver CiscoRouter26xxADVIPSERVICESK9MZ124SmartModel.

To configure the memory settings, complete the following steps:

Procedure

  1. Ensure that your user is in a group with the Manage System activity.
  2. Access System Properties from the Systems Manager. Select Tools > System Properties.
    The System Properties screen is displayed and shows the following information for each property:
    • Property name
    • Short description of the property
    • Field type
    • Current value associated with the property
  3. Select the system property to be modified from the upper pane of the System Properties screen.
    The current value held in the particular property chosen populates into the Property Edit pane in the bottom half of the screen.
  4. Modify the following property values and then click Update to apply the changes. All values are in MB.
    Minimum Client Memory
    Set this system property to the value 512m
    Maximum Client Memory
    Set this system property to the value 4096m
    Memory Manager - Memory Reserved For Drivers
    Set this system property to 1024m
    Memory Manager - Schema Scale Factor (64-bit)
    Set this system property to the value 3.5
    Important: The Memory Manager - Memory Reserved For Drivers and Memory Manager - Schema Scale Factor system properties are not normally to be modified except under the direction of IBM Support. However, in order to avoid the out of memory errors on Juniper devices it is necessary to configure these properties as described here.
  5. Set the heap space for any presentation servers:
    1. Open
      /<ncm install path>/bin/utils/support/setEnv.sh
    2. Edit the following WebSphere parameters: 
      WEBSPHERE_MAXIMUMHEAP_SIZE=4096
WORKER_MEM_ARGS="-Xms512m -Xmx8192m -XX:MaxPermSize=128m"
COMPSERV_MEM_ARGS="-Xms512m -Xmx2048 -XX:MaxPermSize=128m"
    3. Execute /<ncm install path>/bin/utils/support/setWSMem.sh to set the memory variables updated within 'setEnv.sh'.
  6. Configure memory settings for worker servers (including linked and standalone), and on the presentation server:
    1. Open /<ncm install path>/bin/utils/support/setEnv.sh
    2. Edit WORKER_MEM_ARGS as required.
      Note: Do not run setWSMem.sh.
  7. Configure memory settings for IDT servers:
    1. Open
      /<ncm install path>/bin/utils/support/setEnv.sh
    2. Edit IDT_MEM_ARGS as required.
      Important: Do not run setWSMem.sh.
  8. Restart Netcool Configuration Manager.