pegasus/src/Server/cimserver.cpp - diff

Return to cimserver.cpp CVS log

Up to [Pegasus] / pegasus / src / Server

Diff for /pegasus/src/Server/cimserver.cpp between version 1.35 and 1.213

version 1.35, 2001/12/13 14:54:56

version 1.213, 2008/01/11 19:32:25

Line 1

//%/////////////////////////////////////////////////////////////////////////////

//%2006////////////////////////////////////////////////////////////////////////

// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.

// IBM Corp.; EMC Corporation, The Open Group.

// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; Symantec Corporation; The Open Group.

// Permission is hereby granted, free of charge, to any person obtaining a copy

// of this software and associated documentation files (the "Software"), to

Line 20

Line 29

//==============================================================================

// Author: Mike Brasher (mbrasher@bmc.com)

// Modified By: Mike Day (mdday@us.ibm.com)

// Modified By: Karl Schopmeyer (k.schopmeyer@opengroup.org)

// Modified By: Nag Boranna (nagaraja_boranna@hp.com)

// Modified By: Jenny Yu (jenny_yu@hp.com)

//%/////////////////////////////////////////////////////////////////////////////

//////////////////////////////////////////////////////////////////////

// Notes on deamon operation (Unix) and service operation (Win 32):

// Notes on daemon operation (Unix) and service operation (Win 32):

// To run pegasus as a daemon on Unix platforms:

// To run pegasus as a daemon on Unix platforms, use the -d option:

// cimserver

// cimserver -d

// To NOT run pegasus as a daemon on Unix platforms, set the daemon config

// property to false:

// The -d option has no effect on windows operation.

// cimserver daemon=false

// The daemon config property has no effect on windows operation.

// To shutdown pegasus, use the -s option:

// cimserver -s [-f] [-T timeout_value]

// cimserver -s

// To run pegasus as an NT service, there are FOUR different possibilities:

Line 60

Line 64

// To START the Pegasus service,

// net start cimserver

// or

// cimserver -start

// To STOP the Pegasus service,

// net stop cimserver

// or

// cimserver -stop

// Alternatively, you can use the windows service manager. Pegasus shows up

// in the service database as "Pegasus CIM Object Manager"

// Mike Day, mdday@us.ibm.com

//////////////////////////////////////////////////////////////////////

#include <Pegasus/Common/Config.h>

#include <iostream>

#include <Pegasus/Common/Constants.h>

#include <cassert>

#include <Pegasus/Common/PegasusAssert.h>

#include <cstdlib>

#include <Pegasus/Common/FileSystem.h>

#include <Pegasus/Common/Monitor.h>

#include <Pegasus/Server/CIMServer.h>

#include <Pegasus/Common/PegasusVersion.h>

#include <Pegasus/Protocol/Handler.h>

#include <Pegasus/Common/Logger.h>

#include <Pegasus/Common/System.h>

#include <Pegasus/Common/Tracer.h>

#include <Pegasus/Common/LanguageParser.h>

#include <Pegasus/Config/ConfigManager.h>

#include <Pegasus/Client/CIMClient.h>

#include <Pegasus/Common/HTTPConnector.h>

#include <Pegasus/Server/CIMServer.h>

#include <Pegasus/Server/ShutdownService.h>

#include <Service/ServerProcess.h>

#ifndef PEGASUS_OS_ZOS

#include <Service/ServerShutdownClient.h>

#include <slp/slp.h>

#include <Service/ServerRunStatus.h>

#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)

#include <Pegasus/Common/SetFileDescriptorToEBCDICEncoding.h>

#include <Service/ARM_zOS.h>

# ifdef PEGASUS_ZOS_SECURITY

// This include file will not be provided in the OpenGroup CVS for now.

// Do NOT try to include it in your compile

# include <Pegasus/Common/safCheckzOS_inline.h>

# endif

#endif

#if defined(PEGASUS_OS_TYPE_UNIX)

# include <unistd.h>

# include <sys/types.h>

# include <sys/stat.h>

# include <fcntl.h>

#endif

#if defined(PEGASUS_OS_TYPE_WINDOWS)

#ifdef PEGASUS_ENABLE_PRIVILEGE_SEPARATION

# include "cimserver_windows.cpp"

# define PEGASUS_PROCESS_NAME "cimservermain"

#elif defined(PEGASUS_OS_TYPE_UNIX)

# include "cimserver_unix.cpp"

#else

# error "Unsupported platform"

# define PEGASUS_PROCESS_NAME "cimserver"

#endif

#include <Pegasus/Common/Executor.h>

#ifdef PEGASUS_OS_PASE

# include <ILEWrapper/ILEUtilities2.h>

# include <ILEWrapper/qumemultiutil.h>

#endif

PEGASUS_USING_PEGASUS;

PEGASUS_USING_STD;

//Windows service variables are not defined elsewhere in the product

//enable ability to override these

#ifndef PEGASUS_SERVICE_NAME

#define PEGASUS_SERVICE_NAME "Pegasus CIM Object Manager";

#endif

#ifndef PEGASUS_SERVICE_DESCRIPTION

#define PEGASUS_SERVICE_DESCRIPTION "Pegasus CIM Object Manager Service";

#endif

#ifdef PEGASUS_OS_PASE

#include <as400_protos.h> //for _SETCCSID

#endif

class CIMServerProcess : public ServerProcess

{

public:

CIMServerProcess()

{

cimserver_set_process(this);

}

virtual ~CIMServerProcess()

{

}

//defined in PegasusVersion.h

virtual const char* getProductName() const

{

return PEGASUS_PRODUCT_NAME;

}

virtual const char* getExtendedName() const

{

return PEGASUS_SERVICE_NAME;

}

virtual const char* getDescription() const

{

return PEGASUS_SERVICE_DESCRIPTION;

}

//defined in PegasusVersion.h

virtual const char* getCompleteVersion() const

{

if (*PEGASUS_PRODUCT_STATUS == '\0' )

return PEGASUS_PRODUCT_VERSION;

else

return PEGASUS_PRODUCT_VERSION " " PEGASUS_PRODUCT_STATUS;

}

//defined in PegasusVersion.h

virtual const char* getVersion() const

{

return PEGASUS_PRODUCT_VERSION;

}

virtual const char* getProcessName() const

{

return PEGASUS_PROCESS_NAME;

}

int cimserver_run(

int argc,

char** argv,

Boolean shutdownOption,

Boolean debugOutputOption);

void cimserver_stop();

};

ServerRunStatus _serverRunStatus(

PEGASUS_PROCESS_NAME, PEGASUS_CIMSERVER_START_FILE);

AutoPtr<CIMServerProcess> _cimServerProcess(new CIMServerProcess());

static CIMServer* _cimServer = 0;

static Thread* dummyInitialThread = 0;

// The command name.

Line 126

Line 226

static const char OPTION_SHUTDOWN = 's';

static const char OPTION_FORCE = 'f';

static const char LONG_HELP[] = "help";

static const char OPTION_TIMEOUT = 'T';

static const char LONG_VERSION[] = "version";

static const String NAMESPACE = "root/cimv2";

static const char OPTION_DEBUGOUTPUT = 'X';

static const String CLASSNAME_SHUTDOWNSERVICE = "PG_ShutdownService";

static const String PROPERTY_TIMEOUT = "timeout";

ConfigManager* configManager;

void GetEnvironmentVariables(

const char* arg0,

String& pegasusHome)

{

// Get environment variables:

const char* tmp = getenv("PEGASUS_HOME");

if (!tmp)

{

cerr << arg0 << ": PEGASUS_HOME environment variable undefined" << endl;

exit(1);

}

pegasusHome = tmp;

FileSystem::translateSlashes(pegasusHome);

}

void SetEnvironmentVariables(

const char* arg0)

{

cout << "PEGASUS_HOME is now " << arg0 << endl;

String str = "PEGASUS_HOME=";

str += arg0;

char* tmp = str.allocateCString();

putenv(tmp);

// Note: don't delete tmp! putenv() uses it.

}

/** GetOptions function - This function defines the Options Table

and sets up the options from that table using the config manager.

Some possible exceptions: NoSuchFile, FileNotReadable, CannotRenameFile,

ConfigFileSyntaxError, UnrecognizedConfigProperty, InvalidPropertyValue,

CannotOpenFile.

void GetOptions(

ConfigManager* cm,

int& argc,

char** argv,

const String& pegasusHome)

Boolean shutdownOption)

{

String currentFile = pegasusHome + "/" + CURRENT_CONFIG_FILE;

if (shutdownOption)

String plannedFile = pegasusHome + "/" + PLANNED_CONFIG_FILE;

try

{

cm->mergeConfigFiles(currentFile, plannedFile);

cm->mergeCommandLine(argc, argv);

}

catch (NoSuchFile nsf)

{

throw nsf;

}

catch (FileNotReadable fnr)

{

throw fnr;

}

catch (CannotRenameFile ftrf)

{

throw ftrf;

}

catch (ConfigFileSyntaxError cfse)

{

throw cfse;

}

catch(UnrecognizedConfigProperty ucp)

{

throw ucp;

cm->loadConfigFiles();

}

catch(InvalidPropertyValue ipv)

else

{

throw ipv;

cm->mergeConfigFiles();

}

// Temporarily disable updates to the current configuration

// file if shutdownOption is true

cm->useConfigFiles = (shutdownOption==false);

cm->mergeCommandLine(argc, argv);

// Enable updates again

cm->useConfigFiles = true;

}

/* PrintHelp - This is temporary until we expand the options manager to allow

Line 217

Line 270

void PrintHelp(const char* arg0)

{

/**

Build the usage string for the config command.

String usage = String (USAGE);

usage.append (COMMAND_NAME);

usage.append (" [ [ options ] | [ configProperty=value, ... ] ]\n");

usage.append (" options\n");

usage.append (" -v - displays pegasus version number\n");

usage.append(" -v, --version - displays CIM Server version number\n");

usage.append (" -h - prints this help message\n");

usage.append(" -h, --help - prints this help message\n");

usage.append(" -s - shuts down CIM Server\n");

#if !defined(PEGASUS_USE_RELEASE_DIRS)

usage.append (" -D [home] - sets pegasus home directory\n");

usage.append (" -t - turns tracing on\n");

#endif

usage.append (" -t - turns on trace of client IO to console\n");

#if defined(PEGASUS_OS_TYPE_WINDOWS)

usage.append (" -l - turns on trace of client IO to trace file\n");

usage.append(" -install [name] - installs pegasus as a Windows "

usage.append (" -d - runs pegasus as a daemon\n");

"Service\n");

usage.append (" -s [-f] [-T timeout] \n");

usage.append(" [name] is optional and overrides "

usage.append (" - shuts down pegasus\n");

"the\n");

usage.append (" -cleanlogs - clears the log files at startup\n");

usage.append(" default CIM Server Service Name\n");

usage.append (" -install - installs pegasus as a Windows NT Service\n");

usage.append(" by appending [name]\n");

usage.append (" -remove - removes pegasus as a Windows NT Service\n");

usage.append(" -remove [name] - removes pegasus as a Windows "

usage.append (" -slp - registers pegasus as a service with SLP\n\n");

"Service\n");

usage.append (" -SSL - uses SSL\n\n");

usage.append(" [name] is optional and overrides "

"the\n");

usage.append(" default CIM Server Service Name\n");

usage.append(" by appending [name]\n");

usage.append(" -start [name] - starts pegasus as a Windows Service\n");

usage.append(" [name] is optional and overrides "

"the\n");

usage.append(" default CIM Server Service Name\n");

usage.append(" by appending [name]\n");

usage.append(" -stop [name] - stops pegasus as a Windows Service\n");

usage.append(" [name] is optional and overrides "

"the\n");

usage.append(" default CIM Server Service Name\n");

usage.append(" by appending [name]\n\n");

#endif

usage.append (" configProperty=value\n");

usage.append (" port=nnnn - sets port number to listen on\n");

usage.append(" - sets CIM Server configuration "

usage.append (" home=/pegasus/bin - sets pegasus home directory\n");

"property\n");

usage.append (" logdir=/pegasus/logs - directory for log files\n");

cout << endl;

cout << PEGASUS_NAME << PEGASUS_VERSION << endl;

cout << _cimServerProcess->getProductName() << " " <<

_cimServerProcess->getCompleteVersion() << endl;

cout << endl;

cout << usage << endl;

#if defined(PEGASUS_OS_TYPE_WINDOWS)

MessageLoaderParms parms("src.Server.cimserver.MENU.WINDOWS", usage);

#elif defined(PEGASUS_USE_RELEASE_DIRS)

MessageLoaderParms parms(

"src.Server.cimserver.MENU.HPUXLINUXIA64GNU",

usage);

#else

MessageLoaderParms parms("src.Server.cimserver.MENU.STANDARD", usage);

#endif

cout << MessageLoader::getMessage(parms) << endl;

}

void shutdownCIMOM(Boolean forceOption, String timeoutStr)

// This needs to be called at various points in the code depending on the

// platform and error conditions.

// We need to delete the _cimServer reference on exit in order for the

// destructors to get called.

void deleteCIMServer()

{

delete _cimServer;

// Create CIMClient object

_cimServer = 0;

Monitor* monitor = new Monitor;

HTTPConnector* httpConnector = new HTTPConnector(monitor);

CIMClient client(monitor, httpConnector);

if (dummyInitialThread)

// Get the port number

{

Thread::clearLanguages();

String portNumberStr = configManager->getCurrentValue("port");

delete dummyInitialThread;

}

String hostStr = System::getHostName();

}

hostStr.append(":");

hostStr.append(portNumberStr);

// open connection to CIMOM

// Dummy function for the Thread object associated with the initial thread.

// Since the initial thread is used to process CIM requests, this is

// needed to localize the exceptions thrown during CIM request processing.

// Note: This function should never be called!

try

ThreadReturnType PEGASUS_THREAD_CDECL dummyThreadFunc(void* parm)

{

client.connect(hostStr.allocateCString());

}

catch(Exception& e)

{

PEGASUS_STD(cerr) << "Failed to connect to server: " << e.getMessage() << PEGASUS_STD(endl);

return (ThreadReturnType)0;

exit(1);

}

try

#ifdef PEGASUS_ENABLE_PRIVILEGE_SEPARATION

static int _extractExecutorSockOpt(int& argc, char**& argv)

{

// Extract the "--executor-socket <sock>" option if any. This indicates

// construct CIMReference

// that the e[x]ecutor is running. The option argument is the socket used

// to communicate with the executor. Remove the option from the

String referenceStr = "//";

// argv list and decrease argc by two.

referenceStr.append(hostStr);

referenceStr.append("/root/cimv2:PG_ShutdownService");

CIMReference reference(referenceStr);

int sock = -1;

// issue the invokeMethod request on the shutdown method

const char OPT[] = "--executor-socket";

Array<CIMParamValue> inParams;

Array<CIMParamValue> outParams;

if (forceOption)

for (int i = 1; i < argc; i++)

{

if (strcmp(argv[i], OPT) == 0)

{

inParams.append(CIMParamValue(

// Check for missing option argument.

CIMParameter("force", CIMType::STRING),

CIMValue("TRUE")));

if (i + 1 == argc)

{

MessageLoaderParms parms(

"src.Server.cimserver.MISSING_OPTION_ARGUMENT",

"Missing argument for $0 option.",

OPT);

cerr << argv[0] << ": " << MessageLoader::getMessage(parms) <<

endl;

exit(1);

}

else

// Convert argument to positive integer.

char* end;

unsigned long x = strtoul(argv[i+1], &end, 10);

// Check whether option argument will fit in a signed integer.

if (*end != '\0' || x > 2147483647)

{

inParams.append(CIMParamValue(

MessageLoaderParms parms(

CIMParameter("force", CIMType::STRING),

"src.Server.cimserver.BAD_OPTION_ARGUMENT",

CIMValue("FALSE")));

"Bad $0 option argument: $1.",

OPT,

argv[i+1]);

cerr << argv[0] << ": " << MessageLoader::getMessage(parms) <<

endl;

exit(1);

}

inParams.append(CIMParamValue(

sock = int(x);

CIMParameter("timeout", CIMType::STRING),

CIMValue(timeoutStr)));

// Remove "-x <sock>" from argv-argc.

CIMValue retValue = client.invokeMethod(

memmove(argv + i, argv + i + 2, sizeof(char*) * (argc - i - 1));

NAMESPACE,

argc -= 2;

reference,

break;

"shutdown",

inParams,

outParams);

}

catch(Exception& e)

}

if (sock == -1)

{

PEGASUS_STD(cerr) << "Failed to shutdown server: " << e.getMessage() << PEGASUS_STD(endl);

MessageLoaderParms parms(

"src.Server.cimserver.MISSING_OPTION",

"Missing $0 option.",

OPT);

cerr << argv[0] << ": " << MessageLoader::getMessage(parms) << endl;

exit(1);

}

return;

return sock;

}

#endif /* PEGASUS_ENABLE_PRIVILEGE_SEPARATION */

/////////////////////////////////////////////////////////////////////////

// MAIN

//////////////////////////////////////////////////////////////////////////

int main(int argc, char** argv)

{

String pegasusHome = String::EMPTY;

String pegasusHome;

Boolean pegasusIOTrace = false;

Boolean pegasusIOLog = false;

String portOption = String::EMPTY;

String logsDirectory = String::EMPTY;

Boolean useSLP = false;

Boolean useSSL = false;

Boolean daemonOption = false;

Boolean shutdownOption = false;

Boolean forceOption = false;

Boolean debugOutputOption = false;

Boolean timeoutOption = false;

String timeoutStr = String::EMPTY;

// Set Message loading to process locale

long timeoutValue = 0;

MessageLoader::_useProcessLocale = true;

// on Windows NT if there are no command-line options, run as a service

#ifdef PEGASUS_OS_ZOS

// Direct standard input to /dev/null,

close(STDIN_FILENO);

open("/dev/null", O_RDONLY);

if (argc == 1 )

if ( setEBCDICEncoding(STDOUT_FILENO)==-1 ||

setEBCDICEncoding(STDERR_FILENO)==-1 )

{

cim_server_service(argc, argv);

PEG_TRACE_CSTRING(TRC_SERVER,Tracer::LEVEL4,

"Coud not set stdout or stderr to EBCDIC encoding.");

}

else

// Need to initialize timezone information in the

// initial processing thread (IPT)

tzset();

#endif

#if defined(PEGASUS_OS_AIX) && defined(PEGASUS_HAS_MESSAGES)

setlocale(LC_ALL, "");

#endif

#ifndef PEGASUS_OS_TYPE_WINDOWS

// Get environment variables:

# if defined(PEGASUS_OS_AIX) && defined(PEGASUS_USE_RELEASE_DIRS)

pegasusHome = AIX_RELEASE_PEGASUS_HOME;

# elif defined(PEGASUS_OS_PASE)

const char *tmp = getenv("PEGASUS_HOME");

pegasusHome = (tmp == 0) ? PASE_DEFAULT_PEGASUS_HOME : tmp;

# elif !defined(PEGASUS_USE_RELEASE_DIRS) || \

defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)

const char* tmp = getenv("PEGASUS_HOME");

if (tmp)

{

// Get help, version and home options

pegasusHome = tmp;

}

# endif

FileSystem::translateSlashes(pegasusHome);

#else

// windows only

//setHome(pegasusHome);

pegasusHome = _cimServerProcess->getHome();

#endif

#ifdef PEGASUS_ENABLE_PRIVILEGE_SEPARATION

// If invoked with "--executor-socket <socket>" option, then use executor.

Executor::setSock(_extractExecutorSockOpt(argc, argv));

// Ping executor to verify the specified socket is valid.

if (Executor::ping() != 0)

{

MessageLoaderParms parms("src.Server.cimserver.EXECUTOR_PING_FAILED",

"Failed to ping the executor on the specified socket.");

cerr << argv[0] << ": " << MessageLoader::getMessage(parms) << endl;

exit(1);

}

#endif /* !defined(PEGASUS_ENABLE_PRIVILEGE_SEPARATION) */

// Get help, version, and shutdown options

for (int i = 1; i < argc; )

{

const char* arg = argv[i];

if (String::equal(arg,"--help"))

{

PrintHelp(argv[0]);

exit(0);

}

else if (String::equal(arg,"--version"))

{

cout << _cimServerProcess->getCompleteVersion() << endl;

exit(0);

}

// Check for -option

if (*arg == '-')

else if (*arg == '-')

{

// Get the option

const char* option = arg + 1;

Line 373

Line 527

// Check to see if user asked for the version (-v option):

if (*option == OPTION_VERSION)

if (*option == OPTION_VERSION &&

strlen(option) == 1)

{

cout << PEGASUS_VERSION << endl;

cout << _cimServerProcess->getCompleteVersion() << endl;

exit(0);

}

// Check to see if user asked for help (-h option):

else if (*option == OPTION_HELP)

else if (*option == OPTION_HELP &&

(strlen(option) == 1))

{

PrintHelp(argv[0]);

exit(0);

}

else if (*option == OPTION_HOME)

#if !defined(PEGASUS_USE_RELEASE_DIRS)

else if (*option == OPTION_HOME &&

(strlen(option) == 1))

{

if (i + 1 < argc)

{

pegasusHome.assign(argv[i + 1]);

SetEnvironmentVariables(argv[i + 1]);

}

else

{

cout << "Missing argument for option -" << option << endl;

String opt(option);

MessageLoaderParms parms(

"src.Server.cimserver.MISSING_ARGUMENT",

"Missing argument for option -$0",

opt);

cout << MessageLoader::getMessage(parms) << endl;

exit(0);

}

memmove(&argv[i], &argv[i + 2], (argc-i-1) * sizeof(char*));

argc -= 2;

}

#endif

// Check to see if user asked for debug output (-X option):

else if (*option == OPTION_DEBUGOUTPUT &&

(strlen(option) == 1))

{

MessageLoaderParms parms(

"src.Server.cimserver.UNSUPPORTED_DEBUG_OPTION",

"Unsupported debug output option is enabled.");

cout << MessageLoader::getMessage(parms) << endl;

debugOutputOption = true;

#if defined(PEGASUS_OS_HPUX)

System::bindVerbose = true;

#endif

// remove the option from the command line

memmove(&argv[i], &argv[i + 1], (argc-i) * sizeof(char*));

argc--;

}

// Check to see if user asked for shutdown (-s option):

else if (*option == OPTION_SHUTDOWN)

else if (*option == OPTION_SHUTDOWN &&

(strlen(option) == 1))

{

// Check to see if shutdown has already been specified:

if (shutdownOption)

{

cout << "Duplicate shutdown option specified." << endl;

MessageLoaderParms parms(

"src.Server.cimserver.DUPLICATE_SHUTDOWN_OPTION",

"Duplicate shutdown option specified.");

cout << MessageLoader::getMessage(parms) << endl;

exit(0);

}

shutdownOption = true;

// remove the option from the command line

memmove(&argv[i], &argv[i + 1], (argc-i) * sizeof(char*));

argc--;

}

else if (*option == OPTION_FORCE)

else

{

i++;

}

else

i++;

}

// Set the value for pegasusHome property

ConfigManager::setPegasusHome(pegasusHome);

// Check to see if shutdown has been specified:

// Do the platform specific run

if (!shutdownOption)

return _cimServerProcess->platform_run(

argc, argv, shutdownOption, debugOutputOption);

}

void CIMServerProcess::cimserver_stop()

{

cout << "Invalid option -" << option << endl;

_cimServer->shutdownSignal();

exit(0);

}

// Check to see if force has already been specified:

// The main, common, running code

// NOTE: Do NOT call exit(). Use return(), otherwise some platforms

// will fail to shutdown properly/cleanly.

// TODO: Current change minimal for platform "service" shutdown bug fixes.

// Perhaps further extract out common stuff and put into main(), put

// daemon stuff into platform specific platform_run(), etc.

// Note: make sure to not put error handling stuff that platform

// specific runs may need to deal with better (instead of exit(), etc).

if (forceOption)

int CIMServerProcess::cimserver_run(

int argc,

char** argv,

Boolean shutdownOption,

Boolean debugOutputOption)

{

cout << "Duplicate force option specified." << endl;

Boolean daemonOption = false;

exit(0);

#if defined (PEGASUS_OS_PASE) && !defined (PEGASUS_DEBUG)

// PASE have itself regular for checking privileged user

if (!System::isPrivilegedUser("*CURRENT "))

{

MessageLoaderParms parms(

"src.Server.cimserver.NO_AUTHORITY.PEGASUS_OS_PASE",

"The caller should be a privileged user,"

" or the server will not run.");

cerr << MessageLoader::getMessage(parms) << endl;

exit (1);

}

char jobName[11];

// this function only can be found in PASE environment

umeGetJobName(jobName, false);

if (strncmp("QUMECIMOM ", jobName, 10) != 0

&& strncmp("QUMEENDCIM", jobName, 10) != 0)

{

MessageLoaderParms parms(

"src.Server.cimserver.NOT_OFFICIAL_START.PEGASUS_OS_PASE",

"cimserver can not be started by user.\nServer will not run.");

cerr << MessageLoader::getMessage(parms) << endl;

exit (1);

}

forceOption = true;

// Direct standard input, output, and error to /dev/null,

// PASE run this job in background, any output in not allowed

freopen("/dev/null", "r", stdin);

freopen("/dev/null", "w", stdout);

freopen("/dev/null", "w", stderr);

#endif

// remove the option from the command line

memmove(&argv[i], &argv[i + 1], (argc-i) * sizeof(char*));

argc--;

}

else if (*option == OPTION_TIMEOUT)

{

// Check to see if shutdown has been specified:

// Get an instance of the Config Manager.

if (!shutdownOption)

ConfigManager* configManager = ConfigManager::getInstance();

configManager->useConfigFiles = true;

try

{

cout << "Invalid option -" << option << endl;

exit(0);

// Get options (from command line and from configuration file); this

// removes corresponding options and their arguments from the command

// line. NOTE: If shutdownOption=true, the contents of current config

// file are not overwritten by the planned config file.

GetOptions(configManager, argc, argv, shutdownOption);

// Initialize the message home directory in the MessageLoader.

// This is the default directory where the resource bundles are found.

MessageLoader::setPegasusMsgHome(ConfigManager::getHomedPath(

ConfigManager::getInstance()->getCurrentValue("messageDir")));

#ifdef PEGASUS_OS_PASE

// set ccsid to unicode for entire job

// ccsid is globolization mechanism in PASE environment

if (_SETCCSID(1208) == -1)

{

MessageLoaderParms parms(

"src.Server.cimserver.SET_CCSID_ERROR.PEGASUS_OS_PASE",

"Failed to set CCSID, server will stop.");

cerr << MessageLoader::getMessage(parms) << endl;

Logger::put_l(Logger::ERROR_LOG, System::CIMSERVER, Logger::FATAL,

"src.Server.cimserver.SET_CCSID_ERROR.PEGASUS_OS_PASE",

"Failed to set CCSID, server will stop.\n");

exit (1);

}

if (timeoutOption)

char fullJobName[29];

{

umeGetJobName(fullJobName, true);

cout << "Duplicate timeout option specified." << endl;

Logger::put_l(Logger::STANDARD_LOG, System::CIMSERVER, Logger::INFORMATION,

exit(0);

"src.Server.cimserver.SERVER_JOB_NAME.PEGASUS_OS_PASE",

"CIM Server's Job Name is: $0", fullJobName);

#endif

Boolean enableHttpConnection = ConfigManager::parseBooleanValue(

configManager->getCurrentValue("enableHttpConnection"));

Boolean enableHttpsConnection = ConfigManager::parseBooleanValue(

configManager->getCurrentValue("enableHttpsConnection"));

// Make sure at least one connection is enabled

#ifdef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET

if (!enableHttpConnection && !enableHttpsConnection)

{

//l10n

//Logger::put(Logger::STANDARD_LOG, System::CIMSERVER, Logger::WARNING,

//"Neither HTTP nor HTTPS connection is enabled. "

//"CIMServer will not be started.");

Logger::put_l(Logger::STANDARD_LOG, System::CIMSERVER, Logger::WARNING,

"src.Server.cimserver.HTTP_NOT_ENABLED_SERVER_NOT_STARTING",

"Neither HTTP nor HTTPS connection is enabled."

" CIMServer will not be started.");

//cerr << "Neither HTTP nor HTTPS connection is enabled. "

//"CIMServer will not be started." << endl;

MessageLoaderParms parms(

"src.Server.cimserver.HTTP_NOT_ENABLED_SERVER_NOT_STARTING",

"Neither HTTP nor HTTPS connection is enabled."

" CIMServer will not be started.");

cerr << MessageLoader::getMessage(parms) << endl;

return(1);

}

#endif

// Check to see if we should start Pegasus as a daemon

daemonOption = ConfigManager::parseBooleanValue(

configManager->getCurrentValue("daemon"));

timeoutOption = true;

#if !defined(PEGASUS_USE_SYSLOGS)

String logsDirectory = ConfigManager::getHomedPath(

configManager->getCurrentValue("logdir"));

if (i + 1 < argc)

// Set up the Logger. This does not open the logs.

{

// Might be more logical to clean before set.

// get timeout value

Logger::setHomeDirectory(logsDirectory);

timeoutStr.assign(argv[i + 1]);

// validate timeout value string

# ifdef PEGASUS_OS_PASE

char* tmp = timeoutStr.allocateCString();

/* write job log to tell where pegasus log is.*/

char* end = 0;

if(logsDirectory.size() > 0)

timeoutValue = strtol(tmp, &end, 10);

// this function only can be found in PASE environment

logPegasusDir2joblog(logsDirectory.getCString());

else

logPegasusDir2joblog(".");

# endif

#endif

if (!end || *end != '\0')

// Check to see if we need to shutdown CIMOM

if (shutdownOption)

{

cout << "invalid timeout value specified: ";

String configTimeout =

cout << timeoutStr << endl;

configManager->getCurrentValue("shutdownTimeout");

delete [] tmp;

Uint32 timeoutValue =

exit(0);

strtol(configTimeout.getCString(), (char **)0, 10);

ServerShutdownClient serverShutdownClient(&_serverRunStatus);

serverShutdownClient.shutdown(timeoutValue);

MessageLoaderParms parms(

"src.Server.cimserver.SERVER_STOPPED",

"CIM Server stopped.");

cout << MessageLoader::getMessage(parms) << endl;

return 0;

}

#if defined(PEGASUS_DEBUG) && !defined(PEGASUS_USE_SYSLOGS)

// Leave this in until people get familiar with the logs.

MessageLoaderParms parms("src.Server.cimserver.LOGS_DIRECTORY",

"Logs Directory = ");

cout << MessageLoader::getMessage(parms) << logsDirectory << endl;

#endif

}

else

catch (Exception& e)

{

cout << "Missing argument for option -";

MessageLoaderParms parms("src.Server.cimserver.SERVER_NOT_STARTED",

cout << option << endl;

"cimserver not started: $0", e.getMessage());

exit(0);

Logger::put(Logger::ERROR_LOG, System::CIMSERVER, Logger::SEVERE,

MessageLoader::getMessage(parms));

cerr << MessageLoader::getMessage(parms) << endl;

return 1;

}

// remove the option from the command line

#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM) && defined(PEGASUS_ZOS_SECURITY)

memmove(&argv[i], &argv[i + 2], (argc-i-1) * sizeof(char*));

startupCheckBPXServer(true);

argc -= 2;

startupCheckProfileCIMSERVclassWBEM();

}

startupEnableMSC();

else

#endif

i++;

}

else

i++;

}

if (pegasusHome.size() == 0)

#if defined(PEGASUS_DEBUG)

GetEnvironmentVariables(argv[0], pegasusHome);

// Put out startup up message.

cout << _cimServerProcess->getProductName() << " " <<

_cimServerProcess->getCompleteVersion() << endl;

#endif

// reset message loading to NON-process locale

// Get an instance of the Config Manager.

MessageLoader::_useProcessLocale = false;

configManager = ConfigManager::getInstance();

// Get the parent's PID before forking

// Get options (from command line and from configuration file); this

_serverRunStatus.setParentPid(System::getPID());

// removes corresponding options and their arguments from the command

// line.

// Do not fork when using privilege separation (executor will daemonize

// itself later).

if (daemonOption)

{

if (-1 == _cimServerProcess->cimserver_fork())

return -1;

}

// Now we are after the fork...

// Create a dummy Thread object that can be used to store the

// AcceptLanguageList object for CIM requests that are serviced

// by this thread (initial thread of server). Need to do this

// because this thread is not in a ThreadPool, but is used

// to service CIM requests.

// The run function for the dummy Thread should never be called,

dummyInitialThread = new Thread(dummyThreadFunc, NULL, false);

Thread::setCurrent(dummyInitialThread);

AcceptLanguageList default_al;

try

{

GetOptions(configManager, argc, argv, pegasusHome);

default_al = LanguageParser::getDefaultAcceptLanguages();

Thread::setLanguages(new AcceptLanguageList(default_al));

}

catch (Exception& e)

catch (InvalidAcceptLanguageHeader& e)

{

cerr << argv[0] << ": " << e.getMessage() << endl;

Logger::put_l(Logger::ERROR_LOG, System::CIMSERVER, Logger::SEVERE,

exit(1);

"src.Server.cimserver.FAILED_TO_SET_PROCESS_LOCALE",

"Could not convert the system process locale into a valid "

"AcceptLanguage format.");

Logger::put(Logger::ERROR_LOG, System::CIMSERVER, Logger::SEVERE,

e.getMessage());

}

#ifndef PEGASUS_OS_TYPE_WINDOWS

umask(S_IRWXG|S_IRWXO);

#endif

// Start up the CIM Server

try

{

#if defined(PEGASUS_OS_TYPE_UNIX)

// Check to see if we should (can) install as a NT service

// Lock the CIMSERVER_LOCK_FILE during CIM Server start-up to prevent

// concurrent writes to this file by multiple cimserver processes

// starting at the same time.

CString startupLockFileName = ConfigManager::getHomedPath(

PEGASUS_CIMSERVER_START_LOCK_FILE).getCString();

if (String::equal(configManager->getCurrentValue("install"), "true"))

// Make sure the start-up lock file exists

{

FILE* startupLockFile;

if( 0 != cimserver_install_nt_service( pegasusHome ))

if ((startupLockFile = fopen(startupLockFileName, "w")) != 0)

{

cout << "\nPegasus installed as NT Service";

fclose(startupLockFile);

exit(0);

}

AutoFileLock fileLock(startupLockFileName);

#endif

#if defined(PEGASUS_OS_TYPE_UNIX) || defined(PEGASUS_OS_VMS)

// Check to see if we should (can) remove Pegasus as an NT service

// Check if a CIM Server is already running. If so, print an error

// message and notify the parent process (if there is one) to terminate

if (_serverRunStatus.isServerRunning())

if (String::equal(configManager->getCurrentValue("remove"), "true"))

{

if( 0 != cimserver_remove_nt_service() )

MessageLoaderParms parms(

"src.Server.cimserver.UNABLE_TO_START_SERVER_ALREADY_RUNNING",

"Unable to start CIMServer. CIMServer is already running.");

Logger::put(

Logger::ERROR_LOG, System::CIMSERVER, Logger::INFORMATION,

MessageLoader::getMessage(parms));

cerr << MessageLoader::getMessage(parms) << endl;

if (daemonOption)

{

cout << "\nPegasus removed as NT Service";

_cimServerProcess->notify_parent(1);

exit(0);

}

return 1;

}

// Check to see if we should Pegasus as a daemon

// Declare ourselves as the running CIM Server process, and write our

// PID to the PID file.

_serverRunStatus.setServerRunning();

#endif

if (String::equal(configManager->getCurrentValue("daemon"), "true"))

// Create and initialize the CIMServer object

_cimServer = new CIMServer();

Boolean enableHttpConnection = ConfigManager::parseBooleanValue(

configManager->getCurrentValue("enableHttpConnection"));

Boolean enableHttpsConnection = ConfigManager::parseBooleanValue(

configManager->getCurrentValue("enableHttpsConnection"));

#ifdef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET

// Make sure at least one connection is enabled

if (!enableHttpConnection && !enableHttpsConnection)

{

MessageLoaderParms parms(

"src.Server.cimserver.HTTP_NOT_ENABLED_SERVER_NOT_STARTING",

"Neither HTTP nor HTTPS connection is enabled.");

throw Exception(parms);

}

#endif

Boolean addIP6Acceptor = false;

Boolean addIP4Acceptor = false;

#ifdef PEGASUS_OS_TYPE_WINDOWS

addIP4Acceptor = true;

#endif

#ifdef PEGASUS_ENABLE_IPV6

// If IPv6 stack is disabled swicth to IPv4 stack.

if (System::isIPv6StackActive())

{

addIP6Acceptor = true;

}

else

{

MessageLoaderParms parms(

"src.Server.cimserver.IPV6_STACK_NOT_ACTIVE",

"IPv6 stack is not active, using IPv4 socket.");

Logger::put(

Logger::STANDARD_LOG, System::CIMSERVER, Logger::INFORMATION,

MessageLoader::getMessage(parms));

#if defined(PEGASUS_DEBUG)

cout << MessageLoader::getMessage(parms) << endl;

#endif

}

#endif

if (!addIP6Acceptor)

{

daemonOption = true;

addIP4Acceptor = true;

}

// The server HTTP and HTTPS ports are determined via this algorithm:

// 1) If the user explicitly specified a port, use it.

// 2) If the user did not specify a port, get the port from the

// services file.

// 3) If no value is specified in the services file, use the IANA WBEM

// default port.

// Note that 2 and 3 are done within the System::lookupPort method

// An empty string from the ConfigManager implies that the user did not

// specify a port.

if (enableHttpConnection)

{

Uint32 portNumberHttp = 0;

String httpPort = configManager->getCurrentValue("httpPort");

if (httpPort == String::EMPTY)

{

// Check to see if we need to shutdown CIMOM

// Look up the WBEM-HTTP port number

if (shutdownOption)

portNumberHttp = System::lookupPort(

WBEM_HTTP_SERVICE_NAME, WBEM_DEFAULT_HTTP_PORT);

}

else

{

// if timeout was specified, validate the timeout value

// user-specified

if (timeoutOption)

CString portString = httpPort.getCString();

char* end = 0;

portNumberHttp = strtol(portString, &end, 10);

if (!(end != 0 && *end == '\0'))

{

Boolean valid = configManager->validatePropertyValue(

throw InvalidPropertyValue("httpPort", httpPort);

PROPERTY_TIMEOUT,

}

timeoutStr);

}

if (!valid)

if (addIP6Acceptor)

{

cout << "Invalid timeout value specified: " << timeoutValue;

_cimServer->addAcceptor(HTTPAcceptor::IPV6_CONNECTION,

cout << endl;

portNumberHttp, false);

exit(1);

}

if (addIP4Acceptor)

{

_cimServer->addAcceptor(HTTPAcceptor::IPV4_CONNECTION,

portNumberHttp, false);

}

shutdownCIMOM(forceOption, timeoutStr);

MessageLoaderParms parms(

cout << "Pegasus CIM Server terminated." << endl;

"src.Server.cimserver.LISTENING_ON_HTTP_PORT",

exit(0);

"Listening on HTTP port $0.", portNumberHttp);

Logger::put(

Logger::STANDARD_LOG, System::CIMSERVER, Logger::INFORMATION,

MessageLoader::getMessage(parms));

#if defined(PEGASUS_DEBUG)

cout << MessageLoader::getMessage(parms) << endl;

#endif

}

if (enableHttpsConnection)

{

Uint32 portNumberHttps = 0;

String httpsPort = configManager->getCurrentValue("httpsPort");

if (httpsPort == String::EMPTY)

{

// Grab the port option:

// Look up the WBEM-HTTPS port number

portNumberHttps = System::lookupPort(

portOption = configManager->getCurrentValue("port");

WBEM_HTTPS_SERVICE_NAME, WBEM_DEFAULT_HTTPS_PORT);

}

else

{

// Check the trace options and set global variable

// user-specified

CString portString = httpsPort.getCString();

if (String::equal(configManager->getCurrentValue("trace"), "true"))

char* end = 0;

portNumberHttps = strtol(portString, &end, 10);

if (!(end != 0 && *end == '\0'))

{

Handler::setMessageTrace(true);

throw InvalidPropertyValue("httpsPort", httpsPort);

pegasusIOTrace = true;

cout << "Trace Set" << endl;

}

// Check the log trace options and set global variable

if (addIP6Acceptor)

if (String::equal(configManager->getCurrentValue("logtrace"), "true"))

{

Handler::setMessageLogTrace(true);

_cimServer->addAcceptor(HTTPAcceptor::IPV6_CONNECTION,

pegasusIOLog = true;

portNumberHttps, true);

}

if (addIP4Acceptor)

{

_cimServer->addAcceptor(HTTPAcceptor::IPV4_CONNECTION,

portNumberHttps, true);

}

MessageLoaderParms parms(

"src.Server.cimserver.LISTENING_ON_HTTPS_PORT",

"Listening on HTTPS port $0.", portNumberHttps);

Logger::put(

Logger::STANDARD_LOG, System::CIMSERVER, Logger::INFORMATION,

MessageLoader::getMessage(parms));

#if defined(PEGASUS_DEBUG)

cout << MessageLoader::getMessage(parms) << endl;

#endif

}

// Get the log file directory definition.

#ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET

// We put String into Cstring because

// Directory functions only handle Cstring.

// ATTN-KS: create String based directory functions.

logsDirectory = configManager->getCurrentValue("logdir");

// Set up the Logger. This does not open the logs

// Might be more logical to clean before set.

// ATTN: Need tool to completely disable logging.

Logger::setHomeDirectory(logsDirectory);

if (String::equal(configManager->getCurrentValue("cleanlogs"), "true"))

{

Logger::clean(logsDirectory);;

_cimServer->addAcceptor(HTTPAcceptor::LOCAL_CONNECTION, 0, false);

MessageLoaderParms parms(

"src.Server.cimserver.LISTENING_ON_LOCAL",

"Listening on local connection socket.");

Logger::put(

Logger::STANDARD_LOG, System::CIMSERVER, Logger::INFORMATION,

MessageLoader::getMessage(parms));

# if defined(PEGASUS_DEBUG)

cout << MessageLoader::getMessage(parms) << endl;

# endif

}

#endif

// Leave this in until people get familiar with the logs.

_cimServer->bind();

cout << "Logs Directory = " << logsDirectory << endl;

if (String::equal(configManager->getCurrentValue("slp"), "true"))

// notify parent process (if there is a parent process) to terminate

// so user knows that there is cimserver ready to serve CIM requests.

if (daemonOption)

{

useSLP = true;

_cimServerProcess->notify_parent(0);

}

if (String::equal(configManager->getCurrentValue("SSL"), "true"))

#if defined(PEGASUS_DEBUG)

{

cout << "Started. " << endl;

useSSL = true;

#endif

// Put server started message to the logger

Logger::put_l(Logger::STANDARD_LOG, System::CIMSERVER,

Logger::INFORMATION,

"src.Server.cimserver.STARTED_VERSION",

"Started $0 version $1.",

_cimServerProcess->getProductName(),

_cimServerProcess->getCompleteVersion());

#if defined(PEGASUS_OS_TYPE_UNIX) && !defined(PEGASUS_OS_ZOS)

if (daemonOption && !debugOutputOption)

{

// Direct standard input, output, and error to /dev/null,

// since we are running as a daemon.

close(STDIN_FILENO);

open("/dev/null", O_RDONLY);

close(STDOUT_FILENO);

open("/dev/null", O_RDWR);

close(STDERR_FILENO);

open("/dev/null", O_RDWR);

}

#endif

}

catch (UnrecognizedConfigProperty e)

catch (Exception& e)

{

cout << "Error: " << e.getMessage() << endl;

MessageLoaderParms parms("src.Server.cimserver.SERVER_NOT_STARTED",

}

"cimserver not started: $0", e.getMessage());

Logger::put(Logger::ERROR_LOG, System::CIMSERVER, Logger::SEVERE,

char* address = portOption.allocateCString();

MessageLoader::getMessage(parms));

cerr << MessageLoader::getMessage(parms) << endl;

// Put out startup up message.

cout << PEGASUS_NAME << PEGASUS_VERSION <<

" on port " << address << endl;

cout << "Built " << __DATE__ << " " << __TIME__ << endl;

cout <<"Started..."

<< (pegasusIOTrace ? " Tracing to Display ": " ")

<< (pegasusIOLog ? " Tracing to Log ": " ")

<< (useSLP ? " SLP reg. " : " No SLP ")

<< (useSSL ? " Use SSL " : " No SSL ")

<< endl;

// Put server start message to the logger

Logger::put(Logger::STANDARD_LOG, "CIMServer", Logger::INFORMATION,

"Start $0 $1 port $2 $3 $4 $5",

PEGASUS_NAME,

PEGASUS_VERSION,

address,

(pegasusIOTrace ? " Tracing": " "),

(useSLP ? " SLP on " : " SLP off "),

(useSSL ? " Use SSL " : " No SSL "));

// do we need to run as a daemon ?

// notify parent process (if there is a parent process) to terminate

if (daemonOption)

{

_cimServerProcess->notify_parent(1);

if(-1 == cimserver_fork())

exit(-1);

deleteCIMServer();

return 1;

}

// try loop to bind the address, and run the server

// Run the main CIM Server loop

try

{

#ifndef PEGASUS_OS_ZOS

#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)

slp_client *discovery = new slp_client() ;;

String serviceURL;

serviceURL.assign("service:cim.pegasus://");

String host_name = slp_get_host_name();

serviceURL += host_name;

serviceURL += ":";

serviceURL += address;

char *url = serviceURL.allocateCString();

// free(host_name);

#endif

Monitor monitor;

CIMServer server(&monitor, pegasusHome, useSSL);

// bind throws an exception of the bind fails

// ARM is a z/OS internal restart facility.

cout << "Binding to " << address << endl;

// This is a z/OS specific change.

char* end = 0;

// Instatiating the automatic restart manager for zOS

long portNumber = strtol(address, &end, 10);

ARM_zOS automaticRestartManager;

assert(end != 0 && *end == '\0');

server.bind(portNumber);

delete [] address;

// register to zOS ARM

automaticRestartManager.Register();

time_t last = 0;

#endif

// Loop to call CIMServer's runForever() method until CIMServer

// has been shutdown

while( !server.terminated() )

while (!_cimServer->terminated())

{

#ifndef PEGASUS_OS_ZOS

if(useSLP )

{

if( (time(NULL) - last ) > 60 )

{

if( discovery != NULL && url != NULL )

_cimServer->runForever();

discovery->srv_reg_all(url,

"(namespace=root/cimv2)",

"service:cim.pegasus",

"DEFAULT",

70) ;

time(&last);

}

discovery->service_listener();

}

// normal termination

#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)

// ARM is a z/OS internal restart facility.

// This is a z/OS specific change.

// register to zOS ARM

automaticRestartManager.DeRegister();

#endif

server.runForever();

}

// This statement is unrechable!

// Put server shutdown message to the logger

Logger::put_l(Logger::STANDARD_LOG, System::CIMSERVER,

// Logger::put(Logger::STANDARD_LOG, "CIMServer", Logger::INFORMATION,

Logger::INFORMATION, "src.Server.cimserver.STOPPED",

// "Normal Termination");

"$0 stopped.", _cimServerProcess->getProductName());

}

catch(Exception& e)

{

Logger::put(Logger::STANDARD_LOG, "CIMServer", Logger::INFORMATION,

MessageLoaderParms parms(

"Abnormal Termination $0", e.getMessage());

"src.Server.cimserver.ERROR",

"Error: $0",

e.getMessage());

Logger::put(Logger::STANDARD_LOG, System::CIMSERVER, Logger::WARNING,

MessageLoader::getMessage(parms));

cerr << MessageLoader::getMessage(parms) << endl;

PEGASUS_STD(cerr) << "Error: " << e.getMessage() << PEGASUS_STD(endl);

deleteCIMServer();

return 1;

}

deleteCIMServer();

return 0;

}

Legend:

Removed from v.1.35
changed lines
	Added in v.1.213

No CVS admin address has been configured