xcat-core/xCAT-server/lib/xcat/schema/samples/Sample.pm
2009-01-14 19:03:37 +00:00

116 lines
4.1 KiB
Perl

# IBM(c) 2007 EPL license http://www.eclipse.org/legal/epl-v10.html
package xCAT_schema::Sample;
#################################################################################
# This is a sample code that contains the user defined user database schema defination.
# Here is a list of things you can do to add DB tables to xCAT database.
# 1 copy this file to /opt/xcat/lib/perl/xCAT_schema directory, rename it.
# 2 change the word Sample above to be the same as the file name.
# 3 Do NOT change the variable name "%tabspec".
# 4 lljob and llnode are the table names.
# jobid, status, node, jobstatus are the column names. Change them to your like.
# Each table must have a 'disable' column.
# Please do not use SQL reserved words for your table names and column names.
# Use this site to check the reserved words:
# http://www.petefreitag.com/tools/sql_reserved_words_checker/
# 5 change the keys.
# 6 change the data types. The default data type is TEXT if not specified.
# The supported data types are:
# REAL,CHAR,TEXT,DATE,TIME,FLOAT,BIGINT,DOUBLE,STRING,
# BINARY,DECIMAL,BOOLEAN,INTEGER,VARCHAR,SMALLINT,TIMESTAMP
# Please note that SQLight only supports: INTEGER, REAL, TEXT, BLOB.
# 7 change the table descriptions and column descriptions to your like.
# 8 restart the the xcatd, the tables will be automatically generated.
# 9 copy your file to all the service nodes and restart the xcatd on all the service node.
#
###############################################################################
%tabspec = (
lljob => {
cols => [qw(jobid status comments disable)], #do not change 'disable' and 'comments', it is required by xCAT
keys => [qw(jobid)],
required => [qw(jobid)],
types => {
jobid => 'INTEGER',
},
table_desc => 'Stores jobs.',
descriptions => {
jobid => 'The job id.',
status => 'The status of the job.',
comments => 'Any user-written notes.',
disable => "Set to 'yes' or '1' to comment out this row.",
},
},
llnode => {
cols => [qw(node jobid jobstatus cpu_usage comments disable)],
keys => [qw(node)],
required => [qw(node jobid)],
types => {
jobid => 'INTEGER',
cpu_usage => 'FLOAT',
},
table_desc => 'Stores the node status.',
descriptions => {
node=> 'The node.',
jobid => 'The job that runs on the node.',
jobstatus => 'The status of the job on the node.',
cpu_usage => 'The percent of cpu usage on the node.',
comments => 'Any user-written notes.',
disable => "Set to 'yes' or '1' to comment out this row.",
},
},
); # end of tabspec definition
##################################################################
# The following %defspec is OPTIONAL. You only need to define it
# if you want your tables to work with xCAT object abstraction layer
# commands such as lsdef, mkdef, chdef and rmdef.
#
# Note: The xCAT database accessting commands such as
# tabdump, chtab, gettab, nodels, nodeadd, nodech, etc.
# still work without it.
##################################################################
%defspec = (
job => { attrs => [], attrhash => {}, objkey => 'jobid' }, #create a new object called 'job',
);
#define the attribtues in the 'job' object using the lljob talbe columns.
@{$defspec{job}->{'attrs'}} =
(
{ attr_name => 'jobid',
tabentry => 'lljob.jobid',
access_tabentry => 'lljob.jobid=attr:jobid',
},
{ attr_name => 'status',
tabentry => 'lljob.status',
access_tabentry => 'lljob.jobid=attr:jobid',
},
);
#object 'node' already defined in /opt/xcat/lib/perl/xCAT/Schema.pm.
#Here we just add jobid and jobstatus attributes to the node object
@{$defspec{node}->{'attrs'}} =
(
{ attr_name => 'jobid',
tabentry => 'llnode.jobid',
access_tabentry => 'llnode.node=attr:node',
},
{ attr_name => 'jobstatus',
tabentry => 'llnode.jobstatus',
access_tabentry => 'llnode.node=attr:node',
},
{ attr_name => 'cpu',
tabentry => 'llnode.cpu_usage',
access_tabentry => 'llnode.node=attr:node',
},
);
1;