Installation Guide. Summary. This document is a step by step guide that illustrates the installation procedure for Compleo Suite.

Transcription

1 Installation Guide Summary This document is a step by step guide that illustrates the installation procedure for Compleo Suite. Author: SYMTRAX

2 Table of Contents 1 Required Configuration Firewall Settings Compleo Suite 6 Installation Installing Compleo Supervisor Database (Optional) Configuring Compleo Suite 6 - Database mode Upgrading Compleo Database Registering Compleo Suite after evaluation expiry/ Changing the licence Manager host Silent Install System I library Installation SAP Permissions necessary for Connector setup and usage Compleo Suite 6 SAP R/3 Connector SAP Server Configuration Installing on a SAP ERP ECC6 or SAP S/4 HANA System Uninstall Migration Migrating from Compleo 3.6 to Compleo Suite Migrating from Compleo 4 to Compleo Suite Migrating from Compleo 5 to Compleo Suite Uninstall System I Libraries Uninstall PC Uninstall Contact Us Annexure Compleo Suite Installation Guide Page 2 of 71

3 1. Installing SQL Express Processing SAP spools using SAP print service (without installing any package on the sap server) Creating SAP Virtual Printer SAP Configuration for BC-XOM Connector Setup of a new RFC destination: Declaration on an RFC server Create a new ROMS (Real Output Management System) Create a new LOMS (Logical Output Management System) Create an Output device Installing SAP Function ZBC_COMPLEO_USER_GET_SNC Create Function Group Create Data structure Create function module Test function module Index Compleo Suite Installation Guide Page 3 of 71

4 1 Required Configuration Compleo Suite 6 works with the following configurations: Minimum Recommended 1 Ghz processor 2 Ghz processor 1 Gb available RAM 4 Gb available RAM 200 Mb available hard disk space 30 Gb available hard disk space PC operating system Windows server 2008 SP2/Windows 7 SP1/Windows Server 2008 R2 SP1/Windows 8/Windows Server 2012/Windows 8.1/Windows Server 2012 R2/ Windows 10/Windows Server 2016.NET Version System I operating system OS/400 V4R3M0 or higher System I connection type TCP/IP (local or remote connection) SAP R/3 operating system SAP Business Suite NetWeaver 7.02 or higher SAINT package level must be at least 0021 ABA+BASIS support at least 0019 & SAP Note SAP S/4HANA ABA+BASIS support at least 0002 File formats Recognized Compleo Suite 6 manages the following types of files System I: SCS, IPDS, and AFPDS SAP: LIST, OTF, SMART, XSF, IDOC and RDI PC: ASCII, EBCDIC, CSV, PDF, XML and image files (jpg, png, tiff and gif) Other tools Microsoft Office (Word, Excel, Access & Outlook) 2003/2007/2010 x86/2013 x86/2016 x86 Adobe Acrobat 7 or higher Internet Explorer 8 or higher Options MS Outlook 2003/2007/2010 x86 connected to Exchange Server 5.0/5.5/2000/2003/2007/2010 Fax Option Microsoft Shared Fax Driver (available with Windows 2008 or higher) Compleo Suite 6 also works with many other office and applications. Please contact the Symtrax Technical Support for more information. Compleo Suite Installation Guide Page 4 of 71

5 Important Note: 1. We recommend you to first uninstall the previous version of Symtrax product, if any, and then proceed to re-install the new version. 2. For installation of Licensed mode of Compleo Suite, Symtrax Licence Manager should be accessible. For further details on Symtrax Licence Manager refer to Symtrax Licence Manager installation guide. 3. For Compleo Suite to support Chinese, Japanese or Korean characters, the supplemental language support of Windows must be installed. Compleo Suite Installation Guide Page 5 of 71

6 2 Firewall Settings The below mentioned ports need to be opened for some features of Compleo Suite 6 to work: 1. License Manager Server: Supervisor Server: i. 445 and 8785 ii. ICMP protocol must be enabled iii. Compleo Console: 9000 iv. SAP Virtual Printer: iseries Server: i. Using ICASRV: 2336 and 2337 ii. Restoring a library on the iseries: SAP BC-XOM Server: 33xx, where xx = xx of sapgwxx (SAP gateway service) and Print Manager Server: Remote Supervisor/Agent machines: SMTP Server: SQL Server: 1433 Compleo Suite Installation Guide Page 6 of 71

7 3 Compleo Suite 6 Installation Step 1 Rights required to install Compleo Suite 6 You can install Compleo Suite 6 from any profile. It will prompt you for the administrator password when you use a profile other than the Administrator profile to install Compleo Suite 6. Step 2 Choose Language Follow the installation program instructions step by step. Select the language you prefer and Click OK. Step 3.NET Framework Installation If.NET Framework 4.6 is already installed, jump to step 4. If.NET Framework 4.6 is not installed you have to install the.net framework included in the Compleo Suite 6 package as shown below. Click "Install" to proceed. Compleo Suite Installation Guide Page 7 of 71

8 Step 4 Read the welcome note and accompanied information carefully Read the information carefully and if satisfied with it, click "Next" to proceed. Step 5 Accept the terms of the Compleo Suite License Agreement Accept the license agreement and click "Next" to proceed. Compleo Suite Installation Guide Page 8 of 71

9 Step 6 Installation Mode This step lets you choose between two different Compleo Suite 6 access modes: Evaluation Mode: In this mode, all application features will be installed. This mode will not request any license keys. Trial License is valid for 10 days from the day of the installation. If you select this mode, you can directly jump to step 10 in this section of the guide. Licensed Mode: In this mode, only selected application features will be installed. This mode will request for the host machine name where Symtrax Licence Manager is installed. Select the appropriate mode and click "Next" to proceed. Compleo Suite Installation Guide Page 9 of 71

10 Step 7 Connecting to Licensing Service In Licence Manager Host field, enter the machine name which has Symtrax Licence Manager installed. Note: For further details on Symtrax Licence Manager refer to Symtrax Licence Manager installation guide. Click Next. Step 8 Select Licenced Products The above screens allow you to choose between the different Compleo Suite modules for which the licenses are available in the licence manager. The license details are displayed beside the product name. Select the checkbox of the modules you want to install. Compleo Suite Installation Guide Page 10 of 71

11 Click "Next" to proceed. Step 9(Optional) Define Compleo Supervisor Database parameters if you want to work with centralised resources Connect Compleo Supervisor to an existing Compleo Database: Select this check box and enter the details to access Compleo Supervisor Database. Click Next. Note: This will not install the database. If you want to create a new Compleo Supervisor database, you can leave these parameters blank. You can install the database and setup the database settings after the installation, using DBSettings.exe (see chapter 3.1). If you do not wish to work with centralised resources, skip this step and click Next. Step 10 Select a Destination Location to install the Compleo Suite By default, the application will be installed in C:\Program Files\Symtrax\Compleo Suite. Compleo Suite Installation Guide Page 11 of 71

12 To change the folder location, click "Change" and select a folder where you want the application to be installed. Click "Next" to proceed. Step 11 Start Installation Click "Install" to start the Installation. Step 12 Finish Installation Click "Finish" to complete the installation. The PC installation of Compleo Suite 6 is complete! Compleo Suite Installation Guide Page 12 of 71

13 You can access the program as follows: Start All Programs Symtrax Compleo Suite Installing Compleo Supervisor Database (Optional) If you want to centralize the resources, you need to create Compleo Supervisor database. Double click on DBsettings.exe located in the directory you chose to Install Compleo Suite 6. NOTE: If you had chosen the default location, then you will find the file in C:\Program Files\Symtrax\Compleo Suite\ The details you entered in the Step 9 of Compleo Suite 6 installation Chapter will appear in this window. If you want to edit the connection parameter or if the Step 9 was left blank, then click Settings button. Compleo Suite Installation Guide Page 13 of 71

14 Edit or enter the details. Click OK. Click. Click Start installation button to create Compleo Supervisor database. Once the database is created, the connection status will appear on Compleo Database Manager window. Compleo Suite Installation Guide Page 14 of 71

15 3.2 Configuring Compleo Suite 6 - Database mode After uninstalling the previous version of Compleo Suite and installing Compleo Suite 6, when you open Compleo Supervisor for the first time, it will ask whether you want to import local Supervisor configuration. Click Yes. Then the Centralized Resources screen will appear, which automatically selects the configuration of the previous version. Select the destination where you want to upload the resources in the database and click Upload. Compleo Suite Installation Guide Page 15 of 71

16 Configuration of previous version of Compleo Supervisor will appear in Compleo Supervisor 6.0, under the Configurations tab. 3.3 Upgrading Compleo Database While upgrading Compleo 6.x to Compleo Suite 6.3, in DB mode, you will have to upgrade your Compleo database. Double click on DBsettings.exe located in the directory you chose to Install Compleo Suite 6. NOTE: If you had chosen the default location, then you will find the file in C:\Program Files\Symtrax\Compleo Suite\ Compleo Suite Installation Guide Page 16 of 71

17 Click. Click Start upgrade button to upgrade Compleo Supervisor database. Once the database is upgraded, the connection status will appear on Compleo Database Manager window. Compleo Suite Installation Guide Page 17 of 71

18 3.4 Registering Compleo Suite after evaluation expiry/ Changing the licence Manager host To enter a new License Manager Host for Compleo Suite 6 go to: Start All Programs Symtrax Tools Symtrax Licence Registration Client. Click on Register and the Register Licences window appears. Enter the name of the server that hosts the Symtrax Licence manager and click on Check. Compleo Suite Installation Guide Page 18 of 71

19 This would display the list of available licences on the licence manager host. Select the product you want to register and click on OK. If that licence is available, you will get the confirmation of successful registration. Important Note: After the expiry of the evaluation, if you want to register selective modules of Compleo Suite, you would need to uninstall the product and reinstall it again in the licenced mode. Compleo Suite Installation Guide Page 19 of 71

20 4 Silent Install For silent installation, open a command prompt and go to a folder where CompleoSuite.exe is located. Now if the license manager is installed on the machine named LICSERV, then the command line to install Compleo Suite is: CompleoSuite.exe /s /v/qn /v"install_type=1 LIC_SERVER= LICSERV CMP_INSTALL=1 DSG_INSTALL=1 CFX_INSTALL=1 LAY_INSTALL=1 SUP_INSTALL=1 SPR_INSTALL=1 CS_DB_INSTALL=1 CHO_INSTALL=1 CS_DB_SERVER= Machine Name CS_DB_CATALOG=CmpSuper CS_DB_LOGIN= login-name CS_DB_PASSWORD= password INSTALLDIR=\"C:\TESTINSTALL\"" /DEBUGLOG"CS.LOG" Mandatory Parameters: INSTALL_TYPE=0/1 (0=Trial/1=Licensed) LIC_SERVER=licenceserver... (mandatory if INSTALL_TYPE=1) Optional Parameters: CMP_INSTALL=1 installs Compleo Explorer DSG_INSTALL=1 installs Compleo Designer CFX_INSTALL=1 installs Compleo for XML LAY_INSTALL=1 installs Compleo Layout SUP_INSTALL=1 installs Compleo Supervisor SPR_INSTALL=1 installs Compleo Supervisor Runtime PMG_INSTALL=1 installs Compleo Print Manager CS_DB_INSTALL=1 installs Compleo Supervisor DB mode CHO_INSTALL=1 installs Compleo Chorus Manager Optional parameters to setup if the DB mode is used: CS_DB_SERVER= Machine Name CS_DB_CATALOG= CmpSuper CS_DB_LOGIN= login-name CS_DB_PASSWORD= password Compleo Suite Installation Guide Page 20 of 71

21 INSTALLDIR=\ \ (Change the destination directory for installation Default is <%systemdrive%>\program Files\SYMTRAX\Compleo Suite for x86 machines and is <%systemdrive%>\program Files (x86)\symtrax\compleo Suite for x64 machines) DEBUGLOG makes the log file of the install in the directory where the install program is located. Compleo Suite Installation Guide Page 21 of 71

22 5 System I library Installation Step 1 Rights required to install the Compleo Suite System I Connector You can install the Compleo Suite System I Connector with any profile. It will prompt you for the administrator password when you use a profile other than the Administrator profile to install the Compleo Suite System I Connector. Step 2 Run the file CPSuite_i5.exe. Please note that you only have to restore System I libraries once and that ONE System I installation allows you to install client programs on ALL client PCs. The CPSuite_i5.exe is located in the directory you chose to Install Compleo Suite 6. In the chosen directory, you will find this file in \Connectors. NOTE: If you had chosen the default location, then you will find the file in C:\Program Files\Symtrax\Compleo Suite\Connectors. Double click on the file to begin installation. Step 3 Run the CPSuite_i5.exe Follow the installation program instructions step by step. Click "Start Installation" to proceed to the next step. Compleo Suite Installation Guide Page 22 of 71

23 Step 4 Accept the terms of the License Agreement Accept the license agreement and click "Next" to proceed. Step 5 Enter a new name or select an existing connection Address: Enter the iseries Address. Compleo Suite Installation Guide Page 23 of 71

24 FTP Port (TCP/IP only): The FTP Port is 21 by default. Click "Next" to proceed. Step 6 Enter the necessary information regarding the connection User profile and Password to restore the libraries: A profile which has the authority to restore libraries to the System I must be used (must have *AllObj and *SecAdm authority), preferably QSECOFR. Click "Next" to proceed. Step 7 Update the ICASRV library If you are already using Symtrax products and if the ICASRV library already exists on the System I, you will need to replace it with this up to date version. In this case, a dialog box is displayed prompting you to confirm whether the ICASRV library is to be replaced: Choose Yes: The ICASRV sub-system is stopped, updated and then restarted. Compleo Suite Installation Guide Page 24 of 71

25 Warning: All the users connected to ICASRV will be disconnected. Click "Next" to proceed. Step 8 Preparing to install Click "Close". The System I installation is complete! Important note: In Compleo Suite 6, when you create a new connection do not use the QSECOFR profile. Compleo Suite Installation Guide Page 25 of 71

26 6 SAP Permissions necessary for Connector setup and usage Here is the following list of authorization objects you need to assign to an SAP user for the Compleo Suite application to work seamlessly. Authorization Object Authorization field Minimum authorization value S_USER_GRP ACTVT 03 S_SPO_ACT SPOACTION BASE, DISP, REPR (REPR for BCXOM) S_SPO_DEV SPODEVICE * by default or Customer's choice S_ADMI_FCD S_ADMI_FCD PADM, SP01, SP0R S_XMI_PROD (For BCXOM) EXTCOMPANY EXTPRODUCT INTERFACE SYMTRAX COMPLEO XOM S_SPO_PAGE SPODEVICE SPOPAGES * by default or Customer's choice S_RFC ACTVT 16 (Execute) S_RFCACL ACTVT * by default or Customer's choice S_TCODE TCD SP01-SP Compleo Suite 6 SAP R/3 Connector In the evaluation mode, you will be able to access your SAP R/3 servers, through the modules of Compleo Suite, by default. In the Licenced mode, SAP R/3 connector will be accessible only if the SAP R/3 licence or the BC-XOM licence is available in the current Licence Manager host being used. The connector appears in the Tree View of the application as shown below. Compleo Suite Installation Guide Page 26 of 71

27 7 SAP Server Configuration 7.1 Installing on a SAP ERP ECC6 or SAP S/4 HANA System If the SNC login feature is setup on the SAP system, and if the Remote Agent feature of Compleo Suite will be used in order to send printed documents back to the end users, then it is necessary to setup the function ZBC_COMPLEO_USER_GET_SNC in the SAP system. Step 1A Using the PAT files Copy the PAT file in the EPS Inbox of the SAP server (By default the EPS inbox is: \\SAPServername\sapmnt\trans\EPS\in) NOTES: 1. The PAT will be located in the directory you chose to Install Compleo Suite 6. In the chosen directory, you will find this file in \Connectors. If you had chosen the default location, then you will find the file in C:\Program Files\Symtrax\Compleo Suite\Connectors. 2. Select either SAP ECC6 or SAP S/4 HANA depending on the type of SAP system you have installed. If you are installing the connector for the first time then use PAT file in the Install folder. If you have used the previous version of connector then use the PAT file in the Upgrade folder. Step 1A-1 Log on to the SAP Server Log on as a developer on the SAP GUI, Client 000. In the SAP GUI invoke transaction: SAINT In the menu choose: Installation Package Load Package From Application Server Then choose YES. Compleo Suite Installation Guide Page 27 of 71

28 Step 1A-2 Upload Successful Once the PAT package is successfully uploaded, you should see a confirmation screen shown below: Then click Back and Start as shown in the screen shot below. Compleo Suite Installation Guide Page 28 of 71

29 Jump to Step 2. Step 1B Using the CAR files Installation Package Load Package From Front End. Go to C:\Program Files (x86)\symtrax\compleo Suite\Connectors\SAP ECC6\Install Compleo Suite Installation Guide Page 29 of 71

30 Select the SYMTRAX_5202_700.CAR and click Open. Click Allow. Compleo Suite Installation Guide Page 30 of 71

31 Click on Decompress to unarchive the PAT file to desired location in SAP server i.e. EPS/IN folder. The PAT file is copied in \usr\sap\trans\eps\in folder. Compleo Suite Installation Guide Page 31 of 71

32 Step 2 Choosing the Add-on Package Select the Add-on SYMTRAX Click Continue to Proceed. Compleo Suite Installation Guide Page 32 of 71

33 Click Continue to proceed. Compleo Suite Installation Guide Page 33 of 71

34 Step 3 Installing the Add-on Package You will see the following screen to confirm the package installation procedure. Finally click the Check mark (highlighted in the screenshot above) to install Compleo Suite Sap Connector. Step 4 Finalizing the Installation of SAP Connector Once the installation is completed, you will see the following screen Compleo Suite Installation Guide Page 34 of 71

35 Click Finish. Compleo Suite SAP Connector is now installed on your system!! Compleo Suite Installation Guide Page 35 of 71

36 7.2 Uninstall Technical Prerequisite: The system is based on SAP NetWeaver Release 7.00 or higher. You have installed at least SPAM/SAINT Version You use a kernel with at least Release The transport tool tp has at least Version The transport tool R3trans has at least the version from AUG/06/2013. For more information, please refer to the SAP note Log on as a developer on the SAP GUI, Client 000. In the SAP GUI invoke transaction: SAINT Go to the Deinstallable components Select the line and press start: Compleo Suite Installation Guide Page 36 of 71

37 Click Compleo Suite Installation Guide Page 37 of 71

38 Press Finish. Compleo Suite Installation Guide Page 38 of 71

39 Compleo Suite Installation Guide Page 39 of 71

40 8 Migration 8.1 Migrating from Compleo 3.6 to Compleo Suite 6 Running the Migration Utility Program Save the configuration directory C:\Program Files\Symtrax\Compleo Supervisor 3\Config before migrating and do not uninstall Compleo supervisor 3.6. The CfgConverter.exe is located in the directory you chose to Install Compleo Suite 6. NOTE: If you had chosen the default location, then you will find the file in C:\Program Files\Symtrax\Compleo Suite\ When you double click on CfgConverter.exe, the configuration converter screen will appear. The Configuration converter (Migration Utility program) will automatically find your Compleo 3.6 configuration files and convert them into a Compleo Suite 6 compatible format. NOTE: Only the output devices (System I s Output Q s) that are Active (Play) or in Scheduled state will be successfully migrated. The repositories in any other state will not be migrated to Compleo Suite 6 compatible format. Important: Before starting the migration, stop Compleo Supervisor and Administrator 3.6 and Compleo Supervisor 6. Once the Migration is successful, you will see a message to confirm this. You have successfully converted your Compleo 3.6 configuration files to Compleo Suite 6 format. You can now use Compleo Suite 6 with your Compleo 3.6 configuration. After migration, the Output Q s will no longer be active in Compleo supervisor 3.6. If you do not wish to migrate an Output Q, change the status of the Output Q s in Compleo Supervisor 3.6 to pause. Important Migrating a configuration that uses Network Drive Path While migrating Compleo 3.6 configuration to Compleo Suite 6, if you have a scenario that uses files stored in a mapped drive, after conversion, it will not work as it should because Supervisor 6 is a Service and this is a normal behavior for Services. You need to manually replace the path of the mapped drive and put a UNC path instead of the drive. It will work if Supervisor is in Interactive mode. For example: If you run supervisor as a service and If your configuration uses a scenario or files that have a path to the mapped drive like Z:\Shared Folder, this will not work after conversion. You have to replace this path by \\Server Name\Shared Folder for it to work with Compleo Suite 6. NOTE: It is not possible to call Macros, in word, present in any template or.dot file using Compleo Suite 6. Compleo Suite Installation Guide Page 40 of 71

41 Migrating Favorites from Compleo 3.6 to Compleo Suite 6 You also have a utility program that will help you convert your favorites section in Compleo 3.6 to a compatible format in Compleo Suite 6. To do this, double click on FavoriteConverter.exe located in the same directory as CfgConverter.exe. NOTE: You have to run the FavoriteConverter.exe from each profile whose favorites you want to convert to Compleo Suite 6 compatible format. By default, it converts the favorites of the profile you are have logged on with. The Favorite converter utility will automatically find your Compleo 3.6 favorite files and convert them into a Compleo Suite 6 compatible format. Compleo Suite Installation Guide Page 41 of 71

42 8.2 Migrating from Compleo 4 to Compleo Suite 6 If you had chosen the default location to install Compleo Suite 4, then you will find the config file in C:\ProgramData\Symtrax\Compleo Suite\Config. Save the configuration of Compleo Suite 4 and uninstall Compleo Suite 4. Now, install Compleo Suite 6 on the same machine. The configuration of the previous version will automatically appear when you open Compleo Supervisor 6. If you want to use the database mode of Compleo Suite 6, refer to section 3.2 Configuring Database mode of Compleo Suite 6. Note: You can also export the configuration of Compleo Supervisor 4. This.ccf file can also be used by Compleo Supervisor 6, when installed on a fresh machine. 8.3 Migrating from Compleo 5 to Compleo Suite 6 If you had chosen the default location to install Compleo Suite 5, then you will find the config file in C:\ProgramData\Symtrax\Compleo Suite\Config. Save the configuration of Compleo Suite 5 and uninstall Compleo Suite 5. Now, install Compleo Suite 6 on the same machine. The configuration of the previous version will automatically appear when you open Compleo Supervisor 6. If you want to use the database mode of Compleo Suite 6, refer to section 3.2 Configuring Database mode of Compleo Suite 6 Note: You can also export the configuration of Compleo Supervisor 5. This.ccf file can also be used by Compleo Supervisor 6, when installed on a fresh machine. Compleo Suite Installation Guide Page 42 of 71

43 9 Uninstall 9.1 System I Libraries Uninstall End the ICASRV sub-system (if you are connecting with TCP/IP) with the following command: ENDSBS SBS(ICASRV) OPTION(*IMMED) Delete the ICASRV with the following command: DLTLIB ICASRV Delete the product library with the following command: DLTLIB CPSUITE4 Compleo has been uninstalled from the System I. Note: If ICASRV has been added to the start list of subsystems, then the System I administrator should remove that entry. 9.2 PC Uninstall To uninstall Compleo Suite 6, follow Start Control Panel Programs and Features Symtrax Compleo Suite 6 Uninstall This will uninstall Compleo Suite 6 from your PC. Compleo Suite Installation Guide Page 43 of 71

44 Technical Support Symtrax USA (West Coast) M-F, 8:30a.m. - 5:30p.m. (PST) 5777 W. Century Blvd., Suite Los Angeles, CA USA Tech Support: or (outside of US) - support@symtrax.com Contact Us Technical Support Symtrax USA (East Coast) M-F, 8:30a.m. - 5:30p.m. (EST) 2 Oliver Street, 8th Floor, Boston, MA 02110, USA Tech Support: Symtrax 866 USA 640 (West 9615 Coast) or M-F, (outside 8:30a.m. of US) -- 5:30p.m. support@symtrax.com (PST) 5777 W. Century Blvd., Suite Los Angeles, CA USA Symtrax Tech Latin Support: America or 310 M-F, 216 8:30a.m (outside - 5:30p.m. of US) (PT) - support@symtrax.com Mexico: x117 - soporte@symtrax.com Elsewhere: Symtrax +310 USA 216 (East Coast) soporte@symtrax.com M-F, 8:30a.m. - 5:30p.m. (EST) 2 Oliver Street, 8th Floor, Boston, MA 02110, USA Symtrax Tech United Support: Kingdom or 617 M-F, 391 9:00a.m (outside - 5:30p.m. of US) (GMT) - support@symtrax.com Symtrax Limited, Crown House, 72 Hammersmith Road, Hammersmith, London W14 18TH, UK Tech Support: Symtrax +44 Latin (0)207 America support@symtrax.co.uk M-F, 8:30a.m. - 5:30p.m. (PT) Mexico: x117 - soporte@symtrax.com Symtrax Elsewhere: France soporte@symtrax.com M-F, 9:00a.m. - 6:00p.m. (GMT+1) 226, Rue Georges Besse Nîmes, Cedex 01 - France Tech Support: Symtrax +33 United 4 66 Kingdom Fax: + 33 (0)4 M-F, 66 9:00a.m :30p.m. - support@symtrax.fr (GMT) Symtrax Limited, Crown House, 72 Hammersmith Road, Hammersmith, London W14 18TH, UK Symtrax Tech Deutschland Support: +44 (0) M-F, - 9:00a.m. support@symtrax.co.uk - 6:00p.m. (GMT+1) PartnerPort, Altrottstraße 31, Walldorf, Deutschland Tech Support: Symtrax 06227/ France - support@symtrax.de M-F, 9:00a.m. - 6:00p.m. (GMT+1) 226, Rue Georges Besse Nîmes, Cedex 01 - France Symtrax Tech Europe Support: M-F, - Fax: 9:00a.m (0)4-6:00p.m (GMT+1) 11 - support@symtrax.fr Spanish: soporte@symtrax.es Italian: Symtrax Europe 30 - supporto@eu-symtrax.com M-F, 9:00a.m. - 6:00p.m. (GMT+1) Fax: + German: 33 (0) (D), (A), (CH) - support@symtrax.de Spanish: soporte@symtrax.es Symtrax Italian: South 800 East Asia 30 - supporto@eu-symtrax.com M-F, 9:00a.m. - 6:00p.m. (IST) 203A, Paradigm Fax: + 33 B, (0)4 MindSpace Malad(W) Mumbai India Tech Support: supportasia@symtrax.in Symtrax South East Asia M-F, 9:00a.m. - 6:00p.m. (IST) 203A, Paradigm B, MindSpace - Malad(W) Mumbai India Tech Support: supportasia@symtrax.in Sales Team Symtrax USA (West Coast) 5777 W. Sales Century Blvd., Team Suite Los Angeles, CA USA Toll free: (outside of US) - Fax: Symtrax sales@symtrax.com USA (West Coast) 5777 W. Century Blvd., Suite Los Angeles, CA USA Symtrax Toll USA free: (East Coast) (outside of US) - Fax: Oliver Street, sales@symtrax.com 8th Floor, Boston, MA 02110, USA Toll free: (outside of US) - Fax: Symtrax sales@symtrax.com USA (East Coast) 2 Oliver Street, 8th Floor, Boston, MA 02110, USA Symtrax Toll Latin free: America (outside of US) - Fax: Mexico: sales@symtrax.com 4632 x ventas@symtrax.com Elsewhere: ventas@symtrax.com Symtrax Latin America Symtrax Mexico: UK x ventas@symtrax.com Symtrax Elsewhere: Limited, Crown House, Hammersmith ventas@symtrax.com Road, Hammersmith, London W14 18TH, UK Tel: +44 (0) sales@symtrax.co.uk Symtrax UK Symtrax Symtrax France Limited, Crown House, 72 Hammersmith Road, Hammersmith, London W14 18TH, UK 226, Rue Tech Georges Support: Besse (0) Nîmes, Cedex - support@symtrax.co.uk 01 - France Tel: +33 (0) Fax: +33 (0) sales@symtrax.fr Symtrax France Symtrax 226, Deutschland Rue Georges Besse Nîmes, Cedex 01 - France PartnerPort, Tel: +33 Altrottstraße (0) , Fax: Walldorf, +33 (0)4 Deutschland sales@symtrax.fr Tel: 06227/ verkauf@symtrax.de Symtrax Europe Symtrax NL: Europe GE: NL: +33 SP: GE: EN: SP: +33 sales@eu-symtrax.com EN: sales@eu-symtrax.com Symtrax South East Asia Symtrax 203A, South Paradigm East Asia B, MindSpace - Malad(W) Mumbai India 203A, Paradigm Tel: B, 40 MindSpace Malad(W) salesapac@symtrax.in Mumbai India Tel: salesapac@symtrax.in Compleo Suite Installation Guide Page 44 of 71

45 Annexure 1. INSTALLING SQL EXPRESS If you have not installed SQL Express, then download SQL express 2014 from the Microsoft website. You can use DBsetting.exe to install SQL with the default parameters. Double click on DBsettings.exe, located in the directory you chose to Install Compleo Suite 6. NOTE: If you had chosen the default location, then you will find the file in C:\Program Files\Symtrax\Compleo Suite\ The Compleo Database Manager dialog box appears. Go to File menu > Install SQL Express. The Install SQL Express dialog box appears: Browse to select the.exe and click Start Installation button. By default, it will extract the SQL files in C:\Program Files\Symtrax\Compleo Suite\SQLEXPRADV_x64_ENU\. If you wish you can change the location by clicking Browse. Compleo Suite Installation Guide Page 45 of 71

46 Click Ok. SQL express will get installed in the background. Click Settings button, the connection parameter will be displayed: In this case, sa account password is Compleo1. 2. PROCESSING SAP SPOOLS USING SAP PRINT SERVICE (WITHOUT INSTALLING ANY PACKAGE ON THE SAP SERVER) 2.1 CREATING SAP VIRTUAL PRINTER To create a SAP printer use SPAD command in SAP. This command is used for spool administration. The Spool Administration: Initial Screen is displayed. Click Display button of Output Devices. This will show the list of output device available in spool administration. Click toolbar. this will expand and will display other options of the Compleo Suite Installation Guide Page 46 of 71

47 Click to create a new printer. The Spool Administration: Create Output Device screen will be displayed. Enter the printer name and its short name in Output Device and Short name text box respectively. In this case, use Compleo as printer name and CMP as short name. Select appropriate device type from the Device Type drop-down list. Select SAPGOF: Generic output format ASCII if you want to export in excel or change the content. Select PDF printer if you want to archive the document. Click Access Method tab. Select U: Print Using Berkeley Protocol from Host Spool Access Method drop-down list. Compleo Suite Installation Guide Page 47 of 71

48 Enter host printer name in the Host Printer text box. Note: Host printer name should be exactly same as the Output Device name. In this case it is Compleo. In Destination host enter the IP address or name of the machine where the Supervisor is running. Save the settings by clicking. If the supervisor is not started, you will get an error. We recommend you to start it before entering Destination host. Note: You do not need to install any other package on your SAP system to run the SAP Print Service. Compleo Suite Installation Guide Page 48 of 71

49 Print a report immediately To print a report, select the report: 1. Click the printer button. 2. Print Screen List window appears. Click 3. Type Compleo in the Output Device box. 4. Select the printer to Print as Compleo. Compleo Suite Installation Guide Page 49 of 71

50 5. To print the spool immediately, select Print out immediately from the drop-down menu of Time of print. 6. Click. 2.2 SAP CONFIGURATION FOR BC-XOM CONNECTOR First you need configure BC-XOM connection on the SAP system and then configure the RFC server in Compleo Supervisor. Perform the following steps on SAP system to setup a BCXOM connection, using an external RFC server Setup of a new RFC destination: Declaration on an RFC server In SAP system, enter transaction SM59. The Configuration of RFC Connections window appears. Click button and fill the RFC destination parameters as shown: Activation Type: Chose Registered Server Program. Compleo Suite Installation Guide Page 50 of 71

51 Program ID: The Program ID is like a password, so it can be user specific. This parameter is used to uniquely identify the RFC server on the SAP Gateway. Thus two different SAP systems with identical program IDs, can connect to the same Supervisor. To connect a SAP system to multiple Supervisors each RFC server definition should have unique Program ID. SAP Recommendation to define Program ID: MACHINENAME.OPERATION (e.g. COMPLEOHOST.BCXOM_SERVER). Start Type of External Program: Chose Default Gateway value. CPI-C Timeout: Chose Default Gateway Value. Gateway Host: Enter the name of the SAP system that will host your Gateway. Gateway Service: Enter the name of the Gateway service that you want to use to communicate with Compleo. Gateway: This parameter is a communication junction for the SAP system and Compleo RFC server. Compleo registers itself on the SAP Gateway to receive the SAP request. In the RFC Server definition, enter this SAP gateway. When multiple SAP systems are connected to a given Supervisor, every system must share the same Gateway Host and service, for the requests to reach Compleo. Tips: Generally all SAP systems have the sapgw00 gateway installed by default. But the SAP Administrator can install a new SAP Gateway to use with BC-XOM, especially when high loads are expected. Click MDMP & Unicode tab. Select Unicode option. This option is available only in Unicode compatible SAP systems. Click button to save the settings. Ongoing back to the previous screen, the new RFC destination will appear in the TCP/IP connections list. Compleo Suite Installation Guide Page 51 of 71

52 Compleo Suite Installation Guide Page 52 of 71

53 2.2.2 CREATE A NEW ROMS (REAL OUTPUT MANAGEMENT SYSTEM) Enter transaction code SPAD. The Spool Administrator: Initial screen appears. Click Extended Admin and go to the tab Output Management systems. Then click Display button of Real Output Management Systems. The Spool Admin.: List of Real Output Management Systems appears. Click. Compleo Suite Installation Guide Page 53 of 71

54 The list of Real Output Management Systems is displayed here. In the extended toolbar, click to create ROMS. Enter the details in the OMS Description as shown. Enter the OMS Configuration. The OMS configuration should be exactly the same as Real OMS. Note: The Initialization Instance should be same as the RFC Destination defined while created the RFC connection as shown above. State of the options under OMS Attributes and SAP Configuration: Compleo Suite Installation Guide Page 54 of 71

55 Tasking Job Status Command Line RFC Server Query Deletable Polling Callback Device Status Query Queue Output Type Callback Fax Click Save and the OMS will be added in the list of real output management systems Create a new LOMS (Logical Output Management System) Enter transaction SPAD Extended Administrator Output Management Systems tab Logical Output Management Systems. The List of Logical Output Management Systems window appears. Click extended toolbar. Click. to display Logical OMS: Enter the LOMS name. Recommendation to define LOMS name: Use the entire 6 characters allowed to define an LOMS name. Avoid defining two names where one might contain another. For example, define LOMS1 and LOMS2 instead of LOMS and LOMS1. Compleo Suite Installation Guide Page 55 of 71

56 SAP configuration: Select the option as shown above: ROMS Tasking target Target for Callback Tasking Data by File Devices Queue query Callback Jobs Query Can be deleted Status query Choose the correct ROMS Enter the RFC Description, one that we created above. The system is automatically displayed by SAP This option is compulsory as suggested by SAP. This option will enable to use the External jobs button to see the device status and the list of waiting spools. This needs to be Select Callback checkbox. On selecting this check box Target for callback appears. In Target for callback enter the spool server name. This needs to be This option allows users to see the status of a spool waiting in Compleo. This needs to be This option allows users to delete any output request that has not been yet treated by Compleo. The user can then select the output request and click the delete button to delete it from the Supervisor list. This needs to be This option sends a pop-up when a successful or error message is send by Compleo for an output request. This is recommended to be Compleo Suite Installation Guide Page 56 of 71

57 OMS Configuration Select extended configuration button on the toolbar to display the details of OMS configuration. Click OMS configuration tab. Retain the default settings. OMS Callback Cache Print Requests: This is a callback period for jobs and should be decided depending Send Period on the load on the LOMS. Note: The smaller the value the faster is the callback and more CPU usage on the Compleo Server. It should not be less than 2 seconds for optimal usage. OMS Device This option updates the status of a device in case of change or pause in a scenario etc. OMS Configuration: This value has to be a HOSTNAME of your SAP system which will communicate with Compleo. If incorrect, Compleo will not accept the spools even if other actions seem to work fine. Click Save. The CMP_L LOMS will appear in the List of LOMS CREATE AN OUTPUT DEVICE Using the above created LOMS you can create multiple Output devices as per your requirement. Enter Transaction SPAD Output Device Display. Compleo Suite Installation Guide Page 57 of 71

58 This will show the list of output device available in spool administration. Click expand and will display other options of the toolbar. this will Click create new printer. The Spool Administration: Create Output Device screen will be displayed. Enter the printer name and its short name in Output Device and Short name text box respectively. In this case, use Compleo BC-XOM as printer name and CBX as short name. Select appropriate device type from the Device Type drop-down list. Select SAPGOF: Generic output format ASCII if you want to export in excel or change the content. Compleo Suite Installation Guide Page 58 of 71

59 Select Standard printer. Click Access Method tab. Select E: External output management system in Host Spool Access Method from the drop-down list. Enter host printer name in the Host Printer text box. Note: Host printer name should be exactly same as the Output Device or Short name. In this case it is Compleo BC-XOM. In Logical OMS select already created Logical OMS name from the drop down menu. Save the settings by clicking. Note: You do not need to install any other package on your SAP system to run the BC- XOM connector. Compleo Suite Installation Guide Page 59 of 71

60 3. INSTALLING SAP FUNCTION ZBC_COMPLEO_USER_GET_SNC Enter the transaction code SE80. Select Package from the drop down list. Enter Z_Compleo and press ENTER key. Click Yes to create the object. Compleo Suite Installation Guide Page 60 of 71

61 Enter Short Description and click. Click. The Prompt for local Workbench request window appears: Click to create a request. Compleo Suite Installation Guide Page 61 of 71

62 Enter a short description and click. Click. request and click Compleo Suite Installation Guide Page 62 of 71

63 Click. Thus the package is created. 3.1 Create Function Group Enter the transaction code SE80. Select Function Group. Enter ZBC_COMPLEO and press ENTER key. Compleo Suite Installation Guide Page 63 of 71

64 Click Yes to create the object. Enter a short text and click Save. Click. The Prompt for local Workbench request appears: Click. You will see the function group ZBC_COMPLEO has been created. Compleo Suite Installation Guide Page 64 of 71

65 3.2 Create Data structure Enter the transaction code SE11. Click on data type and enter ZBC_BAPUSNCU and click Create. Click Structure and click. Enter short description. Click Components tab and click. Compleo Suite Installation Guide Page 65 of 71

66 Enter Z_Compleo as Package and click. Click. Click to activate. The following warning message appears during activation: Click Yes. 3.3 Create function module Enter the transaction code SE37. Compleo Suite Installation Guide Page 66 of 71

67 Enter name of function module ZBC_COMPLEO_USER_GET_SNC and click create. Enter the Function group and Short text. Click. Compleo Suite Installation Guide Page 67 of 71

68 Go to Attributes tab and click Remote-Enabled Module. Then go to Table tab. Enter parameter name. Go to Source Code and enter the code. clear snc. refresh snc. SELECT usr02~mandt usr02~bname usracl~guiflag usracl~pname FROM usr02 LEFT JOIN usracl ON usr02~mandt = usracl~mandt AND usr02~bname = usracl~bname CLIENT SPECIFIED Compleo Suite Installation Guide Page 68 of 71

69 INTO CORRESPONDING FIELDS OF TABLE snc. ENDFUNCTION. Click. Then click to activate. 3.4 Test function module Enter the transaction code SE37. Click on the toolbar. Compleo Suite Installation Guide Page 69 of 71

70 Click and the result will be displayed. Compleo Suite Installation Guide Page 70 of 71

71 Index C CfgConverter.exe... 13, 16, 40, 41, 45 D Delete Destination Location Device Type... 47, 58, 59 E Evaluation Mode:... 9 F FavoriteConverter.exe Favorites H Host Printer... 48, 59 I ICASRV library Important note IP address iseries... 22, 24, 25, 43 iseries command L Libraries Licence Manager... 5, 10 Licence Manager Host license... 8, 9, 10, 23 license agreement... 8, 23 License Agreement... 8, 23 Licensed Mode... 9 Licensing Service M Macros Migrating... 40, 41, 42 module N NET Frame work Install... 7 Network Drive P PAT... 27, 28 ports... 6 product name profile... 7, 22, 24, 25, 41 R Rights required... 7, 22 S SAINT SAP GUI SAP R/3... 4, 26 SAP R/3 Connector SAP Server... 27, 29 Scheduled server... 10, 27 Service SPAD Start... 12, 13, 18, 22, 43 stop service Supervisor Symtrax Licence Manager... 5, 10 T Technical Support... 4 U Uninstall Compleo Suite Installation Guide Page 71 of 71