Release Note OmniPCX Enterprise

TC2823 ed.04 All OXE releases

infocollect: usage, features, bug fixes & debug

methods

This document provides information about usage, fixes, new features & debug methods for the infocollect tool in the
context of the OmniPCX® Enterprise.

Revision History
Edition 1: October 22, 2020 creation of the document. Correspond to infocollect version: 6.2
Edition 2: January 13, 2021 creation of the document. Correspond to infocollect version: 6.3
Edition 3: February 8, 2021 creation of the document. Correspond to infocollect version: 6.4
Edition 3: March 8, 2021 creation of the document. Correspond to infocollect version: 6.5
Edition 4: January 25, 2022 creation of the document. Correspond to infocollect version: 6.6 & 6.7

Legal notice:
www.al-enterprise.com The Alcatel-Lucent name and logo are trademarks of Nokia used under license by ALE. To view other
trademarks used by affiliated companies of ALE Holding, visit: www.al-enterprise.com/en/legal/trademarks-copyright. All other
trademarks are the property of their respective owners. The information presented is subject to change without notice. Neither
ALE Holding nor any of its affiliates assumes any responsibility for inaccuracies contained herein.
© Copyright 2022 ALE International, ALE USA Inc. All rights reserved in all countries.
Table of contents
1 Goal ....................................................................................................................................................... 4
2 Result file ............................................................................................................................................... 4
3 Usage ..................................................................................................................................................... 4
3.1 Syntax .............................................................................................................................................. 5
3.2 Auto-installable program .................................................................................................................. 5
3.3 Short description of modules ............................................................................................................. 6
3.4 GAS module ...................................................................................................................................... 7
3.5 “search.vbs” .................................................................................................................................... 7

4 Debug .................................................................................................................................................... 7
5 Availability .............................................................................................................................................. 8
6 Reporting an issue, suggestions ............................................................................................................... 8

7 History of versions (new features, bug fixes) ............................................................................................ 8

7.1 Version 0 No version number (first delivery) ...................................................................................... 8
7.2 Version 1.1 ....................................................................................................................................... 8
7.3 Versions 2.0 / 2.1 ............................................................................................................................. 9
7.4 Version 2.2 ....................................................................................................................................... 9
7.5 Version 3.0 ....................................................................................................................................... 9
7.6 Version 3.1 ..................................................................................................................................... 10
7.7 Version 3.2 ..................................................................................................................................... 10
7.8 Version 3.3 ..................................................................................................................................... 10
7.9 Version 3.4 ..................................................................................................................................... 10
7.10 Version 3.5 ................................................................................................................................... 11
7.11 Version 3.6 ................................................................................................................................... 11
7.12 Version 3.7 ................................................................................................................................... 11
7.13 Version 3.8 ................................................................................................................................... 12
7.14 Version 3.9 ................................................................................................................................... 12
7.15 Version 3.10 ................................................................................................................................. 12
7.16 Version 4.0 ................................................................................................................................... 12
7.17 Version 4.1 ................................................................................................................................... 14
7.18 Version 4.2 ................................................................................................................................... 14
7.19 Version 4.3 ................................................................................................................................... 14
7.20 Version 4.4 ................................................................................................................................... 14
7.21 Version 4.5 ................................................................................................................................... 15
7.22 Version 4.6 ................................................................................................................................... 15
7.23 Version 4.7 ................................................................................................................................... 16
7.24 Version 4.8 ................................................................................................................................... 16
7.25 Version 4.9 ................................................................................................................................... 16

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 2/25
 7.26 Version 5.0 ................................................................................................................................... 16
7.27 Version 5.1 ................................................................................................................................... 17
7.28 Version 5.2 ................................................................................................................................... 17
7.29 Version 5.3 ................................................................................................................................... 18
7.30 Version 5.4 ................................................................................................................................... 18
7.31 Version 5.5 ................................................................................................................................... 19
7.32 Version 5.6 ................................................................................................................................... 19
7.33 Version 5.7 ................................................................................................................................... 19
7.34 Version 5.8 ................................................................................................................................... 20
7.35 Version 5.9 ................................................................................................................................... 20
7.36 Version 6.0 ................................................................................................................................... 21
7.37 Version 6.1 ................................................................................................................................... 21
7.38 Version 6.2 ................................................................................................................................... 22
7.39 Version 6.3 ................................................................................................................................... 22
7.40 Version 6.4 ................................................................................................................................... 23
7.41 Version 6.5 ................................................................................................................................... 23
7.42 Version 6.6 ................................................................................................................................... 24
7.43 Version 6.7 ................................................................................................................................... 24

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 3/25
1 Goal
Infocollect is a tool that collects a huge variety of logs & information on the OmniPcx Enterprise & GAS
system. This information is gathered into a compressed tar file that can be consulted later under any
computer. Once decompressed the result is organized into directories & sub-directories. All information
consists in text files.

It is not OXE version dependent: infocollect is also delivered on the Business Portal as an auto-installable
file that can be installed in versions as far as R5.0 Lx (bugs may happen, no impact on OXE functioning)

The goal is to help either our Business Partners, the ALE Tech support & RnD

In this document, it is possible that some functions or files that are described are not available for older oxe
versions due to constant evolutions of the tool.

2 Result file
Result file is named “infocollect_<cpu name>_<yyy-mm-dd>_<hhmm>.tbz” & placed under “/tmpd”
It is a tar zipped file that can be decompressed easily on any computer.

Structure at root directory:

- A cpu state where infocollect was launched (empty text file “MAIN”)
- Infocollect version: an empty file named “_infocollect_version_<version>”
- A file named “LIST_OF_ALL_FILES_4_SEARCH.txt”: see chap. 3.4 “search.vbs” (from v6.1)
- A file named “search.vbs” to be used as help: see chap. 3.4 “search.vbs” (from 6.1)
- Directories that contain result text files. Most of those files are either a copy of existing oxe files or
the result of commands: in that case their name tries to correspond to the oxe command.
o Eg: “remotesets” file correspond to the oxe command “remotesets”
o Eg: “remoteinfo-0” file correspond to the oxe command “remoteinfo 0”
o Etc.

3 Usage
Infocollect is organized in a set of independent modules that are launched by a master program.
Those modules can be launched separately & it is possible to skip some of them.

Most of the modules will not require any interaction with the admin; modules concerning GD, OMS, GAS …
may have to ask the account/password to be able to retrieve the relevant information.

Infocollect can be launched with arguments depending on what the admin wants to do.
Infocollect must be launched as root user, CPU can be in main or stdb or even telephone not started. Lots of
tools launched in stand-by or telephone not running will print warnings, but it is harmless for the CPU.
In main cpu state some logs are retrieved from twin cpu (modules “twin” or “twin_extra”). So, there is no
need to launch infocollect in stand-by mode.

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 4/25
Even if infocollect is not linked to any OXE versions it is only tested on latest releases so bugs may happen if
latest infocollect is launched on a much older OXE release (see chap.5). In this case OXE behavior is not
impacted, only result files can be wrong or not present or error messages like “file not found” will be
shown.

3.1 Syntax
List of arguments & explanations:
- “infocollect -v” (or --version) shows infocollect current version
- “infocollect -h” help on syntax
- “infocollect -list” prints the list of all modules
- “infocollect” with no argument launches the tool without some modules
(gas/gd/netw_incid/pcs_logs)
- “infocollect -db”: to force to show the mao backup menu for an immediate backup action. “mao” +
“cho-dat” are retrieved. If this option is missing only “DAY” backup is taken.
- “infocollect -remote”: most modules are not executed. Incidents from local & remote nodes are
retrieved: only netw_incid.mtcl, CCR, chlog modules. Option not recommended: use option “-a”
instead if incidents from distant nodes are needed
- “infocollect -lite”: option not recommended & will be removed soon. Only some modules are
executed in order to decrease the size of result file
- “infocollect -a” launches the tool with ALL modules. Some of them will ask for admin password
towards remote equipment (like GDs, GAS …)
- “infocollect -i” launches the tool in interactive mode. All modules will ask to be executed or not
(y/n/q) or even a possibility to quit the tool (q: next modules will be skipped and archive will be
created with previous modules that were executed – option from version 5.7)
- “infocollect -gas” ONLY launches the module dedicated to GAS & FLEX server (admin password
requested). See chap. 3.4 “GAS module”
- Other arguments: see chap. 4 “Debug”

Notes:
- Case of mao database: done in module “mao”. Infocollect with no option provided: will do a copy of
DAY database. The options “-db” or “-a” will ask for an immediate backup with copy in result file.
- In case of native encryption with external gateway configured it will be asked to give the root
password of the EEGW & to perform the “ostimport” manually operation on twincpu.
- The new option “-nc” does not compress the result file & gives much faster operation. Size of the
tar file gets a lot bigger. The “anti_loop” module is watching for sufficient free space under “/usr4”
and stops operation eventually.

3.2 Auto-installable program

The file “sfx-infocollect_<version>.sh” is delivered in the Business Portal.
That script contains an auto-installable version of infocollect.
Usage:
- Login as root
- Copy the file under “/tmpd”

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 5/25
 - Give it the execution rights with “chmod + x”
- Execute the installation: “./sfx-infocollect_<version>.sh”
- Installation will erase the previous version without warning or confirmation
- Twin cpu is also automatically installed the same way if present & accessible
- There is no check of oxe version
- A newer OXE patch may erase the actual infocollect version & replace it by an older one.
- Installation can be done as many times as needed, telephone running or not

3.3 Short description of modules

If (*) is mentioned after the module name that means that the info is also retrieved from twincpu if present &
reachable

• account all accounting info

• applications (* only .pem check on twincpu) misc result of tools related to encryption,
ldap, vmail … including also security checking tool
• boards relative to hardware architecture (boards, “config” tool)
• ccd ccd, csta tools, logs related …
• CCR (*) Cloud Connect & Rainbow. Info & logs
• chlog Call Handling logs (like incidents, exceptions) on local cpu. Flex logs, some
tools.
• dect dect tools
• etc /etc Linux system config files
• gas a launcher for a script to be injected in a gas or flex server. Can be
executed separately. See chap. 3.4
• gd to get gd logs
• gdump some data read from memory
• ipdomains get ipdomains info with sets & eqts
• ipterms mainly ippstat tool with options & tftp_check (set counted by their type …)
• mao (2 modules)
o “mao.mtcl” retrieves info from database, management history, db translations
o “mao” will ask or not the database immediate backup depending on infocollect argument “-
db”. Gets database + Linux data backup
• netw_incid (* for remote nodes only) retrieves incidents & trunks info from remote nodes.
Can take some time depending on the ip network & number of nodes in the network.
• oms to get oms logs (admin login: pass requested). Option “-a” needed
• ops to get ops files + flex info + soft locks
• pcs_logs get incidents, excvisu, RUNTEL from all pcs + log.pcs file from main cpu
• remotesets remote sets tools
• ressources cnx tool results, voice guides tools and misc tools
• sip sip tools, sip logs
• sysinfo some linux info, ip network, netdata, oxe patches info
• term OXE tools concerning sets, users (fw, getnoeversion, abr. numbers, edsbr,
entitystat …)
• trunks tools related to trunks & abc links

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 6/25
 • twin (*) incvisu, excvisu, iplink debug + other system info from twincpu
• twin_extra (*) more important system info from varlog, mao history, flex, csta … etc all
from twincpu
• varlog copy of various logs from varlog
• version get versions from delivery firmware files, downstat command
• voip compvisu with options + cnx dom
• X25 about ABC networking: x25 related tools
• _anti_loop always launched by the main program. A watchdog process to avoid that an
infocollect module fills a partition specially in case that module is looping. “_anti_loop” kills
infocollect & all the associated running modules. Result file is removed. See options for further info.

3.4 GAS module

This module is intended to be remotely installed on a flex or GAS server to retrieve information & logs on
that server as well as infocollect does.
root password of the GAS or flex server is needed & will be asked several times for file injection, exec &
retrieving.
Result file is always “/tmp/infocollect_gas” & transformed into “GAS_<yyyy>-<mm>->dd>-<hhmn>.tbz”
under /tmpd. On the GAS server infocollect_gas is removed everytime the infocollect gas is done.

3.5 “search.vbs”
This tool is copied into the result file at the root of directory. It is a standalone tool intended to be
launched on Windows.
From version 6.1 a text file named “LIST_OF_ALL_FILES_4_SEARCH.txt” contains the name and location of
all files created by infocollect.
“search.vbs” opens an input box. Then the string entered will be searched & result will be printed in a
message box. This can help localizing a file into the infocollect structure.
Note: due to vbs limitations (no scrollbar in the “messagebox”) the result can be truncated if it contains too
many lines.

4 Debug
In case of issue/bug found in infocollect, to help finding & fixing the issue follow the guidelines below:

Capture the output during execution.

Try to isolate the faulty module by looking which one is blocking the tool or printing errors
If the module is always the same relaunch infocollect with the debug option & capture the result
- infocollect -i DEBUG
Get the result file

Add the “TRAP” argument: it will print the result of commands “ps, df, ls of infocollect current directory if
a ctrl+c is performed.

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 7/25
If the following message is printed: “WARNING: loop detected. Exiting module!” that means that the
_anti_loop watchdog was triggered.
Redo an infocollect:
- infocollect DEBUGANTILOOP
Capture the printing.

During infocollect execution a “ctrl + c” will stop the tool & remove result file being constructed

Option “time” or “TIME” will time each module

5 Availability
Infocollect is installed in all current oxe patches & releases but versions are not the same.
Auto-installable program (sfx) is available as well as this documentation in the Business Portal at the OXE
version page.
This program can be used safely for all Linux OXE versions (see chap. 3.2).

6 Reporting an issue, suggestions

An issue with the tool? Report it through a ticket with the information requested in chapter 3
Any improvement can also be raised through a ticket but depending on interest & feasibility there is no
obligation of realization.
In both cases mention in the ticket to transmit it to Xavier Simonet: [email protected]

7 History of versions (new features, bug fixes)

7.1 Version 0 No version number (first delivery)

First delivery of the tool. Released (BPWS) in 2007

7.2 Version 1.1

Released (BPWS): 21 Feb. 2008

New features:
- Interactive mode (option "-i") gives access to new modules. File will get bigger! Not accessible in auto
mode in order to keep a reasonable file size
* New module “netw_incid.mtcl” -> get all incidents + all excvisu from all accessible nodes (ip
hybrid links only)
Information is sorted by machine (main & stdb)
* New module “pcs_logs” -> get all incidents + all excvisu from all accessible PCS machines

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 8/25
 * New module “twin_extra” -> get more logs from twin cpu (“messages”, “user.log” & “shell.log”
files)
- module “boards.mtcl”": add board type information (to be displayed by OLCA tool)
- added option “-v” to display “infocollect” version number
- added “sip” tools results
- added mao software license values (from tool “gdump”). See file “SP_admin_GDUMP” under “mao.mtcl”

Compatibility assured with current “OLCA” program.

Fixed:
- blocking at “boards.mtcl” due to modifications done in “compvisu” tool.

7.3 Versions 2.0 / 2.1

Not delivered on BPWS (March 2009)
Compatibility still assured related to « OLCA ».
Misc. fixes like: tool gets stuck due to a string modification in OXE tool “config”.

New:
- Sip module: added quarantines addresses
- Installation tool “sfx-infocollect.sh”: option “-v” to know the installer version & “infocollect” version to
be installed.

7.4 Version 2.2

Delivered (BPWS): 15 Mai 2009
Compatibility still assured related to “OLCA”.
Fix in command “traceroute”.

7.5 Version 3.0

Not delivered
Compatibility still assured for « OLCA ».
New arguments added:
- “–lite”
• Lite mode: only incidents & exceptions.
- “–remote”
• Only logs from remote nodes & pcs.
- “–a”
• All modules are executed.
- “–nk”
• Do not ask for a “Kermit” transfer at the end.
- Arguments “-a », “-lite”, “-remote” can all be followed by “-nk”.
Fixes:

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 9/25
- files “excvisu” + “DHS3log” were empty for the twin cpu

New functionalities:
- “ipdomains”: added QOS information
- “ops.mtcl”: added FLEX information (memory + database)
- “mao.mtcl”: added file “Config_BT.cfg”
- “applications.mtcl”: added command “cryptview”
- “sysinfo”: added command « top –b –n 1 » (request from R&D India)

7.6 Version 3.1

Not delivered
Modifications:
- modification in file name result
• machine name is included
• date modification: YY-MM-dd_hhmn_CEST
New functionalities:
- 2 modules added (in preparation for a future development):
• GD3/INTIP3 logs collection
• “bics” logs collection from the host server

7.7 Version 3.2

Not delivered
New functionalities:
- new module “anti-loop” (“_anti_loop”)
• This module runs in background during “infocollect” execution. Its role is to prevent from a
command to loop & fill the disk (conditions are: above 1 GB logs from each module AND 80% of
the disk used).

7.8 Version 3.3

Not delivered -(BPWS) - October 2009
Fixes:
- “twincompat” & “syscompat” commands: if some OXE versions are different the output goes on screen
instead of being written on file.

7.9 Version 3.4

Not Delivered (BPWS): November 2009
Fixes:
- “_anti_loop” module: inserted /dev/null to avoid warning messages during file result compression.

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 10/25
7.10 Version 3.5
Not Delivered (BPWS) - February 2010
New functionalities:
- sysinfo: added crontab -u (root + mtcl). Removed "crontab-l" file (_root-l & _mtcl-l files)
- feml: modified: all dir/files are moved to a specific directory before tar/compr.: easier when
decompressing

Fixes:
- added flex info in ccd module + fix in « ls » commands

7.11 Version 3.6

Not Delivered (BPWS) - January 2010:
New functionalities:
- added version of the infocollect in final log
- added sip logs for twin cpu
- added command "miptsets" under "dect.mtcl"
- recovery of some logs and info from bics server:
o message files
o flexlm.log (first 200 & 200 last lines)
o anaconda.syslog
o dmesg
o ps-edf
o lmstat –a
o service flexd status
- added "zip" file (supply Actis) under "ops.mtcl"
- added logs broadcast: / usr4/mao / * log / usr3/mao/broadcast_hist.dat (mao.mtcl)
- added dump NETNODE.dat + BROADCAST.dat
- added option "[2]: cluster + point" in x25visu
- added in "ops" data Actis (read by mgr)

Fixes:
- module « account »: command »account –v » did not work (do not use « tool »)
- date error in the name of the generated file(detected by Mani Azhaguvel – internal crms)
- do not use anymore the command cmdcpl (module « boards.mtcl »: errors on console port)

7.12 Version 3.7

Delivered - May 2010:
New functionalities:
- Module « gd.mtcl » allows to retreive logs from NGP boards (ga3/gd3/intip3). One compressed log file
per coupler. Module accessible only in interactive mode: possible to choose between getting logs from
every board or selection by rack/position.

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 11/25
Fixes:
- « applications.mtcl »: some files were stored under /usr3/mao instead of infocollect directory.
- Module « twin »: errors redirected in files
- « outfall » incvisu files: wrong way to retrieve them.

7.13 Version 3.8

Delivered (some TS) - September 2010:
Added:
- module « trunks.mtcl »: command « trkvisu comp »
- module « trunks.mtcl »: command « trkvisu ip »
- module « trunks.mtcl »: command « trkvisu <trk> »
- module « sip.mtcl »: command « csipsets »
- module « sip.mtcl »: command « csipview com »

Fixes:
« chlog.mtcl »: files « excvisu » empty on main cpu.

7.14 Version 3.9

Delivered - October 2010:
Added:
- Module « netw_incid.mtcl »: command « trkvisu » for all nodes/ all trunks.
- Module « pcs_logs »: added « /usr4/mao/log.pcs »
- Module « bics »: added misc logs from host
o /root/*log*
o /opt/Alcatel/k2/*log*
o /tmp/vmware-root/*log*
o /var/log/* + sub-directories
o /var/lib/vmware/VirtualMachines/vms/*/*log*

Fixes:
- Module « _anti_loop »: improvement in the loop detection process (module > 1gb + partition > 20%)

7.15 Version 3.10

Delivered - November 2010:
Fixes:
- Module « bics »: wrong file name when trying to get (scp) the bics logs. Copy not done.

7.16 Version 4.0

Delivered - April 2011:
Version present in the first R10 Tech.Rel.

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 12/25
Compatibility with R7, R8 & R9.

Added:
- Module « mao »:
o it is possible to copy mao + linux backup at the following conditions:
o The most recent backup is taken between DAY & IMMED
o No copy if option « -remote » ou « -lite » is given
o Option « -i » (interactive) will give the possibility to choose:
▪ No copy at all or
▪ Copy of the most recent backup between DAY & IMMED or
▪ Perform an immediate backup & copy in the archive
- Module « mao »:
o Adding database content of tables « flshvglng » & « smloc »
o Added result of « cfgUpdate »
o Copy of files « inimao.log » & iniflex.log » from « /tmpd »
o Added spadmin counters from file + memory
▪ Result is: « SP_admin_COUNTERS » & « SP_admin_FILE »
- Module « terms.mtcl »:
o added « opstat »
- Module « ressources.mtcl »:
o added voice guides commands like:
o vgclass, vgemis, vgmespos, vgmultilang, vgdigit, vgfile, vgmulti, vgstart ,vgton & vgstat for GD,
GA &GPA boards. Put under a new directory « vg »
o added « ls -lR /DHS3ext/vg* »
- Module « trunks.mtcl »:
o added « visu_catjr »
- Module « sysinfo »:
o added result of « cat /proc/sys/fs/file-nr » (number of opened files in the system)
- Module « chlog »:
o renaming incvisu files in 2 digits (like incvisu-0.txt to incvisu-00.txt)
o copy of /tmpd/ipl_ipc.log & /tmpd/package.log
- Module « twin »:
o Added iplink duplication data from ilpdebug tool (like keep alive, udp lost tempo, udp port …)
Generated file: « Display_Dupli_Dl ».
- Module « term.mtcl »:
o added « nsipsets » command (noe in sip)

Other:
- Module « chlog »:
o command « siteid » removed (already present in « version.mtcl »)
- auto-installer « sfx » file:
o copy of that file + infocollect installation on twin cpu if exist & reachable. No more needed to
install manually infocollect on twincpu.

Fixes:
- crms00303072: issue with option « I » from the « tar » tool (version 1.2x that came in j1.410.26). Option
replaced by “j”. Compatibility with old version supporting « I » option. Warning: version 3.x cannot
create the archive on OXE versions containing the 1.25 tar version (like j1.410.26).

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 13/25
7.17 Version 4.1
Delivered - Avril 2010:
Fixed:
- Module « mao.mtcl » will be erased at the first use of infocollect in order to avoid the duplicated
function with « mao ».

7.18 Version 4.2

Delivered - July 2011:
Added:
- Module « ipdomains.mtcl »: added informations from the new tool « cacsyndbg »
- Module « ipdomains.mtcl »: added command « cnx domcpl »
- Module « ipdomains.mtcl »: added an info message just before tracerouting of each pcs.
- Module « mao.mtcl »: add of a dot notifying the progression of the module.

Fixes:
- Module « mao » & « mao.mtcl »: the 2 tools « checkdb » & « checkinitrem » are back to the module
« mao.mtcl » due to a bug that modify the crontab of root (insertion of pcscopy + delete of 2 commands
+ modification of the PATH).
- Modules « twin » & « varlog »: get only the last 10000 lines of iplink stat files
- Modules « twin » & « varlog »: all files iplink.log are added
- Module « trunks.mtcl »: added « abcfip.log » log files

Other:
- Module « mao »: does only database copy now
- Module « mao.mtcl »: identical to 3.9

7.19 Version 4.3

Not Delivered - October 2011:
Added:
- nothing

Fixes:
- Module « twin_extra »: the tools “checkdb” & “checkinitrem” are modifying the twincpu crontab for the
root user… (Delete of “adjtime”, modification of the path, adding “pcscopy” ). This version does NOT
correct the crontab (this needs to be done manually (“crontab –e”). A future version will fix that
automatically.

7.20 Version 4.4

Delivered - November 2011:
Added:
- Main file « feml »: adding a triple beep after the archive is built

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 14/25
- Main file « feml »: adding an option to “infocollect”: “-kauto”. This will launch automatically gkermit
when the archive is built.

Fixes:
- Nothing

7.21 Version 4.5

Delivered - November 2011:
Added:
- nothing.

Fixes:
- module « gd.mtcl »: wait timer modified to 20sec (corrupted archive if transfert starts too early)
- module « gd.mtcl »: text warning to notify the 20sec delay to retreive the archive.
- module « ipdomains.mtcl »: added « echo | » for « cnx domcpl » (module/infocollect are blocked until a
return is made)

7.22 Version 4.6

Not delivered – March/April 2012:
Added:
- module « bics »: added functionality for OT: use of the logzipper. No auto mode due to the impossibility
to detect if bics or OT.
- module « bics »: some flex logs were not retrieved
- « feml »: modification in help text
- « feml » + all modules: add a debug mode (add "DEBUG" as an argument to the command line)
- module « sip.mtcl »: sipmotor.crash added + details of command « sipextgw »: options -g & -s
- module « sip.mtcl »: « csip... » from [sip.mtcl] moved to [term.mtcl]
- module « mao »: modifyed « mao* » to « mao » during the backup copy. « mao-acc » will not be
retrieved anymore
- module « varlog »: file dhcplog
- module « varlog »: files cac log not compressed
- module « twin »: file dhcplog
- module « twin »: files cac log not compressed
- module « twin »: added command « readbbox »
- module « term.mtcl »: added « nsipview com » + « csip... » (moved to « sip.mtcl »)
- module « term.mtcl »: added « sipextusers »
- module « sysinfo »: infos « sysstat » (logs under « /tmpd/monitor_<machine name> »)
- module « sysinfo »: added « dv –i » + option « T » the 2 commandes « df »
- module « twin_extra »: infos « sysstat » for the twincpu
- module « twin_extra »: added file « sipmotor.crash »

Fixes:
- nothing.

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 15/25
7.23 Version 4.7
Not delivered – March/April 2012:
Added:
- module « term.mtcl »: added « getnoeversion » in xml format

Fixes:
- module « boards.mtcl »: problem with PCS (UNACTIVE*: impossible to decompress, in case where some
pcs are not seen)

7.24 Version 4.8

Delivered – June 2012:
Added:
- module « varlog »: added 2 files xferlog & xferlog.1
- module « twin »: added file « netdata » from the twin cpu
- module « x25.mtcl »: x25visu option 1 (all clusters) added
- module « sysinfo » + « twin »: add a grep to "NEW" in TEL*SYP files. Result file:
patchedTEL_functions.txt will show the patched functions in TEL HF.
- Module « trunks.mtcl »: added a file which is giving for each trkgrp the physical access(es). File is:
« local_trk_access.txt »

Fixes:
- module « term.mtcl »: misc issues around « getnoeversion » tool. To be executed only for the lastest
versions (oxe fixes)
- module « x25.mtcl »: x25visu option 2 was nok
- module « bics »: removed function for OT (cannot start the logzipper/ file to retrieve is too big).

7.25 Version 4.9

Delivered – June 2013:
Added:
- module « ressources.mtcl »: added « cnx cc ». Extension of cnx tool. « cc » used to check CAC.
- module « chlog »: copy flexlm 10 last logs from /usr4/afe
- module « twin »: redirection on /dev/null in case of no existing zipped files
- module « pcslogs »: remove « ipl* » files (can saturate the partition)

Fixes:
- module « boards.mtcl »: misc issues around some boards names containing blanks
- module « term.mtcl »: « getnoeversion » tool is removed due to misc malfunctions
- module « pcslogs »: add functionality to select one or several pcs

7.26 Version 5.0

Delivered TS – May 2015:
Added/modified:

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 16/25
- module “oms.mtcl”: retrieve logs from oms. The module will start the generation of the compressed tar
file & get it from all OMS configured. Needs the “admin” password for every OMS. Result is a
compressed file under the new “oms” directory.
- main prog. “feml”: no more Kermit by default. Only 1 option is kept: “-kauto” that will start
automatically the Kermit process.
- main prog. “feml”: SR 1-172644001. Add the possibility to launch infocollect if not main (stdb or no tel
started). Results may lead to undesired incidents. “gd” & “oms” are not working in this mode.

Fixes:
- module “boards.mtcl”: option “DEBUG” was missing.
- module “ressources.mtcl”: SR 1-154278743 // better way to handle "vgstat" loop (previously could cause
infocollect to block if too many GPA boards)

7.27 Version 5.1

Internally delivered – March 2017:
sfx-infocollect: version 1.5
- option in tool “tail” not working in new kernel versions. Change from “tail +<xx>” to “tail –n +<xx>”
infocollect to build will be: 5.1

Added/modified:
- “feml” main program. Request from BC: to shorten the result name (like CEST).
- “feml” main program. Request from BC: possible to execute infocollect logged as swinst user (function
"check()")
- “feml” main program. Ortaugraffe: tar in grogress !!
- NEW: module “CCR”: for Cloud Connect + Rainbow. To be continued with more maintenance tools & info
…
- module “sysinfo”: added: list applied patches in 's conf file (“memloader -D TEL”) on request of RnD
India (GURUMOORTHY NATARAJAN; Karthik GUNASEKARAN; Vijayakumar CHINNAPPAN; Praveen Kumar
GOVINDARAJ; Bhuvaneswari A S; Vaishnavi SRIRAM)
- module “sysinfo”: added flexlmlog (move from ccd.mtcl)
- module “sysinfo”: added WBM logs, down. time on tdm sets

Fixes:
- module “sysinfo”: only take sysstat files. R12.0 has capability to have new chorus-syscalls + linux-
syscalls files stats. Their size will drastically increase the time of compression. M1.403.6 patch does not
store those files unless a configuration is done. See eSR 1-204657851 & CROXE-3428
- module “twin”: ipldebug: change menu to 5.1 (from 4.1). Request from TS Brest (A.C.)
- module “twin”: changed to rsh to get twincpu info. Local data will go to "sysinfo"

7.28 Version 5.2

For OXE R12.0 release – March 2017:
Added/modified:
- Module “ressources.mtcl” : “mutual_aid_cuser” file under “ressources.mtcl/vg”
- Module “varlog” : added /var/log/openresty/access.log &
/var/log/openresty/error.log (WBM debug)

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 17/25
- Module “sysinfo” : added “wbm.conf” (WBM debug)
- module “CCR” : added logs, config file … TBC … The module creates 2 directories:
“Rainbow” & “CC”

Fixed:
- module “sysinfo” : ipldebug ok now (menu 5.1)
- module “oms” : was not working
- module “oms” : added command “downstat v” for each OMS in service.

7.29 Version 5.3

For OXE R12.1 release – July 2017:
Added/modified:
- “feml” (general program) : DEBUG mode: "DEBUG"|"-DEBUG"|"-d"|"-D" is possible
- Module “ccd.mtcl” : csta logs from /tmpd. Copied under csta_logs
- Module “ccd.mtcl” : added files "/usr3/afe/parameters.cfg" & "/usr4/afe/catalog.cfg" + other
/usr4/afe files put under new dir
- Module “twin_extra” : csta logs from /tmpd on twincpu. Copied under csta_logs
- Module “sysinfo” : ethtool (eth0 + eth1) result
- Module “twin_extra” : ethtool (eth0 + eth1) result on twincpu
- Modules “CC” & 3Rainbow” : continuation of CC & Rainbow maintenance tools

Fixed:
- Module “mao.mtcl” : forbid mao_hist on all CPU6

7.30 Version 5.4

For OXE release R12.2 TR – July 2018:
Added/modified:
- “feml” (general program) : remove empty directories (when “-i” option was used). Add an empty file
“INTERACTIVEMODE” at root directory result when “-i” option was used
- Module “dect.mtcl” : adding xbs tools (dectinfo …) + xBS statistics from all base stations in json
format.
- Module “trunks.mtcl” : avoid launching "trkvisu all" several times.
- Module “x25.mtcl” : use the “trkvisu-all” file from “trunks.mtcl” if possible.
- Module “sysinfo” : added all “/usr/netadm/msg/nethisto”
- Module “sysinfo” : added all “/usr/netadm/msg/maohisto”

Fixed:
- Module “boards.mtcl” : characters < and > to be escaped. Errors were thrown &
incomplete boards description
- Module “chlog” : "exit 0" before copying the flexlog files. They were never retrieved
- Module “twin_extra” : option -a was never used: NOARG line was always called before.
Possibility removed: always get the extra logs.

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 18/25
7.31 Version 5.5
Sync’d with OXE release R12.2 MD2 – December 2018:
Added/modified:
- Module “CCR” : : added all the rainbow agent logs instead of the
single .log file
- Module “CCR” : always get CloudConnect logs.
- Module “CCR” : adding file "/usr/netadm/data/FTR_status"
- Module “sysinfo” : adding result of dmidecode tool
- Module “twin” : adding result of dmidecode tool
- File “feml” : compression of result file is “niced” (scheduling priority
modified from 0 to 3)
- File “feml” : adding a spinner during tar/compression of result file

Fixed:
- Module “boards.mtcl” : misc. errors were thrown & incomplete boards
description
- Module “oms” : oms get logs was not working. Noted that if at
least 1 manual generation of logs at the 1rst time after installation is not done the infocollect method
will not work (directory ~/home/sftplogs for admin does not exist by default)
- Module “chlog” : test of black box files. Avoid reading 0 size file
(tool gets stuck)

7.32 Version 5.6

Delivered Feb. 2019
Added/modified:
- “feml” (general program) : info for "nice" is "nice -3", not "nice -15" !!
- Module “varlog” : added "auth" log files
- Module “varlog” : added "openswan" log files
- Module “varlog” : modified - "openresty_" on error & access logs for
better identification (wbm related)

Fixed:
- Module “x25.mtcl” : error with "cat ../trunks.mtcl" – changed to "cat
../../trunks.mtcl"

7.33 Version 5.7

Sent for delivery W1919

Added/modified:
- “feml” (general program) : add “q” option to quit infocollect & tar what was already
executed in interactive mode
- Module “dect.mtcl” : added a protection in case xBS does not respond to “curl”
command
- Module “applications.mtcl” : added a new oxe tool : “cryptcheck” with 2 arguments.

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 19/25
- Module “sysinfo” : added result of tool “securitystatustool” (from
R12.2)
- Module “sysinfo” : added result of tool “wbminfo”
- Module “sip.mtcl” : added sipsecurityinfo tool

Fixed:
- Nothing

7.34 Version 5.8

Sent for delivery W19xx – October 2019 – OXE R12.3.1 patch “D”
Added/modified:
Module “term.mtcl” : added "forcenoe" command (request from TS). List users
with/without virtual add on 2 files “forcenoe_novirtualaddon” & “forcenoe_virtualaddon”
- Module “applications.mtcl” : add new tool “cryptcheck” on request of TS
- Module “ipterms.mtcl” : add "Display all IP Phone on local node" option “3” in
ippstat (result file : “ippstat-all_IP_Phones”) + ippstat menu : “ippstat__menu” for debug purpose
- Module “ipterms.mtcl” : add ippstat dualsip (file “ippstat_dualsip”)
- Module “sysinfo” : copy ALL wbm.log files (added "*") - Request of TS
- Module “version.mtcl : "downstat" tool -> adding options for SUOTA & other info
- Builder 1.6 : “sh” directory removed from /feml.d

Fixed:
- Nothing

7.35 Version 5.9

Sent for delivery Oct. Nov. 2019
Added/modified:
- [sysinfo] : error in "usr2/servers/memloader -D TEL" : missing "/"
- [sysinfo] : new netstat option
- [etc] : remove system-auth.noradius
From January 2020
- [CCR] : menu CCTool has changed !! :-(
- [CCR] : add tool "checkCloudConfig.sh" ... with option -rainbow
- [CCR] : add logs "/tmpd/cloud_cnx/log" from both main & stdb cpu
- [twin_extra] : remove checkdb. Added option "strace" : strange case where checkdb gives
exception: rsh method is blocking ! (Ch.W. : no case/ discussion Rainbow thread)
- [term.mtcl] : getnoeversion is back. Limited to Mx versions (!= kernel 2.4)
- [applications.mtcl] : /tmpd/iptsecmigration/iptsecmigration.debug => Thales migration
- [sysinfo] : pstree -> pstree -ap

Fixed:
- nothing

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 20/25
7.36 Version 6.0
Not sent for delivery

From April/2020
- [gas] : new module to be used to inject/r-execute "infocollect_gas.bash"
in a GAS/Flex server & retrieve logs outside infocollect archive
- [infocollect_gas.bash] : new module located in new "sh" directory. Contains all commands to be
executed on a GAS or FLEX server (any Suse)
- [twin] : all /usr/netadm/data/netdata files (rcp
/usr/netadm/data/netdata*)
- [sysinfo] : all /usr/netadm/data/netdata files (rcp
/usr/netadm/data/netdata*)
- [ressources.mtcl] : added cnx co (OMS check config) + cnx fax (fax issues - request
from Au. Sch.)
- [mao.mtcl] : added the spinner placed for maohist extractions
- [feml] : no more option "-kauto" due to modem removal + file too big to
retreive. Manual transfer still possible by using the "kermit" tool
- [feml] : "gas" option: only execute the gas module & quit
- [feml] : tar was executed twice !! only "nice" is kept
- [feml] : test on files ".sh": continue on loop
- [anti_loop] : text modified: "infocollect: anti-loop launched__partition full
detection"
- [feml] : during the modules loop all ".sh" files are skipped as well as
directories
- [gas.sh] functionning : option "gas" is analyzed during the args check & immediately
executed (/usr/sbin/feml.d/gas.sh & exit).

7.37 Version 6.1

Sent for delivery Oct. 2020 (oxe R12.4 MD2)

- [feml] : added option time|TIME (debug purpose) : each module is timed

- [feml] : copy "search.vbs" from "...feml.d/external" to infocollect result
- [applications.mtcl] : check certificates (MD5sum) between main & stdb (tls
main/twin/network : .pem files)
- [sysinfo] : tool oxe-verify-lanpbx.pl + copy under "applications.mtcl"
- [twin] : tool oxe-verify-lanpbx.pl on twin cpu + copy under "sysinfo" &
"applications.mtcl"
- [version.mtcl] : added binipxbs (no readable by "readhead" tool)
#
- [./external] : new dir added for external tools not "sh"
- [./extenal/search.vbs] : copied on resul compressed file - used to localize a file given an
input string

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 21/25
7.38 Version 6.2
Sent for delivery OXE R12.4 MD2 Oct. 2020

- [feml] : remove old unused modules (pcs.mtcl + gd)

- [version.mtcl] : firmware : readhead : egrep only on important info (file less big,
easier to read)
- [applications.mtcl] : error on checks (twincpu_eth test + FSNE) gave bad return status -
> [FAILED]

7.39 Version 6.3

Sent for delivery OXE R12.4 MD2 Oct. 2020

- [feml] : remove old unused modules (pcs.mtcl + gd)

- [feml] : CROXE-18995 RED-14-007727-013: Privilege escalation (security issue)
- [feml] : added feature TRAP (new argument) -> do ps, df -i, df -v ...
- [feml] : tar redirected to /dev/null (error messages if _anti_loop detects usr4 full)
- [feml] : tput blink for message "tar in progress"
- [_anti_loop] : modified to check /usr4 size : >or eq to 95% : break
- [_anti_loop] : added a detection of /usr4 full at over 90% OR infocollect dir >500Mb + other kills
...
- [sysinfo] : added vmware-toolbox-cmd -v
- [term.mtcl] : getnoeversion -> added a timer to kill getnoeversion if working too long
- [term.mtcl] : remove files "mcsedxxxxxxxx" created by edsbr each time the tool is launched
(CROXE-19525)
- [varlog] : get /var/log/nginx/*.log files (RnD request)

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 22/25
7.40 Version 6.4
Sent for delivery OXE R12.4 MD4 Dec. 2020

- [anti-loop] : detection of infocollect size (uncompressed) increased to 1gb

- [CCR] : for all rcp: 2>&1 >/dev/null 2>/dev/null instead of 2>/dev/null for rcp
(unnecessary display during rcp transfer if ssh is validated)
- [netw_incid.mtcl] : for all rcp: 2>&1 >/dev/null instead of 2>/dev/null for rcp (unnecessary display
during rcp transfer if ssh is validated)
- [pcs_logs] : for all rcp: 2>&1 >/dev/null instead of 2>/dev/null for rcp (unnecessary display
during rcp transfer if ssh is validated)
- [twin] : for all rcp: 2>&1 >/dev/null instead of 2>/dev/null for rcp (unnecessary display
during rcp transfer if ssh is validated)
- [twin_extra] : for all rcp: 2>&1 >/dev/null instead of 2>/dev/null for rcp (unnecessary display
during rcp transfer if ssh is validated)

7.41 Version 6.5

Sent for delivery OXE R12.4 MD4 March 2021

- [feml] : added option "-nc": no compression of result file (modify tar command)
- [feml] : option “-db” to force the backup menu - modif on arg.: added $DB to all modules
(to be caught by "mao")
- [twin] : added “vmware-toolbox-cmd -v”
- [applications.mtcl] : added tool “dsstat” (options 1-7) + “dsstat” help menu
- [applications.mtcl] : copy of “ost” log tar file from main & stdb cpu (requested to perform
“ost_import” log on both cpus).
- [term.mtcl] : added edabv - requested by Corinne - result file : edmcs-abreviated-number
- [term.mtcl] : added ipcheck -all (from oxe R12.4 MD4)
- [mao] : module reworked. Argument "-db" will ask for IMMED bck otherwise DAY is copied.
NODB option removed.
- [CCR] : result of command “getRainbowInfo”
- [trunks.mtcl] : DL links information (N1 preparation). Commands done: “dlvisu”, “trkvisu dl”,
“hybvisu dl”

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 23/25
7.42 Version 6.6
Not sent for oxe delivery

Fix:
- [gas.sh] : BASH_INFOC_LOCATION changed to /usr/sbin... etc ! otherwise works only
under this directory
- [gas.sh] : misc errors. DEBUG handling (only "-DEBUG -gas")
- [infocollect_gas.sh] : V1.3 - misc errors + added new logs & commands from HD ... etc
- [trunks.mtcl] : avoid "remote" trunks in trkstat <trk nb>. CROXE-21983: module is stuck!
fix also in oxe N1 patch (direct link case only).

Added:
- [dect.mtcl] : ibsstat
- [gd.mtcl] : added ioip3 : $TOOL config $1 $2 | egrep -i "gd3|ga3|intip3|ioip3"
>/dev/null & other functions to add IOIP3 ...
- [gd.mtcl] : added GA/GD4 logs generation & retrieval

/!\ WARNING: regression on GD3/GD4 logs retrieval

7.43 Version 6.7

Sent for delivery Oct 2021 (oxe R100.0)

Fix:
- [gas.sh] : misc modifs
- [infocollect_gas.sh] : V1.4 - modifs + result file is zipped. No more tar due to parasite files
PaxHeaders
- [ops.mtcl] : devnull on copy .zip

Added:
- [sysinfo] : request from A.P. to add vmware tools logs (/tmp/vmware-root directory
& logs checks+copy)
- [twin_extra] : vmware tools logs on twin cpu

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 24/25
Submitting a Service Request
Please connect to our eService Request application.

Before submitting a Service Request, please be sure:

− The application has been certified via the AAPP if a third party application is involved.
− You have read the release notes that list new features, system requirements, restrictions, and more,
and are available in the Technical Documentation Library.
− You have read through the related troubleshooting guides and technical bulletins available in the
Technical Documentation Library.
− You have read through the self-service information on commonly asked support questions and known
issues and workarounds available in the Technical Knowledge Center.

- END OF DOCUMENT -

OmniPCX Enterprise - All OXE releases

infocollect: usage, features, bug fixes & debug methods TC2823 ed04
© Copyright 2022 ALE International, ALE USA page 25/25