Periodically Spectrum Network Configuration Manager captures or uploads fail for SSH/SCP communication mode and $SPECROOT/NCM/NCMSERV.OUT file contains EOF exceptions

Document ID : KB000020728
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

Periodically Spectrum Network Configuration Manager (NCM) captures or uploads fail for SSH/SCP communication mode and $SPECROOT/NCM/NCMSERV.OUT file contains similar errors

java.io.EOFException: SSHSCP1: premature EOF
      at com.mindbright.sshcommon.SSHSCP1.readFully(SSHSCP1.java:444)
      at com.mindbright.sshcommon.SSHSCP1.readFromRemote(SSHSCP1.java:285)
      at com.mindbright.sshcommon.SSHSCP1.copyToLocal(SSHSCP1.java:179)
      at com.mindbright.util.SshSCPConnection.copyFromRemote(SshSCPConnection.java:192)
      at com.aprisma.spectrum.scmd.CiscoSCP.captureConfig(CiscoSCP.java:143)
      at com.aprisma.spectrum.scmd.CiscoSCP.captureRunningConfig(CiscoSCP.java:98)
      at com.aprisma.spectrum.scmd.ScmServiceImpl.captureRunningConfigImpl(ScmServiceImpl.java:278)
      at com.aprisma.spectrum.scmd.ScmServiceImpl.captureRunningConfigRun(ScmServiceImpl.java:194)
      at com.aprisma.spectrum.scmd.ScmServiceImpl.access$000(ScmServiceImpl.java:30)
      at com.aprisma.spectrum.scmd.ScmServiceImpl$1.run(ScmServiceImpl.java:1861)
      at java.lang.Thread.run(Thread.java:662)

Solution:

Depending on the release of Spectrum installed there are a two solutions available through debug patches;

For Spectrum 9.2.H09 apply debug patch D456 .
For Spectrum 9.2.3 (aka H10) apply debug patch D459.

Both debug patches have the same solution and the same possible post install instructions should the problem continue post install;

Symptom: Global Sync Task has the potential to hang if SSH/SCP capable devices fail to respond.
Resolution: ncmservice requests to devices will now timeout.
(154957, 20694488-2)

POST INSTALLATION INSTRUCTIONS

  1. Start processd and the SpectroSERVER.
  2. This patch ships two new library files (libs). Once ncmservice has been started NCMSERV.OUT will contain two messages indicating both libs have been installed. Should any additional issues occur please collect a thread stack and provide NCMSERV.OUT to support.

    1. Create new file in $SPECROOT/NCM/ncmprop
    2. Add single entry
      com.mindbright.ssh2.SSH2StreamChannel.checkRxWindowSize.enabled=tru
    3. Setting will automatically be picked up in about 5 seconds of ncmprops file being saved
    4. The ncmprops will not be overwritten on upgrade, but will need to be added to any SpectroSERVER that has devices which will use the SSH/SCP communication mode for NCM.

For any of the above mentioned debug patches, please contact CA Support. This same solution will be included in the next hotfix patch H11.