Metadata-Version: 2.1
Name: rt-server-client
Version: 3.0.0
Summary: Racktables Server client for automation
Home-page: https://github.com/rvojcik/rt-server-client
Author: Robert Vojcik
Author-email: robert@vojcik.net
License: GPLv3
Description: RT-server-client
        ================
        
        ![pipeline](https://gitlab.com/rvojcik/rt-server-client/badges/master/pipeline.svg)
        
        UPDATE:
        -------
        According to new version 0.3.0 there are few breaking changes.
        Be aware when upgrading.
        
        **CHANGELOG 0.3.0:**
        * Removed Python 2.7 support, **Python 3.x only is supported**
        * Big redesign in SW installation. Use setup.py or pip to install
        * `--init` option for initializing custom Attributes in racktables
        * split code into few different classes  
        
        Description
        -----------
        
        This is server discovery script for Racktables project.
        It discover system, import or update infromation into racktables database
         
        Script support following infromation
        
        * hostname
        * transfer comment field to server motd (message of the day)
        * commend-edit utility for editing comments on racktables directly from server
        * service tag
        * supermicro exeption for service tag (my supermicro servers has all same ST and Expres ST. I don't know why)
        * for Dell servers: get warranty and support information from Dell website based on server ST.
        * Physical and logical interfaces (eth,bond,bridges,venet and veth)
        * IPv4 and IPv6 IP addresses, import and update in database
        * Dell iDrac IP address (require Dell-OMSA Installed)
        * OS Dristribution and Release information
        * HW vendor and product type
        * Hypervisor recognition (Xen 4.x)
        * Hypervisor recognition (OpenVZ)
        * Virtual server recognition (Xen 4.x)
        * Virtual server recognition (OpenVZ)
        * Link Virtual server with hypervisor as container in Racktables
        * Racktables logging - when change ip addresses or virtual link with hypervisor
        * Interface Connection (LLDPD needed for this feature. System automaticly link server interfaces with switch ports in RackTables)
        
        For some description, screenshots and examples visit https://www.cypherpunk.cz/automatic-server-audit-for-racktables-project/
        
        Requirements
        ------------
        
        Required
        
        * racktables-api (install with pip >=0.2.7)
        * Python >= 3.5.x 
        * lsb-release package(detection of Linux distribution and release)
        
        Optional
        
        * smbios-utils (HW Vendor, Server model and Service-Tag)
        * if you don't use smbios-utils, script generate random servicetag in /etc
        * LLDPd (information about interface connection with switches and other devices)
        * Dell OMSA (for information about iDRAC configuration)
        
        Installation
        ------------
        
        Install it as normal python sw using pip or setup.py.
        
        **PIP Install**
        
            pip install rt-server-client
        
        **Manual Install**
        
            git clone https://github.com/rvojcik/rt-server-client
            cd ./rt-server-client
            sudo python ./setup.py install
        
        **Configuration**
        
        Configuration file have to be located in `/etc/rt-server-client/main.conf`
        
        When you have your configuration file you have to run **initialization** of the project.
        It requires number of custom attributes in racktables database. Initialization process
        check if these attributes are available and map them to correct object types.
        
        Just run
            system-info -d --init
        
        Add to root crontab following line for run script every 30 minutes
        
            */30 * * * * cd /usr/local/bin/system-info
        
        Normaly script ends without any output. If something go wrong it returns some output of the error. 
        
        License
        -------
        
        This utility is released under GPL v2
        
        RT-server-client utility for Racktables Datacenter management project.
        Copyright (C) 2012  Robert Vojcik (robert@vojcik.net)
        
        This program is free software; you can redistribute it and/or
        modify it under the terms of the GNU General Public License
        as published by the Free Software Foundation; either version 2
        of the License, or (at your option) any later version.
        
        This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        GNU General Public License for more details.
        
        You should have received a copy of the GNU General Public License
        along with this program; if not, write to the Free Software
        Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
        
        Server discovery client for RackTables project. 
        Do automatic server discovery and send information to racktables database.
        
        Used for automatic servers documentation.
        
Keywords: rtapi,racktables,racktables automation,automation,server,racktables-client,rt-server-client,rt-client
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Documentation
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Classifier: Topic :: Database
Description-Content-Type: text/markdown
