* * * READ ME * * * * * * VERITAS SORT Lite Inventory Collector * * * This document provides the following information: * ABOUT THE TOOL * SYSTEM REQUIREMENTS * RUNNING THE TOOL * GETTING HELP ABOUT THE TOOL ------------------------ SORT Lite Inventory Collector (hereinafter referred to as 'The tool') can scan the systems you specify and gather information about them. SORT uses this information to generate a report. The report lists the basic information of the scanned systems and counts Veritas InfoScale products used in your environment. The report counts a product as in use if it is installed and has a valid license key. The calculation in the report is based on Core Plus licensing model. Core Plus is InfoScale's latest pricing model which was released on April 5th, 2021. Core Plus licensing enables you to use an InfoScale license on any platform regardless of OS and whether its physical, virtual. Core Plus allows you to license only the server processor cores that you need and also adds a core coefficient based on performance so that slower processors cost less, and faster processors cost more. Core Plus data is included in the report in XLSX or XML format. The following diagram show how this tool scan the target nodes. * Driver node: The system on which you install and run the tool * Target node: The systems to be scanned by this tool. +---------------------+ | | | Driver node | | | +---------------------+ | | +--------------------------|--------------------------+ | | | | | | +----------|----------+ +----------|----------+ +----------|----------+ | | | | | | | Target Node | | Target Node | | Target Node | | | | | | | +---------------------+ +---------------------+ +---------------------+ SYSTEM REQUIREMENTS ---------------------------------- The system on which you install the tool must meet the following minimum requirements: * OS requirements: * Windows 2012 and later * Or RHEL 6 and later * Or SUSE 12 and later * JAVA 8 and later * 1024 MB free RAM * 1024 MB free swap space * 2 GB free disk space The disk space required to store log files varies based on the number of target systems that the data collector scans and the number of times it scans them. * 256 open files limit You must install the tool on a local file system, not a Network File System (NFS). The tool can scan the local system and the target systems remotely, including the following platforms: * Windows * Linux * UNIX (AIX, Solaris) For remote scanning, make sure: * For the Windows systems: - WMI service: WMI is Windows Management Instrumentation. WMI service should be enabled on the target systems. - Firewall: The Windows Firewall must be configured to allow inbound connections to the WMI service. You may need to open the required ports for WMI, which are typically TCP ports 135 and 445. * For the Linux/UNIX systems: - SSH server: The Linux server must have an SSH service installed and running. The most common SSH server is OpenSSH, which can usually be installed from the package repositories of the Linux/UNIX distributions you are using. - Firewall: The firewall on the Linux server must be configured to allow incoming SSH traffic. By default, SSH traffic uses port 22. Please note, the tool running on Windows system can collect data from both Windows and UNIX/Linux target systems; the tool running on Linux system can only collect from Linux/UNIX target systems. RUNNING THE TOOL ----------------------------------------------------- The tool and related resources have been packaged into a zip file. You only need to download the tool zip file once and this tool doesn't need to be installed. It can work in both GUI and CLI mode. To run the tool in GUI mode on your local computer: 1. Unzip the tool zip file. 2. Run the tool: * Go to the unzipped folder. * When the tool runs on a Windows server, run the run_gui.bat script. * When the tool runs on a Unix/Linux server, run the run_gui.sh script. 3. In the System tab, Click "Add" button to add the target systems: * Platform: Add Linux/UNIX or Windows systems in the same domain with the same username and password. * System: Input an IP address, hostname, or IP address range, for IPv4 only. Please note, the format of the IP address range should be "{START-IP} - {END-IP}". Not only the IPs between the START-IP and END-IP but also the start IP and end IP will be imported as target systems. For example, when the input system is "10.200.0.1 - 10.200.0.3", The target systems imported will be 10.200.0.1, 10.200.0.2, and 10.200.0.3 * Username: Authenticated username to access the target system(s). * Password: Authenticated password for your username to access the target system(s). 4. On the hosts' list table, select the target systems to scan. 5. Click the "Scan" button, then a scanning wizard window will pop out. 6. On the scanning wizard windows, check the selected target systems and click the "Next" button to start scanning. 7. When all scanning tasks are finished, the scanning wizard windows will jump to a summary page. 8. On the scanning wizard windows, click the "Finish" button to close it. 9. Click the "Report" tab on the top of the main frame, then you could find the generated reports. To run the tool in CLI mode on your local computer: 1. Unzip the tool zip file. 2. Prepare a file that contain all hosts to be scanned. * The file could be in CSV or Yaml format. * For more details about the format, please refer to the document in the samples/readme.md file. 3. Run the tool: * Go to the unzipped folder. * When the tool runs on a Windows server, run 'run.bat --scan -f [host_file]' command. * When the tool runs on a Unix/Linux server, run 'run.sh --scan -f [host_file]' command. * By default, the tool will upgrade itself before scanning. Add "no-upgrade" before the "--scan" command to skip the upgrade. * The tool generates standard reports after scanning or merging by default. Add "sanitized" before the "--scan" or "--merge" command to generate sanitized reports. 4. When all scanning tasks are finished, the tool will print the report location. 5. Execute the following command to know more information about the commands: * When the tool runs on a Windows server, run 'run.bat -h' command. * When the tool runs on a Unix/Linux server, run 'run.sh -h' command. HOW TO DECOMPRESS ------------------------ To unpack the tool zip file, use the command below: unzip sort_lwdc.zip If the "unzip" command is unavailable on your platform, you may resort to utilizing the "jar" command as follows: jar -xvf sort_lwdc.zip cd sort_lwdc chmod +x run*.sh Please note, the "jar" command does not retain executable permissions during the unzipping process. Therefore, it's essential to add executable permission explicitly to the run.sh and run_gui.sh scripts. GETTING HELP ------------------------ If you have any questions or want to report an issue, please go to SORT page and click 'CONTACT US' on SORT pages. https://sort.veritas.com/