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.57 and 1.210

version 1.57, 2002/06/01 00:25:05

version 1.210, 2007/09/03 04:41:01

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)

// Modified By: Sushma Fernandes (sushma_fernandes@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, use the -d option:

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

// cimserver -d

// cimserver

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

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

// property to false:

// cimserver daemon=false

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

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

// cimserver -s [-t timeout_value]

// cimserver -s

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

Line 62

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 <Pegasus/suballoc/suballoc.h>

#include <Pegasus/Common/Constants.h>

#include <iostream>

#include <Pegasus/Common/PegasusAssert.h>

#include <cassert>

#include <cstdlib>

#include <fstream>

#include <Pegasus/Common/FileSystem.h>

#include <Pegasus/Common/Monitor.h>

#include <Pegasus/Server/CIMServer.h>

#include <Pegasus/Common/PegasusVersion.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/Server/ShutdownService.h>

#include <Pegasus/Server/CIMServer.h>

#include <Pegasus/Common/Destroyer.h>

#include <Service/ServerProcess.h>

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

#include <Service/ServerShutdownClient.h>

#include <slp/slp.h>

#include <Service/ServerRunStatus.h>

#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)

#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 129

Line 225

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";

#if defined(PEGASUS_OS_HPUX)

static const char OPTION_DEBUGOUTPUT = 'X';

static const char OPTION_BINDVERBOSE = 'X';

#endif

static const String NAMESPACE = "root/PG_Internal";

static const String CLASSNAME_SHUTDOWNSERVICE = "PG_ShutdownService";

static const String PROPERTY_TIMEOUT = "shutdownTimeout";

static const String CIMSERVERSTART_FILE = "/etc/wbem/cimserver_start.conf";

ConfigManager* configManager;

/** 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)

{

try

if (shutdownOption)

{

cm->mergeConfigFiles();

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 191

Line 269

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 (" -d - runs pegasus as a daemon\n");

#endif

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

#if defined(PEGASUS_OS_TYPE_WINDOWS)

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

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

#if !defined(PEGASUS_OS_HPUX)

"Service\n");

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

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

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

"the\n");

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

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

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

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

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

usage.append(" -remove [name] - removes 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(" -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 (" logdir=/pegasus/logs - directory for log files\n");

"property\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(Uint32 timeoutValue)

// 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;

CIMClient client;

// Get local host name

String hostStr = System::getHostName();

if (dummyInitialThread)

// open connection to CIMOM

try

{

client.connectLocal();

Thread::clearLanguages();

delete dummyInitialThread;

}

// set client timeout to 2 seconds more than the shutdown timeout

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

// so that the command client does not timeout before the cimserver

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

// terminates

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

// Note: This function should never be called!

Uint32 clientTimeout;

ThreadReturnType PEGASUS_THREAD_CDECL dummyThreadFunc(void* parm)

if (timeoutValue == 0)

{

String configTimeout =

return (ThreadReturnType)0;

configManager->getCurrentValue("shutdownTimeout");

ArrayDestroyer<char> timeoutCString(configTimeout.allocateCString());

clientTimeout =

((strtol(timeoutCString.getPointer(), (char **)0,10))+2)*1000;

}

else

#ifdef PEGASUS_ENABLE_PRIVILEGE_SEPARATION

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

{

clientTimeout = (timeoutValue + 2)*1000;

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

}

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

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

// argv list and decrease argc by two.

client.setTimeOut(clientTimeout);

int sock = -1;

}

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

catch(CIMClientException& e)

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

{

PEGASUS_STD(cerr) << "Unable to connect to CIM Server." << PEGASUS_STD(endl);

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

PEGASUS_STD(cerr) << "CIM Server may not be running." << PEGASUS_STD(endl);

{

exit(0);

// Check for missing option argument.

}

try

if (i + 1 == argc)

{

MessageLoaderParms parms(

// construct CIMObjectPath

"src.Server.cimserver.MISSING_OPTION_ARGUMENT",

"Missing argument for $0 option.",

String referenceStr = "//";

OPT);

referenceStr.append(hostStr);

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

referenceStr.append(PEGASUS_NAMESPACENAME_CIMV2);

endl;

referenceStr.append(":");

exit(1);

referenceStr.append(PEGASUS_CLASSNAME_SHUTDOWN);

}

CIMObjectPath reference(referenceStr);

// Convert argument to positive integer.

// issue the invokeMethod request on the shutdown method

Array<CIMParamValue> inParams;

Array<CIMParamValue> outParams;

// set force option to true for now

char* end;

inParams.append(CIMParamValue("force",

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

CIMValue(Boolean(true))));

inParams.append(CIMParamValue("timeout",

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

CIMValue(Uint32(timeoutValue))));

CIMValue retValue = client.invokeMethod(

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

NAMESPACE,

reference,

"shutdown",

inParams,

outParams);

}

catch(CIMClientCIMException& e)

{

PEGASUS_STD(cerr) << "Failed to shutdown server: ";

MessageLoaderParms parms(

PEGASUS_STD(cerr) << e.getMessage() << PEGASUS_STD(endl);

"src.Server.cimserver.BAD_OPTION_ARGUMENT",

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

OPT,

argv[i+1]);

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

endl;

exit(1);

}

catch(CIMClientException& e)

{

sock = int(x);

// This may mean the CIM Server has been terminated and returns a

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

// "Empty HTTP response message" HTTP error response. To be sure

// CIM Server gets shutdown, if CIM Server is still running at

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

// this time, we will kill the cimserver process.

argc -= 2;

break;

// give CIM Server some time to finish up

System::sleep(1);

cimserver_kill();

}

catch(Exception& e)

}

if (sock == -1)

{

PEGASUS_STD(cerr) << "Error occurred while stopping the CIM Server: ";

MessageLoaderParms parms(

PEGASUS_STD(cerr) << e.getMessage() << PEGASUS_STD(endl);

"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 pegasusIOLog = false;

String httpPort = String::EMPTY;

String httpsPort = String::EMPTY;

String logsDirectory = String::EMPTY;

Boolean useSLP = false;

Boolean useSSL = false;

Boolean daemonOption = false;

Boolean shutdownOption = false;

Boolean timeoutOption = false;

Boolean debugOutputOption = false;

String timeoutStr = String::EMPTY;

long timeoutValue = 0;

// Set Message loading to process locale

MessageLoader::_useProcessLocale = true;

#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)

{

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));

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

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

if (argc == 1 )

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

{

cim_server_service(argc, argv);

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);

}

else

{

#endif /* !defined(PEGASUS_ENABLE_PRIVILEGE_SEPARATION) */

// Get help, version and home options

// 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 383

Line 510

// 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)

{

Line 404

Line 535

}

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;

}

#if defined(PEGASUS_OS_HPUX)

#endif

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

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

if (*option == OPTION_BINDVERBOSE)

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;

cout << "Unsupported debug option, BIND_VERBOSE, enabled."

#endif

<< endl;

// remove the option from the command line

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

argc--;

}

#endif

// 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 user is root

if (!System::isPrivilegedUser(System::getEffectiveUserName()))

{

cout << "You must have superuser privilege to run ";

cout << "cimserver." << endl;

exit(0);

}

// 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);

}

Line 456

Line 594

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

argc--;

}

else if (*option == OPTION_TIMEOUT)

{

// Check to see if shutdown has been specified:

if (!shutdownOption)

{

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

exit(0);

}

if (timeoutOption)

{

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

exit(0);

}

timeoutOption = true;

if (i + 1 < argc)

{

// get timeout value

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

// validate timeout value string

char* tmp = timeoutStr.allocateCString();

char* end = 0;

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

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

{

cout << "invalid timeout value specified: ";

cout << timeoutStr << endl;

delete [] tmp;

exit(0);

}

else

{

cout << "Missing argument for option -";

cout << option << endl;

exit(0);

}

// remove the option from the command line

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

argc -= 2;

}

else

i++;

}

else

i++;

}

// Set the value for pegasusHome property

Line 518

Line 607

ConfigManager::setPegasusHome(pegasusHome);

// Get an instance of the Config Manager.

// Do the platform specific run

configManager = ConfigManager::getInstance();

return _cimServerProcess->platform_run(

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

argc, argv, shutdownOption, debugOutputOption);

// removes corresponding options and their arguments from the command

// line.

try

{

GetOptions(configManager, argc, argv, pegasusHome);

}

catch (Exception& e)

void CIMServerProcess::cimserver_stop()

{

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

_cimServer->shutdownSignal();

exit(1);

}

try

{

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

// 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 (String::equal(configManager->getCurrentValue("install"), "true"))

int CIMServerProcess::cimserver_run(

{

int argc,

if( 0 != cimserver_install_nt_service( pegasusHome ))

char** argv,

Boolean shutdownOption,

Boolean debugOutputOption)

{

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

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);

}

// 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

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

// Get an instance of the Config Manager.

ConfigManager* configManager = ConfigManager::getInstance();

configManager->useConfigFiles = true;

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

try

{

if( 0 != cimserver_remove_nt_service() )

{

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

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);

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

// 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 (String::equal(configManager->getCurrentValue("daemon"), "true"))

char fullJobName[29];

{

umeGetJobName(fullJobName, true);

daemonOption = true;

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

"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"));

#if !defined(PEGASUS_USE_SYSLOGS)

String logsDirectory = ConfigManager::getHomedPath(

configManager->getCurrentValue("logdir"));

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

// Might be more logical to clean before set.

Logger::setHomeDirectory(logsDirectory);

# ifdef PEGASUS_OS_PASE

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

if(logsDirectory.size() > 0)

// this function only can be found in PASE environment

logPegasusDir2joblog(logsDirectory.getCString());

else

logPegasusDir2joblog(".");

# endif

#endif

// Check the log trace options and set global variable

// Check to see if we need to shutdown CIMOM

if (shutdownOption)

{

String configTimeout =

configManager->getCurrentValue("shutdownTimeout");

Uint32 timeoutValue =

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

#ifdef PEGASUS_SLP_REG_TIMEOUT

// To deregister Pegasus with SLP

unregisterPegasusFromSLP();

#endif

ServerShutdownClient serverShutdownClient(&_serverRunStatus);

serverShutdownClient.shutdown(timeoutValue);

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

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

}

catch (Exception& e)

{

pegasusIOLog = true;

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

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

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

MessageLoader::getMessage(parms));

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

return 1;

}

// Get the log file directory definition.

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

// We put String into Cstring because

startupCheckBPXServer(true);

// Directory functions only handle Cstring.

startupCheckProfileCIMSERVclassWBEM();

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

startupEnableMSC();

#endif

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

#if defined(PEGASUS_DEBUG)

logsDirectory =

// Put out startup up message.

ConfigManager::getHomedPath(configManager->getCurrentValue("logdir"));

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

_cimServerProcess->getCompleteVersion() << endl;

#endif

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

// reset message loading to NON-process locale

// Might be more logical to clean before set.

MessageLoader::_useProcessLocale = false;

// ATTN: Need tool to completely disable logging.

#ifndef PEGASUS_OS_HPUX

// Get the parent's PID before forking

Logger::setHomeDirectory(logsDirectory);

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

// 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

{

default_al = LanguageParser::getDefaultAcceptLanguages();

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

}

catch (InvalidAcceptLanguageHeader& e)

{

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

"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 need to shutdown CIMOM

// 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.

if (shutdownOption)

CString startupLockFileName = ConfigManager::getHomedPath(

PEGASUS_CIMSERVER_START_LOCK_FILE).getCString();

// Make sure the start-up lock file exists

FILE* startupLockFile;

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

{

fclose(startupLockFile);

}

AutoFileLock fileLock(startupLockFileName);

#endif

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

// if timeout was specified, validate the timeout value

// 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 (timeoutOption)

if (_serverRunStatus.isServerRunning())

{

Boolean valid = configManager->validatePropertyValue(

MessageLoaderParms parms(

PROPERTY_TIMEOUT,

"src.Server.cimserver.UNABLE_TO_START_SERVER_ALREADY_RUNNING",

timeoutStr);

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

if (!valid)

Logger::put(

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

MessageLoader::getMessage(parms));

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

if (daemonOption)

{

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

_cimServerProcess->notify_parent(1);

cout << endl;

exit(1);

}

shutdownCIMOM(timeoutValue);

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

return 1;

exit(0);

}

// Get the port numbers

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

// PID to the PID file.

_serverRunStatus.setServerRunning();

#endif

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

// Create and initialize the CIMServer object

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

_cimServer = new CIMServer();

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

Boolean enableHttpConnection = ConfigManager::parseBooleanValue(

#ifndef PEGASUS_OS_HPUX

configManager->getCurrentValue("enableHttpConnection"));

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

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

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

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())

{

Logger::clean(logsDirectory);;

addIP6Acceptor = true;

}

else

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

{

useSLP = true;

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 (String::equal(configManager->getCurrentValue("SSL"), "true"))

if (!addIP6Acceptor)

{

useSSL = 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)

{

// Look up the WBEM-HTTP port number

portNumberHttp = System::lookupPort(

WBEM_HTTP_SERVICE_NAME, WBEM_DEFAULT_HTTP_PORT);

}

catch (UnrecognizedConfigProperty e)

else

{

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

// user-specified

CString portString = httpPort.getCString();

char* end = 0;

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

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

{

throw InvalidPropertyValue("httpPort", httpPort);

}

Uint32 portNumber;

if (addIP6Acceptor)

{

_cimServer->addAcceptor(HTTPAcceptor::IPV6_CONNECTION,

portNumberHttp, false);

}

if (addIP4Acceptor)

{

_cimServer->addAcceptor(HTTPAcceptor::IPV4_CONNECTION,

portNumberHttp, false);

}

char address[32];

MessageLoaderParms parms(

"src.Server.cimserver.LISTENING_ON_HTTP_PORT",

"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 (useSSL)

if (enableHttpsConnection)

{

Uint32 portNumberHttps = 0;

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

if (httpsPort == String::EMPTY)

{

char* p = httpsPort.allocateCString();

char* end = 0;

Uint32 port = strtol(p, &end, 10);

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

delete [] p;

// Look up the WBEM-HTTPS port number

portNumber = System::lookupPort(WBEM_HTTPS_SERVICE_NAME, port);

portNumberHttps = System::lookupPort(

sprintf(address, "%u", portNumber);

WBEM_HTTPS_SERVICE_NAME, WBEM_DEFAULT_HTTPS_PORT);

}

else

{

char* p = httpPort.allocateCString();

char* end = 0;

Uint32 port = strtol(p, &end, 10);

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

delete [] p;

// Look up the WBEM-HTTP port number

// user-specified

portNumber = System::lookupPort(WBEM_HTTP_SERVICE_NAME, port);

CString portString = httpsPort.getCString();

sprintf(address, "%u", portNumber);

char* end = 0;

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

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

{

throw InvalidPropertyValue("httpsPort", httpsPort);

}

if (addIP6Acceptor)

{

_cimServer->addAcceptor(HTTPAcceptor::IPV6_CONNECTION,

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

}

// Put out startup up message.

#ifndef PEGASUS_DISABLE_LOCAL_DOMAIN_SOCKET

cout << PEGASUS_NAME << PEGASUS_VERSION <<

" on port " << address << endl;

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

cout <<"Starting..."

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

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

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

<< endl;

// do we need to run as a daemon ?

if (daemonOption)

{

if(-1 == cimserver_fork())

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

exit(-1);

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

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

_cimServer->bind();

try

// 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)

{

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

#if defined(PEGASUS_ENABLE_PRIVILEGE_SEPARATION)

slp_client *discovery = new slp_client() ;;

Executor::daemonizeExecutor();

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, useSSL);

// bind throws an exception if the bind fails

#ifdef PEGASUS_LOCAL_DOMAIN_SOCKET

cout << "Binding to domain socket" << endl;

#else

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

_cimServerProcess->notify_parent(0);

#endif

}

server.bind(portNumber);

#if defined(PEGASUS_DEBUG)

cout << "Started. " << endl;

#endif

time_t last = 0;

// 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(0);

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

close(1);

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

close(2);

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

}

#endif

}

catch (Exception& e)

{

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

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

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

MessageLoader::getMessage(parms));

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

#if defined(PEGASUS_OS_HPUX)

// create a file to indicate that the cimserver has started and

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

// save the process id of the cimserver process in the file

if (daemonOption)

_cimServerProcess->notify_parent(1);

deleteCIMServer();

return 1;

}

// remove the old file if it exists

// Run the main CIM Server loop

System::removeFile(fname);

// open the file

try

FILE *pid_file = fopen(fname, "w");

if (pid_file)

{

// save the pid in the file

#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)

fprintf(pid_file, "%ld\n", (long)server_pid);

fclose(pid_file);

}

#endif

cout << "Started. " << endl;

// Put server started message to the logger

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

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

// This is a z/OS specific change.

"Started $0 version $1 on port $2.",

PEGASUS_NAME, PEGASUS_VERSION, address);

// Instatiating the automatic restart manager for zOS

ARM_zOS automaticRestartManager;

// register to zOS ARM

automaticRestartManager.Register();

#endif

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

// has been shutdown

while( !server.terminated() )

while (!_cimServer->terminated())

{

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

_cimServer->runForever();

if(useSLP )

{

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

{

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

discovery->srv_reg_all(url,

"(namespace=root/cimv2)",

"service:cim.pegasus",

"DEFAULT",

70) ;

time(&last);

}

discovery->service_listener();

}

#endif

server.runForever();

}

// normal termination

// Put server shutdown message to the logger

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

"$0 stopped.", PEGASUS_NAME);

#if defined(PEGASUS_OS_HPUX)

#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)

// close the file created at startup time to indicate that the

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

// cimserver has terminated normally.

// This is a z/OS specific change.

FileSystem::removeFile(CIMSERVERSTART_FILE);

// register to zOS ARM

automaticRestartManager.DeRegister();

#endif

// Put server shutdown message to the logger

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

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

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

}

catch(Exception& e)

{

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

MessageLoaderParms parms(

"$0 .Abnormal Termination.", 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.57
changed lines
	Added in v.1.210

No CVS admin address has been configured