GW24.3 and SMG integration - where is the documentation?

It is really fine to have a GW24.3 web client integration to SMG.

But how to do? Yes, there are a few lines in GroupWise 24.3 documentation. But no explanation to get the SMG application key.

On the other side I have not detected any hint how to configure SMG! There are some more steps necessary to prepare a successful integration.


Use "Verified Answers" if your problem/issue has been solved!

Parents
  • 0  

    I am also writing up a seperate article about "debugging" the scans from 3rd party scanners, such as GroupWise-Web towards SMG.

    In short to get "verbose output" of requests and responses and see if there is "any activity", the following steps can be helpful.

    Debugging SMG Scan Requests from External Scannners.

    In order to check external scan requests, you can do the following.

    1. Switch to the Folder "/opt/opentext/smg/smg-supervisor/http/api/1/" in your SMG System.
    2. Open up the file "mimescan.php" to edit.
    3. Adjust the "$SaveRequest = false;" value in Line 6 so it reads "$SaveRequest = true;"

    The file should look like this after saving.
           // Set SaveRequest to TRUE to write the request and response files in the SaveRequestPath.
            // Set SaveRequestPath to a valid path on the apache server with proper rights in order to save request and response files for debugging issues
            // Set SaveFilenameFormat to the datetime format string you want to use for the debugging files
            $SaveRequest = true;
            if ( $SaveRequest )
            {
                    $SaveRequestPath = './debug/';
                    $SaveFilenameFormat = 'Md_His_u';
                    $RequestTimeMicroTime = microtime( true );
                    $micro = sprintf( "%06d",( $RequestTimeMicroTime - floor( $RequestTimeMicroTime ) ) * 1000000 );
                    $dt = new DateTime( date( 'Y-m-d H:i:s.'.$micro, $RequestTimeMicroTime ) );
                    $RequestSaveFilename = $dt->format( $SaveFilenameFormat );
            }

    4. Make sure that a debug-folder exists in that folder.
    You can use "§ mkdir debug" to create it. and give it the right permissions. "§ chown smg:smg ./debug".

    Now when a request goes in,
    you SHOULD see "3 Files" in that debug folder, which are created.
    A mime.822-File, which is the actual message-content,
    a directive.xml-File which contains information about the scan-request
    and a response.xml-file which contains the scan-response towards the external scanner


    Example List of files:
    -rw-r--r-- 1 wwwrun www    557 Jul 19 09:15 Jul19_091528_483417_directive.xml
    -rw-r--r-- 1 wwwrun www  29922 Jul 19 09:15 Jul19_091528_483417_mime.822
    -rw-r--r-- 1 wwwrun www    508 Jul 19 09:15 Jul19_091528_483417_response.xml

    In the response file, you also get more verbose information which "event" caused the scan to fail.
    A rule of thumb is, "if you see a requests going in / creating these files", you SHOULD see a message-scan in your SMG-Scanner log.


    In one single-command, this will enable the debugging option.

    cd '/vastorage/smg/smg-supervisor/http/api/1/' && mkdir debug &&chown smg:smg ./debug && sed -i 's/\$SaveRequest = false;/\$SaveRequest = true;/g' mimescan.php


    To disable this debugging state, you can set the "$SaveRequest"-Value to false again.
    No need to restart any smg-service for this to occur, so this can be done in a live-system.



Reply
  • 0  

    I am also writing up a seperate article about "debugging" the scans from 3rd party scanners, such as GroupWise-Web towards SMG.

    In short to get "verbose output" of requests and responses and see if there is "any activity", the following steps can be helpful.

    Debugging SMG Scan Requests from External Scannners.

    In order to check external scan requests, you can do the following.

    1. Switch to the Folder "/opt/opentext/smg/smg-supervisor/http/api/1/" in your SMG System.
    2. Open up the file "mimescan.php" to edit.
    3. Adjust the "$SaveRequest = false;" value in Line 6 so it reads "$SaveRequest = true;"

    The file should look like this after saving.
           // Set SaveRequest to TRUE to write the request and response files in the SaveRequestPath.
            // Set SaveRequestPath to a valid path on the apache server with proper rights in order to save request and response files for debugging issues
            // Set SaveFilenameFormat to the datetime format string you want to use for the debugging files
            $SaveRequest = true;
            if ( $SaveRequest )
            {
                    $SaveRequestPath = './debug/';
                    $SaveFilenameFormat = 'Md_His_u';
                    $RequestTimeMicroTime = microtime( true );
                    $micro = sprintf( "%06d",( $RequestTimeMicroTime - floor( $RequestTimeMicroTime ) ) * 1000000 );
                    $dt = new DateTime( date( 'Y-m-d H:i:s.'.$micro, $RequestTimeMicroTime ) );
                    $RequestSaveFilename = $dt->format( $SaveFilenameFormat );
            }

    4. Make sure that a debug-folder exists in that folder.
    You can use "§ mkdir debug" to create it. and give it the right permissions. "§ chown smg:smg ./debug".

    Now when a request goes in,
    you SHOULD see "3 Files" in that debug folder, which are created.
    A mime.822-File, which is the actual message-content,
    a directive.xml-File which contains information about the scan-request
    and a response.xml-file which contains the scan-response towards the external scanner


    Example List of files:
    -rw-r--r-- 1 wwwrun www    557 Jul 19 09:15 Jul19_091528_483417_directive.xml
    -rw-r--r-- 1 wwwrun www  29922 Jul 19 09:15 Jul19_091528_483417_mime.822
    -rw-r--r-- 1 wwwrun www    508 Jul 19 09:15 Jul19_091528_483417_response.xml

    In the response file, you also get more verbose information which "event" caused the scan to fail.
    A rule of thumb is, "if you see a requests going in / creating these files", you SHOULD see a message-scan in your SMG-Scanner log.


    In one single-command, this will enable the debugging option.

    cd '/vastorage/smg/smg-supervisor/http/api/1/' && mkdir debug &&chown smg:smg ./debug && sed -i 's/\$SaveRequest = false;/\$SaveRequest = true;/g' mimescan.php


    To disable this debugging state, you can set the "$SaveRequest"-Value to false again.
    No need to restart any smg-service for this to occur, so this can be done in a live-system.



Children
No Data