generic_samples/updatesample/main.cpp

Go to the documentation of this file.

/* IBM Source Code */
/* (C) Copyright IBM Corp. 2009, 2012 */
/* Licensed Materials - Property of IBM */
/* US Government Users Restricted Rights - Use duplication or disclosure restricted by GSA Schedule Contract with IBM Corp. */
 
#include <string>
#include <cstdio>
#include <iostream>
#include <ctime>
 
#include "dca/dca_base.h"
#include "dca/dca_callbacks.h"
 
using namespace dca;
 
const std::string S_ToolName = "updatesample";
const std::string S_ToolVersion = "1.2";
 
const std::string S_UsageString =
        "<dca-redist-folder> <ticket> <product>\n"
        "  dca-redist-folder - the folder where the DCA is installed to\n"
        "  ticket - a valid ticket\n"
        "  product - the product associated with your ticket\n\n"
        ;
 
#ifdef WIN32
#       define DCA_BINDIR               "bin/Win32"
#else
#       define DCA_BINDIR               "bin/linux"
#endif
 
#define DCA_INITDIR             "init"
 
#define DCA_LOGDIR              "./logs"
 
static void SetupInitData( const std::string& redist_folder, InitData& initData )
{
        initData.binDir = redist_folder + DCA_BINDIR;
        initData.initDir = redist_folder + DCA_INITDIR;
        initData.logDir = DCA_LOGDIR;
}
 
static void SetupLicense( const std::string& ticket, const std::string& product,
        LicenseData& licenseData )
{
        licenseData.ticket      = ticket;
        licenseData.product     = product;
}
 
static void PrintLicenseInfo( const License& aLicense )
{
        const time_t expirationDate = aLicense.getExpirationDate();
        struct tm *expirationTime = localtime( &expirationDate );
 
        std::cout << "License Info:" << std::endl;
        std::cout << "  DCA is " << ( aLicense.isLicensed() ? "licensed." : 
                "not licensed." ) << std::endl;
        std::cout << "  MaxUsers:" << aLicense.getMaxUsers() << 
                std::endl;
        std::cout << "  MaxSessions:" << aLicense.getMaxSessions() << 
                std::endl;
        std::cout << "  Ticket:" << aLicense.getTicket() << 
                std::endl;
        std::cout << "  Session:" << aLicense.getSession() << 
                std::endl;
        std::cout << "  Last Message:" << aLicense.getLastMessage() << 
                std::endl;
        std::cout << "  Expiration Date:" << asctime( expirationTime ) << 
                std::endl;
}
 
int TestUpdate( const DcaInstance& myDca, const License& myLicense )
{
        std::cout << "Starting update routine..." << std::endl;
        // create the update module
        const UpdateModule myUpdateModule = UpdateModule::create( myDca, myLicense );
 
        std::cout << "Start update process, paramater force is set to 'false'..." << std::endl;
        UpdateResults results;
        FunctionResult myFR = myUpdateModule.performUpdate( false, results );
        if( !myFR ) {
                // we encounter an error... print detailed error code and return
                std::cerr << "Got error from update. Details: '" << myFR.getDescription()
                        << "' (" << myFR.getReturnCode() << "). Aborting." << std::endl;
                return 1;
        }
 
        std::cout << "UpdateResults: size=" << results.size() << ", restartRequired="
                << ( results.restartRequired() ? "true" : "false" )
                << std::endl;
 
        if( !results.size() ) {
                std::cout << "Currently there are no updates available" << std::endl;
                return 0;
        }
 
        // iterate through all received updates and print out the details
        const DCA_SIZE_TYPE size = results.size();
 
        for( DCA_INDEX_TYPE i = 0; i < size; ++i ) {
                const UpdateResult result = results[i];
 
                std::cout << "Result #" << i << " id=" << result.id() << ", contentUpdated="
                        << ( result.contentUpdated() ? "true" : "false" ) << ", engineUpdated="
                        << ( result.engineUpdated() ? "true" : "false" ) << std::endl;
 
                const DCA_SIZE_TYPE numDetails = result.size();
 
                for( DCA_INDEX_TYPE j = 0; j < numDetails; ++j ) {
                        const UpdateResultDetail detail = result[j];
 
                        std::string returnMsg = "internal error";
                        if( detail.returnCode() == DCA_UPDATE_DOWNLOAD_SCHEDULED ) {
                                returnMsg = "download scheduled";
                        }
                        else if( detail.returnCode() == 0 ) {
                                returnMsg = "success";
                        }
 
                        std::cout << "  Detail #" << j << ":"
                        << "\n    component=" << detail.component()
                        << "\n    old version=" << detail.oldVersion()
                        << "\n    new version=" << detail.newVersion()
                        << "\n    available=" << ( detail.available() ? "true" : "false" )
                        << "\n    downloaded=" << ( detail.downloaded() ? "true" : "false" )
                        << "\n    installed=" << ( detail.installed() ? "true" : "false" )
                        << "\n    return=" << returnMsg << std::endl;
                }
        }
 
        std::cout << "Leaving update routine. All done" << std::endl;
        return 0;
}
 
static void PrintToolHeader()
{
        std::cout << "IBM DCA Sample: " << S_ToolName << " (" << 
                S_ToolVersion << ")" << std::endl;
}
 
static void PrintUsage( const char *name )
{
        std::cout << name  << std::endl << "Usage:" << std::endl;
        std::cout << S_UsageString << std::endl;
}
 
int main( int argc, char *argv[] )
{
        PrintToolHeader();
 
        int rc = 5;
 
        try {
 
                if( argc < 4 ) {
                        PrintUsage( argv[0] );
                        return 4;
                }
 
                std::string redist_folder = argv[1];
                const std::string ticket = argv[2];
                const std::string product = argv[3];
 
                if( redist_folder.empty() || ticket.empty() ||
                        product.empty() ) {
                        PrintUsage( argv[0] );
                        return 5;
                }
 
                // check for trailing fileslash - and add if necessary
                const char c = redist_folder[ redist_folder.length() - 1 ];
                if( c != '/' && c != '\\' )
                        redist_folder += "/";
 
                // init the 3rd party libraries
                InitCUrl();
                SetOpenSslCallbacks();
 
                {
                        // setup DCA directories
                        InitData myInitData;
                        SetupInitData( redist_folder, myInitData );
 
                        // instantiate the DCA API
                        DcaInstance myDca;
                        myDca = DcaInstance::create( myInitData );
 
                        // setup license data
                        LicenseData myLicenseData;
                        SetupLicense( ticket, product, myLicenseData );
                        const License myLicense = myDca.createLicense( myLicenseData );
                        
                        PrintLicenseInfo( myLicense );
 
                        if( myLicense.isLicensed( UpdateModule::ID ) ) {
                                // NOTE:
                                // The update process includes only already loaded modules and classifiers
                                // for content updates.
                                // To get this sample doing a real update initialize some of your licensed modules
                                // here e.g. TextClassification or UrlClassification - refer to the related sample
                                // of those modules to see how they can be initialized.
 
                                // call update routine - usually this should be called from a dedicated thread
                                rc = TestUpdate( myDca, myLicense );
                        }
                }
        }
        catch( const ExDca& ex ) {
                std::cerr << "DCA Exception occured. Details: " <<  ex.getDescription() <<
                        " (" << ex.getReturnCode() << ")." << std::endl;
                rc = 10;
        }
        catch( const std::exception& s ) {
                std::cerr << "std::exception occured. Details: " << s.what() << "." << std::endl;
                rc = 10;
        }
        catch(...) {
                std::cerr << "Unknown exception caught." << std::endl;
                rc = 10;
        }
 
        // deinit the 3rd party libraries
        UnsetOpenSslCallbacks();
        DeinitCUrl();
 
        return rc;
}