Appendix

Change log

Support

If you have any issue or bug to report you can contact us at

support@renegatt.com

The details you provide are necessary to replicate your issue on our site. It's important that the information you send us is as relevant and detailed as possible. This will let us solve the issue as quickly as possible.

Required information
Contact details
  • Company
  • Name
  • email address
  • License UID You can retrieve the License UID from OServer's configuration file 'with the help of the following command:
    $ cat [OSERVER_CONFIGURATION_FILE]| grep oserver_license_uid   
    
    Where [OSERVER_CONFIGURATION_FILE] is the path to your OServer's configuration file.
    Issue description Please describe the issue and the conditions it appears under in the greatest possible detail.

    Below, for your convenience, we have prepared a list of important information and how to acquire them. Although all the information is not required, it will speed up the process of solving the issue.

    If some of the information on the listings is information you do not want to share with us, and you remove them, please make a note so that we will not see this as a system problem.

    Client's information
    gpubox and agpubox version
    $ gpubox version
    $ agpubox version
    
    Client's system information

    Linux

    Issue the following commands. Although they don't require administrative privileges, in some cases you will need to ask for your system administrator's assistance. Depending on the system's configuration some of the commands, like InfiniBand or GPU adapters related, will not work.

    For your convenience we have prepared a script you can use to retrieve the same information about the Linux operating system.
    Script is located in <OSERVER_INSTALLATION_DIR>/bin/gpubox_support.sh. Please run the script and attach the output file.

    Basic system data
            
    uname -a
    cat /proc/cpuinfo
    cat /proc/meminfo
    lspci -vvv
    lsmod
    df -h
    nvidia-smi -a
    ldconfig -p
    
    Network data
            
    ifconfig
    iptables
    
    InfiniBand data
    ibstat
    ibnetdiscover
    sminfo
    ofed_info
    
    User's environment
    env
    ulimit -a
    ps aux
    
    Client's system

    Windows

    Basic system data Attach system's information from msinfo32.exe.
    Click Windows Start> and run msinfo32.exe application and save system's information via menu File -- > Export Network data
            
    ipconfig
    
    InfiniBand data
    ibstat
    ibnetdiscover
    sminfo
    
    Description if possible describe the Client's behavior and the programs that were running when the error occurred.
    Client's messages Attach client's messages if any.
    OServer address

    Linux

    Attach OServer's address from $HOME/.gpubox.
    OServer address

    Windows

    Attach OServer's address from file %LOCALAPPDATA%\gpubox.config.
    OServer's information
    OServer's system information

    Linux only

    Issue the following commands. Although they don't require administrative privileges, in some cases you will need to ask for your system administrator's assistance. Depending on the system's configuration some of the commands, like InfiniBand or GPU adapters related, will not work.

    For your convenience we have prepared a script you can use to retrieve the same information about the Linux operating system.
    Script is located in <OSERVER_INSTALLATION_DIR>/bin/gpubox_support.sh. Please run the script and attach the output file.

    Basic system data
            
    uname -a
    cat /proc/cpuinfo
    cat /proc/meminfo
    lspci -vvv
    lsmod
    df -h
    nvidia-smi -a
    ldconfig -p
    
    Network data
            
    ifconfig
    
    InfiniBand data
    ibstat
    ibnetdiscover
    sminfo
    ofed_info
    
    User's environment
    env
    ulimit -a
    ps aux
    
    OServer's configuration Attach OServer configuration file.
    OServer's log Attach OServer's log file with at least the relevant issue information.
    GPUServer's information
    GPUServer's system information

    Linux only

    Issue the following commands. Although they don't require administrative privileges, in some cases you will need to ask for your system administrator's assistance. Depending on the system's configuration some of the commands, like InfiniBand or GPU adapters related, will not work.

    For your convenience we have prepared a script you can use to retrieve the same information about the Linux operating system.
    Script is located in <OSERVER_INSTALLATION_DIR>/bin/gpubox_support.sh. Please run the script and attach the output file.

    Basic system data
            
    uname -a
    cat /proc/cpuinfo
    cat /proc/meminfo
    lspci -vvv
    lsmod
    df -h
    nvidia-smi -a
    ldconfig -p
    
    Network data
            
    ifconfig
    
    InfiniBand data
    ibstat
    ibnetdiscover
    sminfo
    ofed_info
    
    User's environment
    env
    ulimit -a
    ps aux
    
    OServer's configuration Attach OServer configuration
    OServer's log Attach GPUServer's log file with at least the relevant issue information.

    List of scripts

    Script name Localization Description
    gpubox_firewall.sh [gpubox-oserver]/bin If necessary it helps to sets the firewall rules during installation.
    Usage:
    gpubox_firewall.sh [MODE]
    
    Available modes:
      clean     - allow only loopback and established,related traffic
      client    - set firewall for client
      gpuserver - set firewall for gpuserver
      oserver   - set firewall for oserver
    
    gpubox_login.sh [gpubox-client]/bin Provides panels to help to sign in to the GPUBox infrastructure.
    gpubox_support.sh [gpubox-oserver]/bin Helps to retrieve information about the Linux operating system.
    Usage:
    /home/bob/gpubox-oserver/bin/gpubox_support.sh [--system|-s|--network|-n|--infiniband|-i|--environment|-e|--help|--h|--all|-a]
    
    	--all|-a - default option, all information will be saved
    
    Example:
    $ ./gpubox_support.sh 
     =========== SYSTEM ============
    uname -a  SAVED  
    cat /proc/cpuinfo  SAVED  
    cat /proc/meminfo  SAVED  
    lspci -vvv  SAVED  
    lsmod  SAVED  
    df -h  SAVED  
    nvidia-smi -a  SAVED  
    ldconfig -p  SAVED  
     =========== NETWORK ============
    ifconfig  SAVED  
     =========== INFINIBAND ============
    ibstat  SAVED  
    ibnetdiscover  NOT PROVIDED  
    sminfo  NOT PROVIDED  
    ofed_info  SAVED  
     =========== ENVIRONMENT ============
    env  SAVED  
    ulimit -a  SAVED  
    ps aux  SAVED  
    
    --------------------------------------------
    When contacting support, please attach the file: gpubox_support_20140604-111644.log
    
    oserver.sh [gpubox-oserver]/bin Based on the installation process and configured parameters, it starts OServer as non-service. Script sets the following environment variables:
  • OSERVER_CONF
  • LD_LIBRARY_PATH
  • oserveru.sh [gpubox-oserver]/bin Based on the installation process and configured parameters, it starts OServer as non-service and switches user to the one specified during the installation process. The script is installed only within the root process installation. Script sets the following environment variables:
  • OSERVER_CONF
  • LD_LIBRARY_PATH
  • oserverd.sh [gpubox-oserver]/bin Based on the installation process and configured parameters, it starts OServer as non-service in daemon mode and switches user to the one specified during the installation process. The script is installed only within the root process installation. Script sets the following environment variables:
  • OSERVER_CONF
  • LD_LIBRARY_PATH
  • gpuserver.sh [gpubox-gpuserver]/bin Based on the installation process and configured parameters, it starts the GPUServer as non-service. Script sets the following environment variables:
  • GPUSERVER_CONF
  • LD_LIBRARY_PATH
  • gpuserveru.sh [gpubox-gpuserver]/bin Based on the installation process and configured parameters, it starts the GPUServer as non-service and switches user to the one specified during the installation process. The script is installed only within the root process installation. Script sets the following environment variables:
  • GPUSERVER_CONF
  • LD_LIBRARY_PATH
  • gpuserverd.sh [gpubox-gpuserver]/bin Based on the installation process and configured parameters, it starts the GPUServer as non-service in daemon mode and switches user to the one specified during the installation process. The script is installed only within the root process installation. Script sets the following environment variables:
  • GPUSERVER_CONF
  • LD_LIBRARY_PATH
  • License

    GPUBox
    Copyright © Renegatt Software
    SOFTWARE LICENSE AGREEMENT



    IMPORTANT: By downloading, installing or using the GPUBox Software you (the individual or legal entity) agree to be bound by the terms of this End User License Agreement ("EULA"). If you do not agree to the terms of this EULA you must not download, install or use the Software.

    1. DEFINITIONS
    1.1. "License" means a license granted under Section 2.1.
    1.2. "License Key" means a serial number that enables You to use the Software.
    1.3. "License Type" means the type of License applicable to the Software, as more fully described in the Order.
    1.4. "Order" means a purchase order, license agreement or other ordering document issued by You to Renegatt that references this EULA and is accepted by Renegatt as set forth in Section 4.
    1.5. "Software" means GPUBox computer program.
    1.6. "Renegatt" means Renegatt Software company

    2. LICENSE GRANT
    2.1. Subject to the terms and conditions of this EULA, Renegatt grants you a non-exclusive, non-transferable License to use the Software in executable code form only in accordance with the License Type for which You have paid the applicable fees.
    2.2. You may make one copy of the Software for archival purposes only. The copy shall be kept within your possession or control; include all titles, trademarks, copyright and restricted rights notices. You may not otherwise copy the Software without prior written consent granted to You by Renegatt.
    2.3. You may run OServer component of the Software on single machine (or virtual machine) only at a time.

    3. RESTRICTIONS: You acknowledge that the Software, its structure, organization and source code constitute valuable trade secrets of Renegatt. Accordingly, except as expressly permitted in Section 2 or as otherwise authorized by Renegatt in writing, You will not and will not permit to third party to:
    3.1. Sell, lease, license, distribute, sublicense or otherwise transfer in whole or in part the Software to any third party
    3.2. Decompile, disassemble, reverse engineer or otherwise attempt to derive source code and algorithms from the Software in whole or in part
    3.3. Copy the Software except for archival purposes
    3.4. Create, develop, license, install, use or deploy any software or services to circumvent, enable, modify or provide access, permissions or rights which violate the technical restrictions of the Software as described in this EULA. Translate, modify or create derivative works based upon the Software
    3.5. Remove any product identification, proprietary, copyright or other notices contained in the Software.

    4. ORDER:Your Order is subject to this EULA. No Orders are binding on Renegatt until accepted by Renegatt. Orders for Software are deemed to be accepted upon Renegatt''s delivery of the Software included in such Order. Orders issued to Renegatt do not have to be signed to be valid and enforceable.

    5. OWNERSHIP: The Software, all copies and portions thereof; improvements, enhancements, modifications and derivative works thereof; and all Intellectual Property Rights therein, are and shall remain the sole and exclusive property of Renegatt. Your rights to use the Software shall be limited to those expressly granted in this EULA. No other rights with respect to the Software or any related Intellectual Property Rights are implied.

    6. DISCLAIMER OF WARRANTIES: Renegatt does not warrant that the Software will operate uninterrupted or that the Software or any related website or network access point are free of malicious software and alike or other defects, or that the Software will meet (or is designed to meet) your business requirements. If your use of the Software results in the need to service or replace hardware, software, infrastructure or data, Renegatt is not responsible for any of those costs. The Software is provided on an "as-is" basis without any warranties of any kind. To the maximum extent mandated by law, Renegatt disclaims all warranties, whether expressed, implied or statutory, including any implied warranties of merchantability and fitness for a particular purpose, title, non-infringement and that warranties arising during the course of any business dealings or concerning performance issues regarding or relating to the Software, documentation or any materials furnished or provided to You under this EULA.

    7. LIMITATION OF LIABILITY: To the maximum extent mandated by law, in no event will Renegatt be liable for any lost profits or business opportunities, loss of use, loss of revenue, loss of goodwill, business interruption, loss of data or any other indirect, special, incidental or consequential damages under any theory of liability, whether based in contract, tort, negligence, product liability or otherwise.

    8. TERM AND TERMINATION
    8.1. Renegatt may terminate this EULA in its entirety effective immediately upon written notice to You if You (a) breach any provision specified in Section 3, (b) fail to pay any portion of the fees under an applicable order within ten (10) days after receiving written notice from Renegatt that payment is past due, (c) breach any other provision of this EULA or (d) you commit a material breach that cannot be rectified.
    8.2. If Renegatt terminates this EULA: (a) all Licensed rights to the Software granted to You under this EULA will immediately cease to exist and (b) You must promptly discontinue to use the Software and destroy all copies of the Software and certify in writing to Renegatt that You have fully complied with these requirements.

    9. INCLUDED SOFTWARE LICENSES
    9.1. Parts of the Software are provided under separate licenses which are specified in "licenses.txt" file.
    9.2. "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)"

    10. DATA PRIVACY: You agree that Renegatt may process technical and related information about Your use of the Software which may include protocol address, hardware identification, operating system, application software, peripheral hardware and non-personally identifiable Software usage statistics to facilitate the provisioning of updates, support or online services.

    11. GENERAL
    11.1. Notices: Any notice delivered by Renegatt to You under this EULA will be delivered via mail, email, or fax.
    11.2. Severability: If any provision of this EULA is held to be illegal, invalid or unenforceable, the provision will be enforced to the maximum extent permissible so as to effect the intent of the parties and the remaining provisions of this EULA will remain in full force and effect.
    11.3. Construction: The headings of the sections of this EULA are for convenience and are not to be used in interpreting this EULA.
    11.4. This EULA may be amended only in writing signed by the authorized representatives of both parties.
    11.5. Contact Information: www.renegatt.com

    Trademarks

    Trademarks notice

    GPUBox, GPUBox Artist, the GPUBox logo, and gpubox.com are trademarks of Renegatt Software. These and other Renegatt Software trademarked terms are marked on their first occurrence in this documentation with the appropriate symbol ™. Such trademarks may also be registered or common law trademarks in other countries. A current list of Renegatt Software trademarks are:

  • GPUBox™
  • GPUBox Artist™
  • GPUBox Web Console™
  • gpubox.com™
  • GPUBox logo

  • The following terms are trademarks or registered trademarks of other companies:


    AMD is trademark of Advanced Micro Devices Inc. InfiniBand is a registered trademark and service mark of the InfiniBand Trade Association.
    Linux is a trademark of Linus Torvalds in the United States and other countries.
    NVIDIA®, CUDA™, GeForce®, Tesla, and the NVIDIA logo are trademarks or registered trademarks of NVIDIA Corporation in the United States and other countries.
    Mellanox®, and the Mellanox logo are registered trademarks of Mellanox Technologies, Ltd. in the United States and other countries.
    Microsoft® and Windows are trademarks of Microsoft Corporation in the United States and other countries.
    OFED is a trademark of Open Fabrics Alliance, Inc.
    All other brand and product names are trademarks or registered trademarks of their respective owners.

    GPUBox, GPUBox Artist™
    © Copyright Renegatt Software 2014, 2015. All rights reserved.