server/idl/iscream.idl

// 
// i-scream central monitoring system
// http://www.i-scream.org.uk
// Copyright (C) 2000-2002 i-scream
// 
// 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
//

// 
// This class provides infomation about the CORBA
// interface for the server side of the i-scream system.
//
// $Id: iscream.idl,v 1.22 2002/05/21 16:47:16 tdb Exp $
//
module uk { module org { module iscream { module cms { module server {
    module core {
    
        // The Logger interface, provides a corba object that
        // all classes can use to log system and error information.
        interface Logger {
            void write(in string source, in long verbosity, in string message);
            // Verbosity levels
            const long FATAL=0;
            const long ERROR=1;
            const long WARNING=2;
            const long SYSMSG=3;
            const long SYSINIT=4;
            const long DEBUG=5;
        };
        
        // The Configuration interface, provides a CORBA object that
        // all classes can use to get their configuration.
        interface Configuration {
            string getProperty(in string key);
            long long getLastModified();
            string getFileList();
            void disconnect();
        };
        
        // The ConfigurationManager interface, provides a CORBA object that
        // all classes can use to obtain their individual configuration.
        interface ConfigurationManager {
            Configuration getConfiguration(in string source);
            boolean isModified(in string source, in long long currentModified);
        };
    
    // end core
    };
    
    module filter {
        interface Filter {
            void receiveXML(in string xml);
        };
        interface FilterInfo {
            string getHostName();
            string getUDPPort();
        };
        
    // end filter
    };
    
    module client {
        interface Client {
            void receiveXML(in string xml);
        };
    // end client
    };
    
    module clientinterface {
        interface ClientInterface {
            void receiveXML(in string xml);
        };
        interface CorbaControlHandler {
            boolean startData();
            boolean stopData();
            boolean setHostList(in string hostList);
            void disconnect();
        };
        interface CorbaClientListener {
            CorbaControlHandler connect(in client::Client client, in string name);
        };
    // end clientinterface
    };

// end uk.org.iscream.cms.server
};};};};};
Revision:	1.23
Committed:	Mon Feb 24 20:18:46 2003 UTC (21 years, 8 months ago) by tdb
Branch:	MAIN
Changes since 1.22:	+1 -2 lines
Log Message:	Fairly major commit. This will break the current version of ihost, but this had to be done really to give Pete something to test the new ihost against. The main change here is removal of the TCP Heartbeat functionality from the filter. This meant the following features stopped working :- - Heartbeat testing - Configuration checking - Service checks The heartbeat testing, specifically the monitor, now looks at the presence of UDP packets instead. Before it just looked for the presence of a TCP heartbeat packet, so the change their is fairly negligible. Of course this means heartbeat testing now relies on the UDP working... but I don't see this as a problem. Configuration checking has been repositioned in to the filtermanager. This is a backwards compatible change - the filtermanager should still perform as it should for older hosts. But now there's an extra command to check the configuration is up-to-date, with a similar format to the old TCP protocol in the filter. (although we may optimise this soon) The service checks are broken. This isn't a major issue for us as they were pretty useless in the first place. The concept is good, but the checks are just far too primitive. I expect at some point I'll work on a seperate component that just monitors services, which will replace this function. Further changes in the server include removal of the key checking code, as this relied on a bolt on to the TCP heartbeat protocol to ship the key. This got more akward than originally planned, so I'm happy to drop the idea. In the long term we hope to replace this with a public key systems for signing and even encryption. Finally, general tidy up to remove other bits of code that check for TCP heartbeat packets when they don't need to any more.
#	Content
1	//
2	// i-scream central monitoring system
3	// http://www.i-scream.org.uk
4	// Copyright (C) 2000-2002 i-scream
5	//
6	// This program is free software; you can redistribute it and/or
7	// modify it under the terms of the GNU General Public License
8	// as published by the Free Software Foundation; either version 2
9	// of the License, or (at your option) any later version.
10	//
11	// This program is distributed in the hope that it will be useful,
12	// but WITHOUT ANY WARRANTY; without even the implied warranty of
13	// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14	// GNU General Public License for more details.
15	//
16	// You should have received a copy of the GNU General Public License
17	// along with this program; if not, write to the Free Software
18	// Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19	//
20
21	//
22	// This class provides infomation about the CORBA
23	// interface for the server side of the i-scream system.
24	//
25	// $Id: iscream.idl,v 1.22 2002/05/21 16:47:16 tdb Exp $
26	//
27	module uk { module org { module iscream { module cms { module server {
28	module core {
29
30	// The Logger interface, provides a corba object that
31	// all classes can use to log system and error information.
32	interface Logger {
33	void write(in string source, in long verbosity, in string message);
34	// Verbosity levels
35	const long FATAL=0;
36	const long ERROR=1;
37	const long WARNING=2;
38	const long SYSMSG=3;
39	const long SYSINIT=4;
40	const long DEBUG=5;
41	};
42
43	// The Configuration interface, provides a CORBA object that
44	// all classes can use to get their configuration.
45	interface Configuration {
46	string getProperty(in string key);
47	long long getLastModified();
48	string getFileList();
49	void disconnect();
50	};
51
52	// The ConfigurationManager interface, provides a CORBA object that
53	// all classes can use to obtain their individual configuration.
54	interface ConfigurationManager {
55	Configuration getConfiguration(in string source);
56	boolean isModified(in string source, in long long currentModified);
57	};
58
59	// end core
60	};
61
62	module filter {
63	interface Filter {
64	void receiveXML(in string xml);
65	};
66	interface FilterInfo {
67	string getHostName();
68	string getUDPPort();
69	};
70
71	// end filter
72	};
73
74	module client {
75	interface Client {
76	void receiveXML(in string xml);
77	};
78	// end client
79	};
80
81	module clientinterface {
82	interface ClientInterface {
83	void receiveXML(in string xml);
84	};
85	interface CorbaControlHandler {
86	boolean startData();
87	boolean stopData();
88	boolean setHostList(in string hostList);
89	void disconnect();
90	};
91	interface CorbaClientListener {
92	CorbaControlHandler connect(in client::Client client, in string name);
93	};
94	// end clientinterface
95	};
96
97	// end uk.org.iscream.cms.server
98	};};};};};