Home

rvsEVO - ServiceNet - T

1. Hint If the command is called via command prompt rvsbat can be termi nated by lt STRG gt C In the following chapters you find a detailed description of the commands 14 2 Create a Send Job with SEND CREATE Command Use the SEND CREATE or SEND C command of rvsbat script for sending files You can create a send job by starting rvsbat and entering the command in the command promt or reading the command from an input file see chapter 14 1 2 and 14 1 3 The successful transfer is confirmed in both cases via the message Command SEND CREATE successfully executed 208 rvsbat Batch Interface Syntax SEND CREATE DORIG lt originator EL lt label gt SER DSN lt filename gt SI OID gt CODEIN lt file code gt DORIG lt originator sid gt D ISP disposition FORMAT format MAXRECL lt length gt B IAL set id VFTYP lt set id OIDI D ETABLE table na ION set id SFS PTCERTSN lt serial N lt set id gt SI 1 W K ITTIME set id NOCOPY lt set id DEST receiver oid DSNNEW lt vdsn gt SID lt receiver sid CODEOUT lt set id me COMPRESSION lt set id ENCRYP set id ALG lt set id number CRYPTCERTIN issuer name GNCI ERTSN serial numb
2. RESENTR DELETE Or D delete a jobstart after receive Hint The commands are not case sensitive They can be added in abbreviated or long version and with blank or without e g RESENTR DELETE DSN TENNIS SID is the same as RESENTR D DSN TENNIS SID Syntax RESENTR CREATE DSN filename SID originator sid CODETABLE table name CODETRANS set id COMMENT text DSNNEW new dsn name ENABLED lt set id EXECSYNC set id EXECTIMEOUT lt set id JOB lt scrip name NEWDIR new directory name NEWNAME lt new file name PARAMHANDLING set id REPLACE lt set id SHELL set id SIDDEST receiver sid TSTAMP lt set id TSTAMPFORMAT lt set id VFTYP lt set id DISP set id ACCOUNT set id FLAGCOMP set id FLAGCRYP N LUID lt set id UID lt set id RESENTR parameters supported by rvsRVO Required parameters DSN SID oder SIDORIG Optional parameters CODETABLE CODETRANS COMMENT DISP DSNNEW ENABLED EXECSYNC EXECTIMEOUT JOB NEWDIR NEWNAME PARAMHANDLING REPLACE SHELL SIDDEST TSTAMP TSTAMPFORMAT VFTYP Parameters without function for compatibility with rvs portable ACCOUNT FLAGCOMP FLAGCRYP LUI
3. Press the Finish button to create the jobstart or NEXT to setup the parameters for starting a process Process Parameter Handling Shell Synchronized and Timeout Sync rvsEVO User Manual Version 6 01 Rev 28 10 15 125 Q T Systems rvs Systems rvsEVO User Manual Create a new After Fail Jobstart n oom So _ Process Start v Parameters for Starting a Process LR Process s C failure snd bat p Shell Synchronized Timeout Sync Parameter Handling ARGS 60000 Press the Finish button to create the new Jobstart After Fail The last window displays the most important parameters of the jobstart Hint Please see table Jobfilter elements on page 127 for the descrip tion of the parameters Note A JobStart after fail is launched if a job was changed to FAILED status or if active jobs were changed into an error status which requires an operator intervention e g Restart A JobStart After Fail is started also after a NERP was received The following situations activate a Jobstart After Fail Send transmission preprocessing fails status SP FAILED partner station is missing Jobstart After Send Attempts fails ENDED WITH JS ERROR SFNA Start File Negative Answer after connection establishment e g unencrypted file transmission while the neighbour station demands encryption FATAL l ERROR after SFNA e g the f
4. GUI name SID of Destination rvsEVO User Manual Version 6 01 Rev 28 10 15 217 Q T Systems rvs Systems rvsEVO User Manual Required Jobstart Parameters Parameter Description VDSN SENDJOB and FAILURE Path and name of the local file to send Allowed SID string and wildcard at the end the beginning or instead of the string Optional Jobstart Parameters Parameter Description ACCOUNT without function for compability with rvs porta ble ATTEMPTS Number of unsuccessful send attempts Suc cessful file transmission is indicated by 0 GUI name Send Attempts CODETABLE Alias of code table that is to be used if parameter CODETRANS 7 See parameter Conversion table in table Jobfilter elements on page 127 Example RESENTR C DSN C files test22 dat CODETRANS T CODETABLE ASCII IBMO37 DSNNEW TEST22 CODETRANS Defines whether a code translation has to be exe cuted Possible values no indication no code translation E EBCDIC ASCII conversion A ASCII EBCDIC conversion T your own conversion table that is indicated in CODETABLE parameter Please see also section How to add your own conversion table on page 133 COMMENT free text COMPRESSION no function for compatibility with rvs portable possible values N empty string DISP no function for compatibility with rvs
5. signEERP Requesting signed EERP possible values true yes false no Default false status Job status For possible status values please see the rvsEVO user manual chapter 4 5 dis patching a file timeStartFile Time of the transfer receipt system time in mil liseconds transferFileLength Sending Size of the file to be sent Sending Size of the file to be sent transmittedBytes Number of the actually transferred bytes user Number of the actually transferred bytes VDSN Virtual file name for Odette transfer virtualSID For future applications waitTime Time in milliseconds for a new start of transfer TransmissionFailWait Time after a failure TransmissionFailWaitTime Should be set in case of an SFNA Start File Negative Answer or EFNA End File Negative Answer Example lt JobInfoList gt lt JobExtendedDetails gt lt JobDetails gt externalJobId 5006 externalJobId lt JobID gt lt direction gt 0 lt direction gt jobNumber 091222132218000 jobNumber JobID lt compression gt false lt compression gt 186 Command Line Tools lt conversionTable gt lt conversionTable gt lt creationDate gt 22 12 09 13 22 18 lt crea tionDate gt lt deleteAllowed gt false lt deleteAllowed gt lt disposition gt K lt disposition gt lt direction gt SND lt dir
6. Description Path and name of the file from which the data are to be imported into the database Optional Parameters Parameter C clean Description To delete the old Observer data before new data are imported h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 18 exportOftpProxies Export of Proxy Bastion Instances rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 251 rvsEVO User Manual Use this tool to export the created Proxy Bastion Instances from the database into a file and replace a file with the same name if necessary Syntax exportOftpProxies f File r help verbose v Required Parameter Parameter Description f lt File gt Path and name of the file in which the Proxy file lt File gt Bastion Instances are to be imported Optional Parameters Parameter Description r To replace a file with the same name if neces replace sary If a file with the same name is present and this parameter was not set the process is failed with an error message h Displays a description of the current command help Displays a description of the current command V Verbose message output verbose 19 6 19 importOftpProxies Import of Proxy Bastion Instances U
7. Optional Parameters Parameter Description help Displays a description of the current command Requests help information 12 10 7 importTSL Use this tool to import a TSL Trust Service List into the rvsEVO database rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 197 rvsEVO User Manual Syntax importTSL f TSL filename URI gt o help verbose v sh lt host port gt sp lt password gt Required Parameter Parameter Description f lt TSL filename URI gt Path of the file which includes the TSL or URI for CRL download 0 Instead of parameter f Download and Import of TSL from Odette organisation http www odette org TSL TSL_OFTP2 XML Set the security parameters CRLUseHttpProxy CRLHttpProxyHost CRLHttpProxyPort before importing a TSL from the internet Optional Parameters Parameter Description verbose Verbose message output help Displays a description of the current command Requests help information Optional Remote Parameters Parameter Description Sp lt password gt Password of the client host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server sh host port 12 10 8 importComSecureKeyPair Use the program importComSecureKeyPair to import a ComSecure key pair from rvs
8. Export the existing queries with exportQueries script into a xml file see chapter 19 6 20 Parameter lt name gt refers to the query name Edit this parameter if necessary Import the queries from xml file into the database with import Que ries script and delete the existing queries with clear parameter see chapter 19 6 21 If there are no queries with default query name in the database you can execute createDefaultQueries script Syntax createDefaultQueries 19 6 2 downloadCRLs Use this tool for importing CRL s which are needed for certificates with CRL validation into the database rvsEVO server must be started Syntax downloadCRLs help verbose v Optional Parameters Parameter Description h Displays a description of the current command help 2 Displays a description of the current command V Verbose message output verbose 19 6 3 exportCertificateUsageDefinition Export of the Definition of Certificate Usage Use this tool to export the definition of certificate usage from the database into a file and replace a file with the same name if necessary rvsEVO User Manual Version 6 01 Rev 28 10 15 241 T Systems rvs Systems rvsEVO User Manual Syntax exportCertificateUsageDefinition f File r help verbose v Required Parameter Parameter Description f lt File gt Path and name of the file in which the data
9. Displays a description of the current command V Verbose message output verbose 19 6 7 exportCRLs export of a CRL Use this tool to export a CRL Certificate Revocation List from the database into a file and replace a file with the same name if necessary Syntax exportCRLs f lt File gt Erforderlicher Parameter r help verbose v Parameter f lt File gt file lt File gt Beschreibung Path and name of the file in which the CRL is to be imported 244 rvsEVO Database Optionale Parameter Parameter r replace Beschreibung To replace a file with the same name if neces sary If a file with the same name is present and this parameter was not set the process is failed with an error message h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 8 exportJobs Export of all Send and Receive Jobs Use this tool to export the transmission jobs from the database into a file and replace a file with the same name if necessary Syntax exportJobs f File Required Parameter r help verbose v Parameter f lt File gt file lt File gt Description Path and name of the file in which the transmis sion jobs are to be imported Optional Parameters Para
10. In this example RVS TSYSTEMS DE is an Oracle network service name and rvs a service name A network service name is needed to identity an Oracle database in a network This name should not be mixed up with the global database name although it has a similar syntax The service name identifies a database instance because several instances can run on the same computer jdbc user is the Oracle user and jdbc passsword is his password Note The Oracle connection data from the installation window are stored in the file SRVS_HOME conf jdbc properties 19 4 Connection Pooling With MS SQL or Oracle database rvsEVO offers the functionality connection pooling That means there is a pool which contains connec tions to the database If a connection is needed one connection of the pool can be used and it is not necessary to establish a connection for every access rvsEVO uses C3P0 Hibernate for connection pooling The settings for Connection Pooling can be done via RVS_HOME conf jdbc properties file Example of configuration with default values c3p0 minPoolSize 5 c3p0 maxPoolSize 25 c3p0 checkout Timeout 0 c3p0 maxIdleTime 0 c3p0 idleConnectionTestPeriod 60 c3p0 automaticTestTable POOLING TEST c3p0 acquireRetryAttempts 30 c3p0 acquireRetryDelay 1000 c3p0 breakAfterAcquireFailure false The most important parameter is c3p0 idleConnectionTestPeriod With this paramete
11. Press the Finish button to create the new Jobstart After Receive The last window displays the most important parameters of the jobstart Hint Please see table Jobfilter elements on page 127 for the description of the parameters Jobstart After Send Attempts In the following example the program c sendjob bat will be started after a file with the virtual filename T ESTEI L E was successfully delivered Send Attempts 0 from local station Loc to the neighbour station RVS Inthe first dialog the mandatory parameters must be entered Enabled and Send Attempts Comment SID of Originator SID of Destination VDSN 122 Automation with rvsEVO After Send Attempts Mandatory Parameters Required Parameters for creating a new Jobstart Trigger SND Enabled v Comment Testjs SID of Originator LOC SID of Destination RVS VDSN TESTFILE Send Attempts 0 Press the Finish button to create the jobstart or NEXT to setup the parameters for starting a process Process Parameter Handling Shell Synchronized and Timeout Sync Parameters for Starting a Process v Process C sendjob bat Parameter Handling ARGS Shell Synchronized Timeout Sync rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 123 rvsEVO User Manual Press the Finis
12. Support of Central Journal functions for more information see the Central Journal User Manual Support of SNMP Monitoring for more information see the rvs SNMP Agent User Manual Remote access to rvsEVO GUI Remote GUI Oracle database connection Microsoft SQL database connection PKI connection Multi instance operation rvsEVO is implemented in Java There exist four options of rvsEVO rvsEVO Enterprise Edition rvsEVO Standard Edition rvsEVO Light Edition rvsEVO Tiny Edition Please see chapter 1 2 to 1 5 for description Multi instance capability rvsEVO is implemented in Java There exist four options of rvsEVO rvsEVO Enterprise Edition rvsEVO Standard Edition rvsEVO Light Introduction Edition rvsEVO Tiny Edition Please see chapter 1 2 to 1 5 for descrip tion rvsEVO uses a batch interface and file system to communicate with the application If capable of doing so the linked application can indicate successful processing and indicate successful dispatch At present rvsEVO supports the following networks TCP IP TLS ISDN only for Windows XOT Proxy TCP IP and Proxy TLS For more information on supported platforms please refer to the SRVS_HOME doku readme txt release notes Note Please read the chapter 1 6 for the explanation of RVS HOME 1 2 rvsEVO Tiny Edition The Tiny Edition supports the communication with only one neighbour station rvs center
13. cluster nodes 10 177 xxx 1 10 177 xxx 2 10 177 xxx 3 Definitions of Cluster Properties Definition Description cluster group Name of the serverfarm has to be identical on name each node cluster node name Name of the node cluster node id Unique node identifier Possible values 0 9 e g first node cluster node id 0 second node cluster node id 1 etc You can also assign value 1 to the first node value 2 to the second node etc Default is 0 This value is part of the job ID fourth last posi tion cluster node ip IP address of the node cluster node port Port of the node default 5900 cluster node host names or IP addresses of the other nodes within the serverfarm seperated by commas 15 4 Update of rvsEVO Serverfarm Update of a server node runs nearly analog to an update of a single instance see chapter 2 4 rvsEVO update installation Please notice the following points Each node of the serverfarm has to be updated seperately 226 Multi Instance Functionality of vsEVO Before updateing you need not stop the server to be updated Initialize the database with updating the last node Do not start the rvsEVO server before the last node was updated rvsEVO User Manual Version 6 01 Rev 28 10 15 227 Q T Systems rvs Systems rvsEVO User Manual 228 ODETTE Protocol 16 ODETTE Protocol It is the purpose of the ODETTE File Transfer
14. rvsEVO User Manual Version 6 01 Rev 28 10 15 75 Q T Systems rvs Systems rvsEVO User Manual Parameter of rvsStationList xml Parameter Label Description Free text use this parameter for labeling the sta tion 76 File Transmission with rvsEVO 6 File Transmission with rvsEVO This chapter provides information concerning file transmssion and output of transmission data via Transfer perspective 6 1 User Interface of Transfer Perspective Select the menu item view in the function bar and thereafter the sub entry Transfer to open the Transfer perspective The illustration below shows the default view of Standard Edition File View Window Help Z7 E E Sr 2 Automation e Key Manage El Monitoring C Parameter Stations Transfer 23 amp Transfer Th Create New Transmission Qu Transmission Queries ACTIVE SEND JOBS ACTIVE RECEIVE JOBS ENDED JOBS FAILED JOBS fel Manage Templates RVS54 Standard Live Monitor Log Date Time Level Module Message 20140306 1153 INF CTRL CLEANUP_COMPLETED 20140306 1206 INF CTRL CLEANUP_STARTED m J RDDE9D84 3755 6 00 03 SNAPSHOT 2014 03 06 00 45 06 SE The symbols in the function bar provide the following functionalities Add New Query Create New Transmission Cleanup deletion of jobdata Create New Template Live Monitor Log
15. createsendJobRemote Insert nelp after a command for displayng the requested and optional parameters of the command Syntax activateStation help rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 189 rvsEVO User Manual Insert the he1p command and a keyword for receiving a list of all commands which refer to this keyword Insert help and TAB key for listing the possible keywords help jobstart displays a list of all commands which refer to a jobstart rvscli help jobstart createJobstart Command to Create New Jobstart deleteJobstart Command to Delete Jobstart displayJobstart Command to Display Jobstart Details for given Jobstart ID list3obstarts Command to Display Jobstart List updateJobstart Command to update existing Jobstart Parameter value containing space should be enclosed with for e g rvscli gt Insert the first characters of acommand and the TAB key for listing all commands beginnig with the entered characters If you enter cre TAB the following output is displayed rvscli gt create createcsR createJobQuery createJobstart createobserver createproxy createReceiver createsendJob createStation createuser rvscli gt create 12 6 restartListener Use the restartListener tool to restart a listener Syntax restartlistener restart start stop n 1 help verbos v Optional Parameters Parame
16. Active only in connection with OFTP 2 0 CMS see parameter Security Feature Set in this table The following algorithm are possible None DES DED3 CBC Triple DES AES256 CBC File Signature Active only in connection with OFTP 2 0 CMS see parameter Security Feature Set in this table If the checkbox is activated file signature takes place 84 File Transmission with rvsEVO Security parameters Parameter Description Request signed EERP NERP Active only in connection with OFTP 2 0 CMS see parameter Security Feature Set in this table In OFTP 2 0 there is a possibility to request the signature of the EERP or of the NERP Your partner must support OFTP 2 0 in this case If the checkbox is activated signed EERP or NERP is requested and the sendjob ends in FAILED status if your partner sends no signed EERP or NERP Other Optional Parameters Parameter Description Hold If the checkbox is activated the send job is crea ted in HOLD status Schedule With this parameter you can define what time the SendJob should be launched Press the icon on the right to select date and time Default at once Serialization If the checkbox is activated the files will be sent in the same order as the send jobs were cre ated The next job will only be sent if the previous is completely finished All send jobs for the serialization mus
17. Add a routed station by a right click on the neighbour station and there after selecting the item Add routed station from the context menu The dialog box below opens and you can set up the mandatory parame ters SID Station ID of routed Station and Odette ID please see OFTP parameter group in chapter 5 3 3 Parameter Groups of the Partner Station r essen een Mandatory Parameters of Routed Station Mandatory Parameters of Routed Station SID 9 Odette 1D o OFTP Version 2 0 Y Bacl Next Finish Cancel There other parameter groups of routed stations are OFTP Optional Parameters OFTP File Service Proxy Parameters and Contact Details Please see Chapter 22 PKI Connection for getting information of PKI and Certificate Validation Type Parameters The description of the other parameters you can find in chapter 5 3 3 Parameter Groups of the Partner Station Hint 70 Management of Stations You can add a routed station with identical settings to an existing station Right click the routing station that is to be duplicated and select Duplicate Station entry from the combo box The settings of the duplicated stations are used as default values of the new station SID and Odette ID parameters must be changed The remaining parameters can also be edited if neccesary 5 4 2 Setting up a Routed Station Please see chapter 5 3 2 Setting up of a Neighbour Station The
18. If you choose an existing directory you are asked to choose another directory name Define the program group to install rvsEVO icons in the dialog below Hint The Checkbox Create Icons for All Users must be enabled if this setting should be valid for all users Where would you like to create product icons In a new Program Group rvsevo In an existing Program Group rvsEvo In the Start Menu On the Desktop In the Quick Launch Bar Other Choose Don t create icons Create Icons for All Users 22 Installation The following dialogs refer to installation of Enterprise Edition only With installation of rvsEVO Enterprise Edition you can choose the database in which your data should be saved Oracle and MS SQL database are available Important You cannot run rvsEVO Enterprise Edition with Derby database Choose a persistence mechanism how the rvsEVO data will be stored into a database using Hibernate Derby on Surdi Install Cornolats Set your Oracle connection parameters if you decided to use an Oracle database jdbc url has the following syntax jdbc oracle thin lt server gt lt port gt lt service_name gt server is the name or IP address of the machine where Oracle server is installed Default port for Oracle is 1521 service_name is Oracle service name jdbc user is the user setting up
19. If you want to remove other components please select bellow Y Remove rvs database V Remove inbox outbox and archive files 7 Remove all other files logs user files The next window displays the components which have not been deleted Click on dones in order to exit the uninstalling program Unix use the shell script RVS HOME UninstallerData Uninstall rvsEVO StandardEdition sh Uninstall procedure on UNIX systems can be executed analogous to rvsEVO installation Following modes are available awt silent and console Forthe graphical mode awt the system environment variable DISPLAY must be set for the X server see example in chapter 2 3 2 The uninstall routine is executed in the console mode by default The uninstall queries are the same in all modes 32 Start and Stop of rvsEVO 3 Start and Stop of rvsEVO 3 1 Starting of rvsEVO Server The server is to be started before the graphical user interface can be started Windows Start the rvsEVO Server either via the program group Start All Programs gt rvsEVO gt Server or via command line SRVS_HOME bin startServer bat Unix Start the shell script SRVS_HOME bin startServer sh Hint You get the following error messages if you try to boot an already started rvsEVO server java sql SQLException Failed to start database C rvsEVO db with class loader sun misc Launcher java sql SQLException Anothe
20. ODETTE FTP READY Odette ID password SSID gt buffersize credit lt SSID Odette ID password etc StartFile ID name size SFID gt format lt SFPA StartFile Positive Ans wer nN data records DATA gt DATA gt DATA gt rvsEVO User Manual Version 6 01 Rev 28 10 15 229 T Systems rvs Systems rvsEVO User Manual send n data records EndFile ID byte count Change Direction Network disconnect lt CREDIT ats DATA gt D DATA gt as EFID gt lt EFPA or lt EFNA CD gt lt EERP or lt NERP ge ESID send credit value n EndFile Positive Ans wer if store successful and byte count correct EndFile Negative Ans wer End to End Response Negative End to End Response acknow ledge End Session ID Network disconnect 230 rvs OFTP Proxy 17 rvs OFTP Proxy This chapter describes the configuration and the functionality of rvs OFTP Proxy implementation in rvsEVO 17 1 Basics Internet Internet is increasingly used also for transferring the commercial and business critical data of the content Such advantages are deciding factors for this such as its wide distribution enormous available band widths and the reasonable transfer costs These advantages are accompanied by th
21. Reset Perspective Below the nevigation tree provides the following entries Create New Transmission Transmission Qeries Manage Templates rvsEVO User Manual Version 6 01 Rev 28 10 15 77 T Systems rvs Systems rvsEVO User Manual Hints for local delivery Templates Via a mouse click on the small arrow to the left of Transmission or Manage Tempates entry your queries and templates can be blended or blanked The Live Monitor Log View is positioned at the bottom of the GUI 6 2 Create a Send Job Hints Instruction for entering the parameter values If the input field includes an arrow you must select one of the specified values from the combobox In input fields without arrow you must directly write the value into the input field Exeption Station IDs can be written into the input feld or selected from the combobox If you enter the value dircetly into the input field you can use the wild cards and A checkbox is to be enabled or disabled by single click in the checkbox There are two ways for sending files to the own local or virtual station Looptest The file is transmitted via a neighbour station back to the own station For this procedure LooptestNeighbourSID parameter has to be set see chapter 10 7 ODETTE Parameters Local delivery without network connection For this procedure Looptest NeighbourSID parameter must not be set see chapter 10 7 ODETTE Parameters F
22. Right click a certificate in the list view and select Export Certifi cate to ComSecure to export a public key in X 509 format into a ComSecure format 8 4 10 Import of a ComSecure Key Pair This functionality is important for migration from rvs portable to rvsEVO Right click the Private Keys entry in the navigation tree and select Import ComSecure Private Key from the drop down menu to open the dialog box shown below for importing a ComSecure key pair or press the icon Import ComSecure Private Key at the upper right border The private and public key and the station ID for which the key pair is imported can be selected Further you can insert a label for the functional assignment and some additional information 114 Secure Transmission with rvsEVO r f Import ComSecure Private Key Soa Import ComSecure Private Key a This dialog is used to import comsecure private key Public key 9 Browse Private key Station ID 4 Label Common Name CN 9 Organization Unit OU l Organization Name O Locality Name L State Name ST Country C Email E 8 4 11 Deletion of a Certificate Private Key Pair Right click the certificate or key pair which should be deleted in the list view and select Delete Certificate Delete Key Pair fromthe drop down menu Confirm the subsequent security query to remove the key 8 4 12 Automatic Certificate Exchange
23. Set as default SID Originator LOC SID Destination File a I VDSN Format U unstructured Max Record Length 0 Record Mode TXT Record Mi Conversion Table Feed the name of the template in input field Template Name Your template will be saved in Manage Template entry of navigation tree If a template should be used by default activate the Default checkbox Hint Please see chapter 6 2 1 Send Parameters for the description of the other parameters The procedure of creating a template is analogue to creating a send job Right click the template to be changed and thereafter select the entry Edit Template for changing a template The window Update Template for Send Job is opened and the parameters can be edited Press Finish button to save the template Right click the template to be removed and thereafter select the entry Delete Template for removing a template Press Yes Button to delete the template 6 4 Click the Cleanup icon in the toolbar for deletion of ended and failed jobs from the database The jobs which are older than the entered date and time will be deleted Deletion of Job Data from Database 86 File Transmission with rvsEVO r 4 Cleanup Database ee Cleanup Database Cleaning transmissions older than a given absolute date Possible date formats yyMMDDHHmmss or yy MMDD Cleanup Date 15 04 2014 jv 11 38 32 6 5 D
24. The symbols in the function bar provide the following functionalities Create Private Key ACX Request Certificate rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 107 rvsEVO User Manual List view ACX Deliver Certificate ACX Replace Certificate Live Monitor Log Show Active Panel Show Reset Perspective rvsEVO User Manual At the bottom of the GUI the list views of certificates and CRL s and the Live Monitor Log View is displayed 8 4 2 Necessary Steps for Encrypted Transmission via rvsEVO Create your own key pair see chapter 8 4 4 Export your own public key in form of X 509 certificate see chapter 8 4 6 Send the own public key to your partner via email or rvsEVO The partner has to import your X 509 certificate public key and send his X 509 certificate to you You also have to import the partners X 509 certificate into the key management of rvsEVO see chapter 8 4 7 Associate your own key via Stations Management detailed view of local station gt parameter group Keys Associate the certificate of your partner via the parameter group Keys of the partner station Hint for TLS encryption The private key can only be associated if a TLS listener was created see chapter 5 2 2 In chapter 6 2 Create a Send Job you get information about transmitting encrypted files 8 4 3 Display Certificates Lists of certificates can
25. rvsEVO User Manual Y _Cleanup MonLog Database nn an _Cleanup MonLog Database 3 Cleaning MonLog older than a given absolute date Possible date formats yyMMDDHHmmss or yy MMDD Cleanup Datum 05 2014 jv 11 23 21 k 4 You can also execute this functionality via clenaup commandline tool 7 4 Monitor Log Queries Hint This functionality is only available for rvsEVO Enterprise Edition if using an Oracle or MS SQL database Monitor Log queries can be configured via Monitor Log Queries entry in the Monitor Tree View Via a single click on the arrow on the right next to the Monitor Log Query entry and selection of MONITOR LOG QUERY from the drop down menu the query view opens 100 Monitoring File View Window Help alg 3 amp Automation ME Key Management El Monitoring Parameter B Stations iy Transfer Pers Monitor Tree View 23 amp O Monitor Log Query MONITOR LOG QUERY 2 BB Monitor Tree View Monitor Log Query MONITOR_LOG_QUERY 5 Live Monitor Log 5 Monitor Log Queries MONITOR LOG QUERY E Monitor Log Files E Active Panel Order By Field Preset Filter Level Module Node Message Text Date Time Message Session Station Job Live Monitor Log Date Time Level Instance Module Message 20130709 081429 INF rvsEVO Node CTRL ARCHIVE COMPLETED 20130709 081430 INF
26. 5 6 2 Display Proxy Bastions Click the Proxy Bastion List icon in the function bar to display all configured Proxy Bastion instances The list is output in a new view Via double click on an entry of the Proxy Bastion list you get the detailed view of the Proxy Bastion 5 6 3 Setting up Proxy Bastion Open the detailed view for setting up the parameters and confirm your changings with a click on the button Save Restart rvsEVO server to enable the changes Important It is to be considered that these parameters are customised also in the start script RVS_HOME bin bastion cmd RVS HOME bin bastion sh 5 6 4 Delete Proxy Bastion Right click the Proxy Bastion in the list view and select the item Delete Proxy Bastion from the context menu to remove a Proxy Bastion Another possibility to remove a Proxy Bastion is to assign the Proxy Bastion in the list view and then click the icon Delete Proxy Bastion in the function bar 5 7 Station Configuration via rvsStationlist xml On the other hand the station configuration can be done via the XML station configuration file RvS HOME conf rvsStationlist xml The StationLoc element in the configuration file is equivalent to the Local Station in the GUI StationNeighbour is Neighbour Station StationRouted is the Routed Station and Stat ionVirtual is the virtual station in the GUI 74 Management of Stations Abstract of rvsStationlist xml file lt x
27. ted to ComSecure Optional Parameters Parameter Description ki lt keyIndex gt Index of the certificate to be exported You find the index in the list view and detailed view of a certificate cf certificateFilename Name of the file help Displays a description of the current command Requests help information 12 10 5 importComSecurePublicKey Use this tool to import a ComSecure public key into the rrsEVO database Syntax importComSecurePublicKey sid StationID ckf comsecureKeyFilename dn lt dname gt help 196 Command Line Tools Required Parameter Parameter sid lt StationID gt Description ID of the station to which the certificate is to be assigned Optional Parameters Parameter ckf lt keyIndex gt Description Name of the certificate file that contains the public ComSecure key dn lt dname gt Clear designation of the key owner help h Displays a description of the current command 12 10 6 getCertificateList Requests help information The tool getCertificateList shows the certificate list of a special station D Syntax getCertificateList sid lt stationID gt help Required Parameter Parameter sid lt stationID gt stationID lt stationID gt Description ID of the station whose certificates should be listed
28. Copy to copy one or more jobs from the job list and insert them into a text file Restart SP after bug fixing to activate a job in SP FAILED status Delete EERP Forced Delete allows to delete an active job without pausing it before Release EERP Release NERP Ended Transmissions Open in New View Copy to copy one or more jobs from the job list and insert them into a text file Recreate only for ended send jobs Cleanup deletion of transmission data from the database Failed Transmissions Open in New View Copy to copy one or more jobs from the job list and insert them into a text file rvsEVO User Manual Version 6 01 Rev 28 10 15 95 Q T Systems rvs Systems rvsEVO User Manual Recreate only for send jobs Cleanup deletion of transmission data from the database 96 Monitoring 7 Monitoring In this chapter you find out how to output rvsEVO messages and warnings 7 1 User Interface of Monitoring Perspective With default view Log Messages are normally displayed in the bottom of the GUI window You can view new and old messages via Monitoring Perspective The Monitoring perspective is reachable via menu item View gt Stations Theillustration below shows the default view of Monitoring perspective in Standard Edition lalx Fie View Window Help E E3 Transfer Monitoring EF Stations EX Key Management e Automation 0 Parameter iC User Manag
29. Parameter Su user Description Client user for remote login Sp password Password of the client sh lt host port gt Hostname and port for remote login 12 3 File Transmission This section contains the command tools for file transmission and display of job data 12 3 1 activateStation Use the activateStation program to activate a direct neighbour station or to activate the station and induce file transmission from this station Syntax activateStation s lt SID gt verbose help lt host port gt p lt password gt nt su lt user gt sp lt password gt sh 168 Command Line Tools Required activateStation Parameter Parameter Description s lt SID gt Station ID to be activated Optional parameters Parameter Description p lt password gt Set this parameter for temporary overwriting of the Odette Send Password in stationlist Only this connection is set up with this password nt Set this parameter to activate the neighbour sta tion without introducing file transmission verbose Verbose message output help Displays a description of the current command 2 Requests help information Optional Remote Parameters Parameter Description su lt user gt Client user for remote login Sp password Password of the client sh lt host port gt host is th
30. Previous rvsEVO installation found in C wsEVO63 Update current risEVO or install a new version Cancel Update I nthe next dialog you are given a brief overview of selections you have made installation directory link directory The required and the currently available disk space is also displayed Press the Next button to start installation The last window informs you about the successfully installation of rvsEVO Finish the installation routine by pressing Done button e Use the tool RVS_HOME tools importKeystores for importing the certificates from old keystore files into the rvsEVO database see chapter 19 6 14 importKeystores Import of a Keystore File Important During the update installation a new RVS HOME conf rvs system properties new file is added Please take over the configurations of your old rvs system properties file to the new one and rename rvs system properties newin rvs system properties In case of an update installation from rvsEVO Release 5 XX to 6 XX the certificate usage has to set up again This configuration can be done via station configuration gt parameter group Keys 2 5 Migration from rvs portable to rvsEVO Requirements For migration of settings from rvs portable you have to consider the following requirements an executable rvs portable must be installed on your system migration should only be started if the absence of communication has
31. SRVS HOME 1og rvsClient 1og file The maximum file size and maximum number of rvsClient 1og files can be defined in the element appender name Standard in the SRVS_HOME conf rvsClientLogger xml file Maximum size use the function maxFileSize 204 Setting Up of the Log and Trace Files Syntax lt param name maxFileSize value 2097152 gt Maximum number of log files use the function maxBackupIndex Syntax lt param name maxBackupIndex value 10 gt 13 4 rvsClientRCP log File The warnings and error messages of the rvsEVO clients RCP GUls are saved in RVS_HOME log rvsClientRCP 1log file The maximum file size and maximum number of rvsClientRCP log files can be defined in the element appender name Standard in the RVS HOMENconfNrvsClientRCPLogger xml file Maximum size use the function maxFileSize Syntax lt param name maxFileSize value 2097152 gt Maximum number of log files use the function maxBackupIndex Syntax lt param name maxBackupIndex value 10 gt 13 5 Trace Files The trace files contain the transmitted Odette data packages The name is composed as follows StationID and and SessionID and trc extension e g RVSEVO_6372170 trc Trace files are saved in SRVS HOME log trace odette directory Enable the tracing functio nality via Traceltem parameter see table OFTP Parameters on page 151 rvs
32. cee eee 192 12 9 archiveJob Deletion of an Individual Job from the Database 192 12 10Key Management with TvSEVO ar sans er ERR Ree a eee E RS EE 193 12 10 TdeliverCertificale 4 x kare 22 Rp hee rx e m qe Ree eee obere uma 193 12 10 2requestGertifiale 6s v dative p EE pal ke isle qa EUR e ren 194 12 10 3replaceGertificate nana Rex Ret Rr x RR CE gy rane RET EE 195 12 10 4exportCertificate2ComSecure 00 nh 196 1210 5imponGomsecurePuBlicKeyiers 2 2 acc ees d Reed ede eves uc Pas 196 12 10 698e1Gerlificatelist a ana ares tame ERE ERE AE URL ERO S PE ru 197 To AO AIMONS o coros aodio dex snd tat Ohare t eee oe euet ad ps RP aaa eee fe nig 197 12 10 8importComSecureKeyPair a ou ae lad ek eso ev eR eR ER QUEE X Vae are 198 1o ShOWCOBES us ots eos cocus UA p tM ere cdd to A x 199 12 12Display Monitor Messages o ee cR ee SAS ER eee Ce Rs 199 12 12 1showMonitorLog Trace Current Monitor MessageS 000 ee eee eee eee 199 12 12 2showMonitorLogFile Show Earlier Log MesssagesS 00000 cece eee 200 12 13Command Line Tools to Start and Stop rvSEVO 2 ee 200 12 14Command line tools for internal use 0 2 0 eee 201 13 Setting Up of the Log and Trace Files 2 ce eee eee 203 T9 aT cronibr log PIG zen de os tars Ae ead decet on ae Ee UN Ree BM EB acide A 203 13 2 TVS OO MR ee Se aie Pan eee we Be es ed ele ae 204 13 3 rvsClient log File ok EC Uu Hp EET 204 13 4 rysClient
33. portable possible value K 218 rvsbat Batch Interface Optional Jobstart Parameters Parameter DSNNEW Description With this parameter you can save the received file with another name and path no indication the file is saved with current name in inbox directory indication of new path and name the file is saved in the indicated directory with the new name ENABLED With this parameter you decide whether the job is to be started or not Possible values Y Yes the job is started default N No the job is not started ENCRYPTION no function for compatibility with rvs portable possible values N EXECSYNC With this parameter you indicate if the OFTP ses sion is kept alive until the process is finished Possible values y session is kept alive N Default GUI name Synchronized EXECTIMEOUT If setting EXECSYNC v Time Out after the con nection is closed by the communication program GUI name Timeout Sync FLAGCOMP no function for compatibility with rvs portable Possible values N empty string FLAGCRYP no function for compatibility with rvs portable Possible value N empty string JOB Program to be started if all filter conditions apply A defined set of parameters is transmitted to the program GUI name Process LUID no function for compatibility with rvs portable Possibl
34. procedure is the same with all stations 5 4 3 Further Functionalities A right click opens a drop down menu which offers the following additi onal options Open In New View Delete Entry Certificate Request to one Station and Certificate Deliver to one Station The description of this functionalities you can find in chapter 5 3 Neighbour Stations 5 5 Virtual Stations Virtual stations are used to represent stations outside the OFTP network for the OFTP network They allow files to be sent to destination stations outside the OFTP network ODETTE IDs uniquely define the stations in an OFTP network Each virtual station must also be assigned an own ODETTE ID A virtual station can also send and receive files 5 5 1 Adda Virtual Station Add a virtal station by a right click on the local station and thereafter selecting the item Add Virtal Station from the context menu The dialog box below opens and you can set up the Mandatory Parameters SID Station ID of virtual Station and Odette ID please see OFTP parameter group in chapter 5 2 2 Parameter Groups of Local Station rvsEVO User Manual Version 6 01 Rev 28 10 15 71 T Systems rvs Systems rvsEVO User Manual LA a on B Mandatory Parameters of Virtual Station Mandatory Parameters of Virtual Station SID 9 Odette ID The other parameter groups of virtual stations are OFTP Optional Para meters
35. rvsEVO automatically assigns and manages this number Default 1 X 25 Address lt Address gt 15 digit X 25 DTE address of the partner station X 25 Closed User Group ISDN and X 25 allow for the formation of a closed user group All members of such a group can communicate with each other via the public tele communication network Connection requests to group members received from participants not being a member of the closed user group will be rejected by the switching exchange The same applies to connection requests from group mem bers to participants not being a member of the closed user group This service attribute is called Closed User Group CUG X 25 DBit D bit Delivery Confirmation an X 25 data packet flag used to request end to end acknowledgment for the packet X 25 Facilities Special information or facilities for an X 25 trans mission see the information of the X 25 service in use X 25 PacketSize lt PacketSize gt Size of date packets during data transmission X 25 Userdata User data for an X 25 transmission see the infor mation of the X 25 service in use rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 67 rvsEVO User Manual ISDN Parameters Partner Parameter X 25 Window Size lt WindowSize gt Description window size 7 recommended for ISDN window size 2 recommended for X 25 native Note Window size
36. see parameter Agen tHostname and AgentPort Default 30000 AgentHostName Agent computer name or IP address Default localhost AgentLogLevel This parameter defines which kind of log messa ges rvsEVO sends to the Agent Possible values 0 no log messages are sent 1 error messages are sent 2 warnings and error messages are sent 3 warnings information and error messages are send AgentPort Agent IP port Default 3744 10 7 ODETTE Parameters In this group you can set the parameters for Odette transfer 150 Customizing the Global rvsEVO Parameters ini xl File View Window Help Bee transfer E Monitoring F Stations Key Management f Automation Parameter i User Management P Parameter 52 amp 5 E Parameter ODETTE 23 Ban Parameter Parameter ODETTE Parameter Groups BASIC CENTRAL_JOURNAL Parameter Name Parameter Value ConnSetupFailWaitTime 10000 DIRECTORIES ConnSetupProxyFailCount 0 MAINTENANCE ConnSetupProxyFailScript NOTIFICATION LooptestNeighbourSID ODETTE MaxSessions 20 RESOURCES CHECK MaxSessionsISDN 7 OFTPTimeout 30000 SessionAliveTimeout 60000 SessionWaitTime 0 Timestamp N Traceltem N TransmissionFailWaitTime 30000 Gancel Active RDDESAKIJ 3755 6 01 00 SNAPSHOT 4 08 00 21 03 EE OFTP Parameters Parameter Description ConnSetupFailWaitTime Time in milliseconds rvsEVO waits after a con nect
37. the letter O an 18 character organization identifier provided by the ODETTE codification group and 46 Management of Stations a6 character computer sub address that is administrated by each organization Note If you communicate within your own closed network only the ODETTE ID may be freely chosen as long as it remains unique in your network Please see Chapter 22 PKI Connection for description of PKI and Certificate Validation Type parameters Keys In this parameter group the certificates and public keys are listed You get the following information Type Index Label Valid From Valid To Status The key you set up at first gets the default label by default In the check box Default Certificate you can edit this setting The block Key Usage offers the possibility of functional appropriation Key Usage Parameters of Local Station Parameter Description OFTP2 File Signature Select the certificate using for file signature by default OFTP2 Response Signa Select the certificate using for EERP NERP ture signature by default ComSecure File Signa Select the certificate using for signature of ture files which are encrypted via ComSecure Parameters of Key Usage for TLS Remote TLS Listener TLS 1 Certificate which is used for TLS encryption by default Listeners Your local station can receive the data of a neighboursta tion via several data lines and networks I
38. 12 EUO54 EUO54 CLUSTER PROPERTIES getJobList a Result mu state SENDED state SENDED state SENDED state SENDED state gt SENDED with return code A ZZ mus EU O GOOOL b in gt 12 4 2 getJob Information on a job entry Use get Job program to receive information on a particular job Syntax getJob n lt jobid gt a verbose v su user sp password sh lt host port gt 180 Command Line Tools Required Parameter Parameter Description n lt jobid gt Information on a send or receive job with ID lt jobid gt Optional Parameters Parameter Description a All available job information is given verbose Verbose message output help Displays a description of the current command 2 Requests help information Optional Remote Parameters Parameter Description SU user Client user for remote login Sp password Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server Example getJob n 040329175603000 Result job 040329175603000 SND state WF EERP 12 4 3 getJobInfoList Create an XML File for an External JobID Use the program getJobInfoList to create an XML file for an external JobID The detailed information of all jobs which refer to the external JobID are stored in this file Syntax getJobInfoList xid exte
39. 146 Customizing the Global rvsEVO Parameters Cn xmi File View Window Help BEC Monster Ei Monitoring F Stations 53 Key Management Automation Parameter 2 User Management 0 Parameter 23 amp EB E Parameter MAINTENANCE 22 amp n Parameter Parameter MAINTENANCE Parameter Groups BASIC Parameter Name Parameter Value CENTRAL_JOURNAL ON un DIRECTORIES CleanupDays 7 MAINTENANCE CleanupInterval 1440 NOTIFICATION CleanupTime SERIE MailLocalAddress en MailSMTPHost MaxRevisionLogCount 1000 MaxRevisionLogSize 1000000 MonlogInDatabase N MonlogInDatabaseCleanup NONE PermissionTempScript 770 PersistenceArchive RevisionLog xml RedoLog N Save Gancel Active RDDESAKI 3755 6 01 00 SNAPSHOT 2015 04 08 00 21 03 EE Parameters for Operation and Maintenance Parameter BackupOnStartup Description Use this parameter to specify an automatic backup performed on each time you start rvsEVO Possible values Y default each time when rvsEVO will be started the directories RVS_HOME conf files systemund jobs are saved ina jar file in SRVS_HOME archive directory Also data base data are saved The name is a composition of date time and counter in format YYMMDD hhmmssccc jar N no automatic backup CleanupDays Specify days for cleanup of completed or failed jobs The archiveJobs program will delete any jobs older than the time specified in th
40. 4 ta Parameter Groups BASIC CENTRAL_JOURNAL CertificateExpirationError 7 DIRECTORIES CertificateExpirationMail MAINTENANCE CertificateExpirationWarning 30 NOTIFICATION CriticalDiskSpace 100000 ODETTE DiskSpace 150000 RESOURCES CHECK DiskSpaceCheckEnabled Y SECURITY Mail user company de RevStopDiskSpace 120000 SuspendTime 600 System Parameter Name Parameter Value Time Live Monitor Log 23 le Active RDDE9D84 3755 6 00 03 2014 0 10 09 33 30 SE Resource check All active directories of rvsEVO will be checked DB TEMP INPUT OUTPUT ARCDIR und LOGDIR In case of the low disk space you can see in the Monitor Log a message that informs you in which rvsEVO directories is not enough disk space At the same time an E mail to the responsible administrator will be sent There are three levels of resource lack first level a warning will be dispayed second level all receivers will be stopped so that no file transfer will be possible third level all processes and rvsEVO itself will be ended rvsEVO User Manual Version 6 01 Rev 28 10 15 153 T Systems rvs Systems rvsEVO User Manual Certificate check Checking of expiration dates of your own keypairs and the certificates of your partners If a certificate expires in preset time a message will be issued in the Monitor Log Parameters for Certificate and Resource Check Pa
41. CREATE Example for creating a jobstart after send attempt rvsEVO User Manual Version 6 01 Rev 28 10 15 215 Q T Systems rvs Systems rvsEVO User Manual Update Delete SENDJOB c SIDDEST EVO54 SIDORIG LOC VDSN TESTF ATTEMPTS 0 JOB C rvsTest scripts sendjob bat ENABLED Y After successful transmission ATTEMPTS 0 of a file with a virtual filename that includes the character set TESTE from station LOC to station Evo54 the job C rvsTest scripts sendjob bat is started Hint One of the parameters SID SIDDEST VDSN and ATTEMPT has to distinguish from existing jobstarts after send attempt Example for updating a jobstart after send attempt SENDJOB u SIDDEST EVO54 SIDORIG LOC VDSN TESTF ATTEMPTS 0 JOB C rvsTest scripts sendjob bat ENABLED N In this example the priviously created jobstart after send attempt is disabled ENABLED Nn Hint The parameters SID SIDDEST VDSN ATTEMPTS and SIDORIG must be identical to the jobstart that is to be updated SIDORIG only if indicated with creation Example for deletion of a jobstart after send attempt SENDJOB d SID EVO54 SIDORIG LOC VDSN TESTF ATTEMPTS 0 The previously created jobstart after send attempt is deleted Hint The parameters VDSN ATTEMPTS SIDDEST and SIDORIG are requested SIDORIG only if indic
42. Display Gertilicatesz i ceil gue ears eR reete bac ue eb ed erat des 108 8 4 4 Generate a Key albe rone hh tu ane Ae eas ALMUS dol s rcd id 109 8 4 5 Use of CA Certificates eter men ee ee Bae RUE TUE pa arg 111 8 4 6 Export of the Own P bliG K6y so 2 2 ee ERE PEERS eR tps 112 8 4 7 Import and Export of a Partner Certificate llle 113 8 4 8 Import and Export of a Private Key Pair llle 113 8 4 9 Import and Export of ComSecure Public Keys 000 cece eee ee eee 114 8 4 10Import of a ComSecure Key Pair 0 0 cee ee 114 8 4 11Deletion of a Certificate Private Key Pair 0 0 00 eee eee 115 8 4 12Automatic Certificate Exchange via rvsEVO GUI 0 0000 eee 115 rvsEVO Benutzerhandbuch 9 Automation with rvSEVO s cese uhr aan 119 9 1 The User Interface of Automation Perspective 000 0 eee ee eee 119 9 2 JODStANS nass ans as ee en EA cix edes tea uM Ee en 120 9 21 Creating axdobStart cts east hr ea ete dee ioo ORC be P E DRM 120 9 2 2 Jobstart Parameters seg lk eo oe ERU EE EGG meu See ES EAR TEES 127 9 2 3 Displaying JODSIANS 2 01 2 x auc fa E Re eter CQ IO Ais eo wet Rie e ug 134 d e d Edi ddobsidil eec dba teeta ee te stare m ioo i deme da Lm Mss 135 9 2 5 Delete a JODSIBIT os Soe Hr Re PEE ERECPEGauneP bee pe te xx E 135 9 3 ODDSEN Eran ee n pp E MCCC DPF M 136 9 3 1 Greate am Observer onc ee kein Me nu ar Eb 136 9 3 2 Displaying Observer C eom
43. Displays a description of the current command V Verbose message output verbose Parameter Description sh lt host port gt Hostname and port for remote login Sp lt password gt Password of the client 12 2 updateStationList With the updateStationList program you have the possibility to set up the stations with a command tool at run time For this an XML file which contains all information about the stations you would like to modify mustbe generated Thecontentofthis file is described ina XML pattern SRVS HOME system data xsd stationList xsd For each station an additional XML element function is necessary Possible directives insert add a new station update modify existing stations rvsEVO User Manual Version 6 01 Rev 28 10 15 167 Q T Systems rvs Systems rvsEVO User Manual delete delete a station the own station cannot be deleted Syntax updateStationList f xml filename r failed stations xml Requested Parameters file name su username sp password Parameter f xml file name Description Name of the XML element which contains inform ration about the stations r failed stations xml file name Name of the XML file which contains the stations with failed update Optional Parameter Parameter Description 2 Requests help information Optional Remote Parameters
44. Monitoring Parameter eF Stations in Transfer 5 User M E Parameter 22 amp 7 O E Parameter CENTRAL JOURNAL 3 S Parameter Parameter CENTRAL JOURNAL 4 D Parameter Groups E T mE BASIC Parameter Name Parameter Value CENTRAL JOURNAL CentralJournallnstance RVS DIRECTORIES JournalFilenamePrefix TINY MAINTENANCE SendJournallnterval 0 NOTIFICATION ODETTE RESOURCES_CHECK 4 m SECURITY e Lance E Live Monitor Log 23 gar Active RDDE9D84 3755 6 00 03 2014 0 10 09 33 30 SE Please read the user manual Central Journal for further information Parameters for Central Journal Parameter Description SendJournallnterval Time interval in seconds between sending of two Journal files to the rvs destination station defi ned by the CentralJournallnstance parameter No Journal file will be sent if no value or 0 is specified JournalFilenamePrefix The prefix for the Journal file name default TINY CentralJournallnstance The rvs destination station that is to receive the Journal files This station must be present in the rvsEVO station list 10 4 DIRECTORIES In this group you can indicate the directory paths for your data rvsEVO User Manual Version 6 01 Rev 28 10 15 145 T Systems rvs Systems rvsEVO User Manual r 1 amp rvsEVO LOC Stax File View Window Help E amp 3X Automation Key Manage Monitoring ES
45. Parameter E7 Stations i Transfer UserM E Parameter 22 amp veter Parameter Parameter DIRECTORIES 0 Parameter Groups P T P eter Val BASIC i arameter Name arameter Value CENTRAL_JOURNAL L DIRECTORIES INBOX C rvsEV00805 files inbox MAINTENANCE LOGDIR C rvsEVO0805 log NOTIFICATION OUTBOX C rvsEVO0805 files outbox ODETTE TEMP C rvsEV00805 files temp RESOURCES_CHECK SECURITY ave nce I f E Live Monitor Log 23 gy I Active RDDE9D84 3755 6 00 03 2014 0 10 09 33 30 SE Parameters of Directories Group Parameter Description OUTBOX Temporary directory for files to be sent Default RVS_HOME files outbox TEMP Directory for temporary use INBOX Directory where completely received files are stored Default SRVS_HOME files inbox LOGDIR Directory for both log files startServer log and rvsservice log ARCDIR Archive directory where archive files and backup files are stored Default RVS_HOME archive RevisionLog xml files contain the entries of processed send or receive jobs please see chapter 4 11 jar files contain the backup data 10 5 MAINTENANCE In this group the parameters for security of important data and deletion of data from the database can be defined See chapter 21 Backing Up and Recovering rvsEVO Data for information about Backup and Recovery
46. SNAPSHOT 2015 03 28 00 21 05 SE rvs Administrator Validate certificate To validate a certificate Specify the OCSP address or download address of CRL in input field Validation URI and select the validation type OCSP or CRL from the combo box Press to specify more than one address and to open a further input field for validation URI or press to delete an entry Hint Via mouse click on Reset from Certificate button the validation URI is read from the certificate rvsEVO User Manual Version 6 01 Rev 28 10 15 267 Q T Systems rvs Systems rvsEVO User Manual Import update CRL By using CA certificates you can transmit the validation URI of the distributor which is specified in input field Distribution Validation URI to all his certificates This functionalty is executable in the detailed view of a CA certificate via a mouse click on Distribute to Issued Certificates button In the detaild view of a partner certificate or an intermediate certificate you have the possibility to read the validation URI via mouse click on the button Set from Issuer Press the Validate Certificate button to validate the certificate Hint A current CRL can be downloaded by pressing the Import CRL button The CRL is imported into the rvsEVO system Set the security parameter CRLUseHttpProxy y for downloading the CRL via Http Proxy server Via security parameter CRLAutoDownload you can configure that the CRL is downloa
47. SND for send job or RCV for receive job e Activate the radio button in Order By column next to that parameter if you want to sort the output Use the Add and Delete buttons on the right hand side for adding or removing criteria Save the query via Save button after configuring the needed criteras Hint You can use the filter criterion Last Change with wildcards as wildcard for one sign and for multiple signs and lt and gt signs The dateformat must be YYYY MM DD hh mm ss Example rvsEVO User Manual Version 6 01 Rev 28 10 15 89 Q T Systems rvs Systems rvsEVO User Manual 2013 04 25 10 00 17 Jobs older than the given date From rvsEVO version 6 01 03 onwards filters of type relative date can be set You can use the operators older than and younger than with the following time units minute minutes hour hours day days month months year and years Examples older than 3 days younger than 1 month Use from until for filtering jobs of a special period Example from 2015 10 01 until 2015 10 31 Press Save button for saving your changes Press the Reset button for deleting your inputs Click the Execute button to execute the query 6 5 2 Editing of Transmission Queries Open the detailed view of the transmission query to be changed with a right click on this query and then select
48. The number of partner station is restricted to 1 Other stations can be reached via routing Therefore rvsEVO Tiny Edition is particularly suitable for star topology rvs Tiny rvs Tiny rvs Tiny lt lt ns center lt rvs Tiny Features of rvsEVO Tiny Edition subject to modifications 5 partner station neighbour and routing stations 1 neighbour station rvs center 1 session max 4 routing partner communication components TCP IP and TLS encryption and compression Central Journal SNMP Agent rvsEVO User Manual Version 6 01 Rev 28 10 15 11 Q T Systems rvs Systems rvsEVO User Manual code conversion PC Mainframe Additionally the following component can be linked File Service Module Hint Please see the rvsEVO Product Datasheet for binding information of the technical data You can download the datasheet from the following adress https servicenet t systems com business inte gration rvs produktdatenblatt 927428 1 3 rvsEVO Light Edition Features of rvsEVO Light Edition subject to modifications max 5 partner stations direct or routing partner 2 parallel connections sessions routing functionality communication components TCP IP and TLS encryption and compression Derby database embedded Central Journal SNMP Agent co
49. User for http Proxy in case of user password access for CRL download CRLLocalAddress Sender address of the CRL download request CRLOftpProxyInstance Selection of a Bastion instance configured in rvsEVO for CRL Download rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 157 rvsEVO User Manual Security Parameters Parameter Description CRLUseHttpProxy If CRLUseHitpProxy y a Http Proxy server is to be used for the CRL Download In this case please also consider parameters CRLHttpProxyHost CRLHttpProxyPassword CRLHttpProxyPort CRLHttpProxyUser and CRLLocalAddress CRLUseOftpProxy If CRLUseOftpProxyzY an OFTP Proxy server is to be used for the CRL Download OCSPHttpProxyHost http Proxy server to be used for the OCSP check OCSPHttpProxyPass Password for http Proxy in case of user pass word word access for OCSP check OCSPHttpProxyPort Port for the connection to the Http Proxy Server for OCSP check OCSPHttpProxyUser User for http Proxy in case of user password access for OCSP check OSCPLocalAddress Sender address of the OCSP Requests OSCPOftpProxyInstance Selection of a Bastion instance configured in rvsEVO for OCSP check OSCPUseHitpProxy If OCSPUseHttpProxy y a http Proxy server is to be used for the OCSP check OSCPUseOftpProxy If OCSPUseOftpProxy v an Oftp Proxy server is to be used for the OCSP check TSLAutoUpdate
50. Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 221 rvsEVO User Manual 222 Multi Instance Functionality of rvsEVO 15 Multi Instance Functionality of rvsEVO On Linux systems rvsEVO Version 6 00 upwards provides the Multi Instance Functionality with a serverfarm The benefits of multi instance capability are fail safe stability great trans mission capacity scalability and load distribution A server farm comprises an array of several computers rvsEVO servers In case of a server failure another server can assume the tasks of a failed server 15 1 Introduction The serverfarm offers significantly higher fail safety and transmission capacity than single instance Aserverfarm comprises several rvsEVO servers aiming at ensuring high system availability Jobs to be processed are evenly distributed among all rvsEVO servers within the serverfarm load balancing Transmission capacity can be increased or decreased by adding or removing rvsEVO servers scalability To ensure trouble free rvsEVO operation another server can assume the tasks of a failed server With regard to communication partners and operation e g file transfer rvsEVO multi instance functionalty behaves like a single rvsEVO 15 1 1 Fail Safety Failure of anode Failure of a single node causes a restart of the aborted jobs on another server instance A node failure has not any impact on the overall sys
51. Version 6 01 Rev 28 10 15 199 Q T Systems rvs Systems rvsEVO User Manual Optional Parameters Parameter Description verbose Verbose message output help Displays a description of the current command Requests help information Optional Remote Parameters Parameter Description su lt user gt Client user for remote login Sp lt password gt Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server 12 12 2 showMonitorLogFile Show Earlier Log Messsages Use showMonitorLogFile to view earlier monitor log messages The log files are saved in SRVS_HOME log directory Syntax showMonitorLogFile i filename help verbose v Required Parameter Parameter Description i Path and name of the log file you would like to display Optional Parameters Parameter Description help Displays a description of the current command Requests help information 12 13 Command Line Tools to Start and Stop rvsEVO The description of the following programs you can find in chapter 3 Start and Stop of rvsEVO 200 Command Line Tools startGUI startServer rvsEVOService stopServer 12 14 Command line tools for internal use The following programs are only for internal use login setclientcp setc
52. You need this functionalty to get files from your neighbour station if parameter Active Connection group Line Type is disabled on neighbour station side For testing the connection to a neighbour station without file transmission use the option Activate Station without Transfer in the drop down menu Hint You can also use the activateStation script to activate a station 5 3 6 Automatic Certificate Exchange Deliver certificate Right click the neighbour station and select Certificate Reqest to request one Station In the opening window select the station ID of the sender and receiver and the certificate which should be delivered to your partner station Please see also chapter 8 4 12 Automatic Certificate Exchange via rvsEVO GUI Deliver certificate Right click the neighbour station and select Certificate Deliver to one Station to send a certificate to your neighbour station In the opening window select the station ID of the sender and the receiver and rvsEVO User Manual Version 6 01 Rev 28 10 15 69 Q T Systems rvs Systems rvsEVO User Manual the certificate which should be dilivered to your partner station Please see also chapter 8 4 12 Automatic Certificate Exchange via rvsEVO GUI 5 4 Routed Stations A routed station is reachable via a neighbour station For this reason you must already have set up a direct neighbouring node about which the routed station is to be added 5 4 1 Adda Routed Station
53. as symmetrical technique length 3x56 bits 168 bits 3DES and AES as symmetrical technique for CMS RSA as asymmetrical technique for ComSecure and CMS length 768 to 2048 bits Hint For encrypted file transmission JCE Java Cryptography Extension is needed If you try to transfer encrypted files and JCE is not installed you will get the following message invalid key length With Windows and Linux systems the JCE is installed automatically during installation Please see also chapter 2 3 2 Installation on Linux and UNIX Systems or the readme file in RVS_HOME docu for more information rvsEVO User Manual Version 6 01 Rev 28 10 15 105 Q T Systems rvs Systems rvsEVO User Manual 8 2 1 Principle and Sequence of rvsEVO Encryption The principles of the encryption which will be explained in the following part are the same for all encryption formats mentioned in this chapter Distributing the Each participant in encrypted communication creates a key pair compri public key safely sing the public key and the private key storing the privat key Each participant provides the public key to each partner he expects files from This allows the data to be exactly encrypted for the partner who sent this public key You can safely distribute the public key since this key alone is not sufficient for decryption Each participant keeps his private key and stores it safely Three keys are required for
54. be released Optional Parameters Parameter Description verbose Verbose message output help Displays a description of the current command Requests help information 12 3 4 holdJob Use holdJob to pause a job The job changes to status HOLD until it is released again Syntax holdJob n su user sp password sh lt host port gt 174 Command Line Tools Required Parameters Parameter n Description The jobID of the job to be held Optional Parameters Parameter Description verbose Verbose message output help Displays a description of the current command Requests help information Optional Remote Parameters Parameter SU lt user gt Description Client user for remote login Sp lt password gt Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server 12 3 5 deleteJob Use the program deleteJob to delete a job in HOLD status Syntax deleteJob n jobI sh lt host port gt Required Parameter D E su lt user gt sp lt password gt Parameter N Description ID of the job to be deleted Optional Parameters Parameter f Description This parameter allows to delete active jobs wit hout pausing the jobs befo
55. be shown via a single click on the appropriate entry in the navigation tree You get the following information Type Status SID Index Label and Valid period With a single click on the column headings you get a sorted output The list can be refreshed via refresh icon at the top right edge Via greyed out row beneath the column header you can set output filters The wildcards for one or more signs and for one sign are permitted Via Reset Filter symbol you can switch off the filter function Hint Index is a unique identifier which is assigned automatically by rvsEVO 108 Secure Transmission with rvsEVO You can copy one or more lines of the certificate list and insert them into a text file Detailed view With a double click on an entry in the certificate list you get the detailed view of the certificate Another way to output the certificate details is to right click the certificate in the list and thereafter select Open in New View In the second case the detailed view of several certificates can be opened The view in foreground is to be selected via tab In detailed view the parameters Label and Station ID can be changed 8 4 4 Generate a Key Pair Please follow the intruction below to generate a key pair Right click the entry Private Keys in the navigation tree and select Create Private Key from drop down menu or press the Create Private Key symbol in the function bar to open the wizard for creating a
56. delivered but EFPA RECEIVING Receiving file data after EFPA EERP SERT HELD File was completely received EERP is on hold and needs to get released EERP RELEASED User released EERP but it is still not send EERP DELETED User deleted EERP job will stop NERP RELEASED JS NERP released by JS but it is still not send FAIL ED WITHOUT NERP transmission failed no NERP sended ROUTI NG HELD DURING SHUTDOWN Couldn t create routing send job because of shutdown 94 File Transmission with rvsEVO FAILED WITH INVALID EERP SIGNATUR Received EERP with invalid signature FAILED WITH INVALID NERP SIGNATUR Received NERP with invalid signature Hint Please see chapter 16 ODETTE Protocol for ODETTE protocol sequences such as EFNA SFID EFID EERP 6 6 Operations on Jobs You have the possibility to execute activities for the job via a right click on the job in the list or via the buttons at the bottom in the detailed view Active Send Transmissions Open In New View Copy to copy one or more jobs from the job list and insert them into a text file Forced Delete allows to delete an active job without pausing it before Restart Delete Transmission Release Transmission Hold Transmission Active Receive Transmission Open In New View
57. eb dew e bear box Br Ra 40 4 3 3 Create New Transmission Remote 000 cece ete eae 40 4 3 4 Create New Transmission Local 000 cece nenn 42 4 3 5 Command toolS 2655 oou td O4 cy os ae ns TO ure sd e e me o oe Aa ah 42 5 Management of StationS 000 cece eee 43 5 1 User Interface of Stations Perspective llle rennen nennen 43 3 2 BOCAS nds vege etum dp eroe t Ier bread Pen hibet e agp fas quis 45 5 2 1 Setting up of a Local Staton 2 2 se awe a Ren deem ns Ue ed eed ee SE 45 5 2 2 Parameter Groups of Local Station llle 46 bos Neighbour Salons see deest Qe oni eta Tee go ERE te Pe te oot E amu eS 53 5 3 1 Add a Neighbour Station dede rer reis Rr a d E dar 53 5 3 2 Setting up of a Neighbour Station 0 0 00 ee eee 60 5 3 3 Parameter Groups of the Partner Station 0 0 00 0 cece eee nes 60 5 3 4 Delete a Neighbour Stallion ve Sud tr ar me ext ey ees he ES E edu 69 5 3 5 Activate a Neighbour Station 0 0 0 0 cee eens 69 5 3 6 Automatic Certificate Exchange 2 26 22504024 20 wen dene at 69 54 Routed Stations Geci cack ks ao ep i ie NC Caracol e ame a hed Gadi where team s unt fo attain a 70 5 4 T Add a Routed Salon ars ELE beste e etus esae are CROP ius 70 54 2 Setting up a Routed Station nn a 4 oa I ER eee RS epe Rex XS PEE 71 rvsEVO Benutzerhandbuch Version 6 01 Rev 28 10 15 3 T Systems rvs Systems rvsEVO Benutzerhandbuch
58. entry in the navigation tree and select Add New Query from drop down menu or press the Add New Query symbolin the function bar to open the wizard for creating a transmission query The following window opens 88 File Transmission with rvsEVO gt cso x d E File View Window Help Ame k 3 Automation jj Key Manage Ed Monitoring O Parameter F Stations Transfer amp Sum iti x Query Result ENDED JOBS E Job Details 1403061400540000 O Transfer Create Query Definition RR Create New Transmission e Transmission Queries Query Name ACTIVE SEND JOBS ACTIVE RECEIVE JOBS Order By ASC Column Preset Filter ENDED JOBS V JoblD B ne nn m ML nen Iw I Direction El Manage Templates RVS54 Standard VDSN SID Originator a SID Destination 2a SFID Date Time w Category 2a State B Last Change a Send Attempts a n E Execute Add Result Q Live Monitor Log 23 amp SUL Live Monitor Log o Date Time Level Module Message Session Station Job Text A 20140306 1407 INF CTRL CLEANUP_STARTED L scher n D Q Active RDDE9D84 3755 6 00 03 SNAPSHOT 2014 03 06 00 45 06 SE m Feed the name of the query in the input field Query Name Your query will be listened in Transmission Queries entry of navigation tree Feed the needed filter criteria in column Preset Filter e g with parameter Direction
59. error has occurred in rvsEVO and the user wishes to revert to the old status prior to the error 21 1 Backup Pre condition The rvsEVO server has to be stopped before the backup function can be launched Start the SRVS_HOME tools backup script to perform the backup func tionality Syntax backup u s verbose help All parameters are optional Backup Parameters Parameter Description file file Without function f userfiles Use this parameter to save the user data from u Files directory subdirectories inbox outbox and temp skipjobs Use this parameter for desabling backup of job S data Requests help information help Displays a description of the current command h verbose Verbose message output By default the data are saved in SRVS_HOME archive directory Every backup process creates a new subdirectory The directory name constists of EVO6B date and a Time Format EVOGB YYYYMMTT hhmms s What is backed up The following directories are backed up SRVS HOME conf SRVS HOME files SRVS HOME system SRVS HOME jobs if used The following data from the database are backed up rvsEVO User Manual Version Rev 28 10 15 263 Q T Systems rvs Systems rvsEVO User Manual configuration data stationlist OFTP Proxy Bastions jobdata jobstarts certificates and their assign
60. in X 25 ISDN communication is the number of packets that can be outstanding without acknowledgment The window size will be negotiated during connection setup but we recommend you to use the correct window size depending on the partner network XOT The XOT parameters are described in the table below XOT Parameters Partner Parameter Number of Associated Receiver lt ReceiverNumber gt Description Not active Remote station only Number for diffe rentiating the various receivers through which the local station can be reached Note Each receiver should be defined in one XOT tab of the local sta tion rvsEVO automatically assigns and manages this number Default 1 Router IP address IP address of an XOT router This parameter is optional for the local station and mandatory for the partner station Router Port Port of the XOT router Default 1998 Time Out lt TimeOut gt Time Out in miliseconds after which the commu nication program the connection closes if the partner station does not answers Default 30 0 means that default value is used X 25 Address 15 digit X 25 DTE address of the local station This number is optional It is however advisable for an ISDN connection to enter the ISDN number here as some partners expect an X 25 address X 25 DBit D bit Delivery Confirmation applies only to Data packets It is used to ensure that acknowlodge ment of Data packet is end
61. is requested NERP Reason Code Code of NERP NERP Reason Text Description of NERP Codes NERP Creator OdettelD Odette ID of the creator of the NERP Encryption Cert Serial Number Serial number of the certificate A value is displayed if a certificate is indicated for use explicit It is not displayed which certificate is used in fact Encryption Cert Issuer Name Publisher name of the certificate A value is displayed if a certificate is indicated for use explicit It is not displayed which certificate is used in fact Sign Cert Serial Number Serial number of the signature A value is displayed if a certificate is indicated for use explicit It is not displayed which certificate is used in fact Sign Cert Issuer Name Publisher name of the signature A value is displayed if a certificate is indicated for use explicit It is not displayed which certificate is used in fact Job Error Information Parameter Error Number Description Error code Description Description of error code 6 5 5 Status for Send Jobs and Receive Jobs Status for Send Jobs and Receive Jobs RESTART wait after interruption of transmission to send file again SP PROCESSING Service provider is processing job rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 93 rvsEVO User Manual SP_ENDED Service prov
62. is selected in three sections In Local Host Section you can select the directory where the incoming file is to be saved and you can also rename the file In Remove Host Section you can select the file to be downloaded In File Type Section the transmission format can be selected rvsEVO User Manual Version 6 01 Rev 28 10 15 41 Q T Systems rvs Systems rvsEVO User Manual Press Execute for starting downloading Downloading Receive file from rvs Server to localhost Local Host Section Please select the directory to store the downloaded file Directory J File Remote Host Section Please select the file for download Host RDDE9D84 Directory Inbox 1TEST TXT TESTDATEIEVO6 n File File Type Section Please choose a transfer type for file transfer File Transfer in Binary Format File Transfer in Text format ASCI E Delete this file on rvs server after download Execute 4 3 4 Create New Transmission Local To create a new transmission local via Remote GUI proceed as described in chapter 6 2 Create a Send Job The file to be sent is uploaded into inbox directory of the rvsEVO Server automatically The Disposition and No Copy parameters are preset and cannot be edited Desposititon D delete means that the file in outbox directory is deleted after transmission No Copy means that the rvsEVO Server does not create a second copy of the file 4 3 5 Comman
63. key pair The following window opens and you can insert the mandatory parameters Subsequent click Finish to create the key pair or Next to insert the subject parameters r bil N Create private key i gam arm a c Mandatory M All fields are mandatory please fill them amp Station ID RVS v Label ruskeyl Key size 1024 Signature Algorithm SHAlwithRSA Valid from 26 02 2015 gv Valid to 26 02 2017 gv Common name keyl Next Finish Cancel rvsEVO User Manual Version 6 01 Rev 28 10 15 109 T Systems rvs Systems rvsEVO User Manual In table below you find a Description of the mandatory parameters Mandatory parameters Parameter Description Stations ID ID of the station the key pair is created for Label Identifier for the functional assignment of the certificate Key Size Specify the default value 1024 or a multiple of 1024 Signature Algorithm Hash Algorithm for digital signature Possible values SHA 1withRSA default SHA 224withRSA SHA 256withRSA SHA 384withRSA SHA 512withRSA Attention Select a value higher than sHA 1 if the certificate is to be certified by Odette CA because SHA 1 is not accepted by Odette CA Valid from Start of the keys validity date Default current date Valid to End of the keys valitity date Dafault current date plus tree years Common Name CN The Common Name parameter applies in case
64. last change in the job status SFID Date Time Date and time of the creation of the transmission job SFID Counter Sequential counter from SFID if several send jobs were created at the same time beginning with 0001 Schedule Time Fixed date for the transmission Time Start File Restart position in case of which a new transfer of the file should be started system time in mil liseconds Time of first Send Attempt Retry Count Date and time of the first attempt for a connection with your neighbour station Number of failed send attempts Send Attempts Number of faulty dispatch attempts After suc cessful transmission the parameter is set to zero Bytes Transmitted Restart Position Number of transmitted bytes Restart position in case of which a new transfer of the file should be started rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 91 rvsEVO User Manual File Features Parameter Size of Source File Description Size of original file before processing through the service provider Format Format of the file to be sent T text file a stream of ASCII characters U unstructured binary byte stream V variable variable record length F fixed fixed record length Please see also the parameter Record Mode Record Length Maximum record length Record Mode In this parameter you i
65. name SID of Destination SIDORIG Station ID of source station local or virtual sta tion GUI name SID of Originator TSTAMP With this parameter you define rules for timestamp creation Possible values Y timestamp is to be generated generally N timestamp is to be added only if necessary default GUI name Timestamp 220 rvsbat Batch Interface Optional Jobstart Parameters Parameter TSTAMPFORMAT Description Format of the timestamp Possible values TIME time of creation of the job and counter format hhmmssccc default DATETIME date and time of creation of the job and counter format YYMMDDhhmmssccc SFID DATETIME Odette timestamp of SFID date time and counter in format YYMMDDhhmms SCCCC COUNTER 000000 999999 If the counter is not sequential the gap is filled first before the counter is counted up GUI name Timestamp format UID No function for compatibility with rvs portable Possible value empty string VFTYP With this parameter you decide whether each line of a received file in F or V format is termina ted by line feed Possible values T Files in F or V format are saved in text mode Line feed is inserted at the end of each record default V Files in V format are saved in text mode files in F format are saved in binary mode GUI name Record Mode rvsEVO User Manual
66. name for file signature only for sfs 4 172 Command Line Tools Optional Send Parameters Parameter Description so lt originator sid gt Station ID of originator local default or virtual station St lt init time gt With this parameter you can define what time the send job should be launched Format lt hh mm ss gt t lt table name gt Name of your own conversion table For ASCII ANSI EBCDIC conversion ASCII IBM037 ASCII IBM273 ANSI IBM037 ANSI IBM273 For EBCDIC ASCII ANSI conversion IBM037 ASCII IBM273 ASCII IBMO37 ANSI IBM273 ANSI verbose Verbose message output xid lt external job id gt Parameter for an external JobID which can refer to several rvsEVO JobIDs The external JobID is a string of alphanumeric characters Y File will be sent encrypted Yalg lt encryption algo rithm gt See the description of the parameter Encryption Algorithm for GUI Possible values 3DES AES Ycsn serial no Certificate serial number for encryption only for sfs 4 Ycin issuer name Certificate issuer name for encryption only for sfs 4 Optional Remote Parameters Parameter rd file name Description Remote file name of the file to be sent The file must be in the Outbox directory Su user Client user for remote login Sp password Password of the c
67. of a connection to an existing PKI Public Key Infrastructure The data of the next window are optional and concern your organiza tion Click Finish to create the key pair or Next to insert the extended 110 Secure Transmission with rvsEVO parameters OR Create private key E eon 2 Subject i These are subject fields none is mandatory Organization Name 0 Organization Unit OU Locality Name L State Name S Country C Email E The extended parameters are optional and concerns the X 509 certifi cate You need not change the present settings Further information can be found under the following URL http tools ietf org html r c5280 Click Finish to create the key pair The last window gives a summary information about the created key pair 8 4 5 Use of CA Certificates This chapter describes the procedure for working with CA Certificate Authority certificates CA Certificates are issued by a TrustCenter like the Odette certification authority Generate CSR Generate a key pair as described in chapter 8 4 4 Generate a Key Pair Generate a certification request CSR Certificate Signing Request via a right click on the key pair in the list view and select Create CA Request Or via the button Create CA Request at the bottom of the detailed view of the key Define name and directory in which the request should be saved By default the file is g
68. rvs Systems rvsEVO User Manual 104 Secure Transmission with rvsEVO 8 Secure Transmission with rvsEVO Basics For secure transmission risks such as the attack on the confidentiality intergrity and authentication of your data must be excluded Also the traceability of the transmission must be ensured In rvsEVO this is achieved with the following features line encryption via TSL protocol OFTP2 authentication via AES or 3DES and RSA file encryption via AES or 3DES and RSA file signature signature of EERP NERP 8 1 Line Encryption Line Encryption is the encryption of the network connection between two direct neighbour stations during the transmission In rvsEVO the TLS protocol Transport Layer Security is used therefore 8 2 File Encryption The file to be send is encrypted by the sender and decrypted by the receiver rvsEVO offers two file encryption formats ComSecure and CMS Com Secure is an appropriate format which is used for rvs portable too CMS Cryptographic Message Syntax is an Internet Standard rfc 2630 for the syntax of an encrypted message This standard is implemented in the OFTP version 2 The encryption in rvsEVO for both formats ComSecure and CMS combines the benefits of symmetrical and asymmetrical techniques the high speed of the symmetrical and the security level of the asymmetrical technique rvsEVO uses the following techniques 3DES for ComSecure
69. same alias name with the installation of each node Define the group name with the installation of the first node in the window Configure cluster node Use the same group name for each node within the serverfarm Insert the host names or IP addresses of the other nodes within the serverfarm via Nodes parameter in the same window multiple entries seperated by commas Initialize the database only with the installation of the first node After installation Save the directory RVS_HOME files and its subdirectories on the NFS drive The path of the subdirectories inbox outbox und temp are to be set up in DIRECTORY group rvsEVO User Manual Version 6 01 Rev 28 10 15 225 Q T Systems rvs Systems rvsEVO User Manual Create directories for jobstart scripts and Observer on the NFS drive and provide the read and write access to all nodes Setting up of a Serverfarm During installation the cluster node has been configured You can set up the configuration in SRVS_HOME conf cluster properties file This is required after adding or removing nodes In this case on each node of the server farm the IP addresses or host names of the added or removed nodes has to be added or deleted in cluster nodes defini tion Example of cluster properties file cluster group name rvsEVO6 Cluster cluster node name rvsEVO Node cluster node id 0 cluster node ip 10 177 191 220 cluster node port 5900
70. se a rei e ce hu we OM scd a a ut Le 140 9 3 3 Edit am ODSSIVBI a sehe beo d Bathe thaw AG Shed RS EPA qa AER TRES 140 9 3 4 Delete an ObSOrVer is ness eme ede rn Dre Lg Eee 140 10 Customizing the Global rvsEVO Parameters Ls 143 10 1 The User Interface of Parameter Perspective 0000 eee ee 143 10 2 BASIC parameters codo erap DES E eee eRe REY ES gue oe au ey ere 144 10 3 GENTRAL JOURNAL od La utt DR ER eite f erbe Ou eC EE CREER I Qr 144 10 4 DIRECTORIES EID Pr UE 145 10 5 MAINTENANCE 22 2402 oo terae charter ER Gok mo deen iS MNA 146 10 5 NO FIRFIGATION ic ohh a sae ee aah doner au eed eate a S UC ael tae 149 10 7 ODETTE Parameters eoe or N ER REIN PU RE UNES 150 10 8 RESOQOURBES GHEUR u Dudas cet i etn RU ros ta See ie Abe 152 10 9 Security Paramelers 22 ces evt RETE RPM Ie Ed ee ne wD Banh Peal ee 155 10 10 Customizing via rvs system properties File llle 160 11 User Management uleesseeeeeeeeerr nun nn 163 11 1 User Interface of User Management Perspective 0 000 sellers 163 11 2 Display Users P ED EORR rs 164 11 3 Create NOW USER ied so ped OL e ree d c AE m ROGER e NATURE 164 TE EdEEBUSSr Dales 252a oborta o tetas ah cu a b e 165 13 5 Deleted Usei cus esed ee pte e a wees eee e a e pot Dno aed RE 166 12 Command Line Tools eeeeeeeeee nn nn nn 167 1271 gelotatonbist Seiten m kat ote de eid ond Pico I
71. service t systems com We will send you the software also on a DVD 232 rvs OFTP Proxy Carry out the installation of the Bastion Instance as explained in User Manual rvs OFTP Proxy 17 3 Bastion Instance In order to create a connection with the Bastion Instance it is required to store the parameter in rvsEVO Bastion Instances and to configure a proxy listener A list of already created Bastion Instances can be displayed in Stations perspective Please read Chapter 5 6 2 Display Proxy Bastions for more information Add a Bastion You can add a Bastion Instance via Stations perspective Please read Chapter 5 6 1 Add Proxy Bastion to find out how to add a Bastion Configure Proxy A receiver listener must be defined for each Bastion Instance For this listener purpose please proceed as described in chapter 5 2 1 Setting up of a Local Station You also have to add a neighbour station with Proxy TCP IP or Proxy TLS network for the communication via rvs OFTP Proxy Please read chapter 5 3 2 Setting up of a Neighbour Station for detailed information First the Bastion Instance should be started and following the rvsEVO server Hints Failure of connec You can start a process after connection problems with rvs OFTP Proxy tion attempts This functionality is to be set via ODETTE parameters ConnSetupProxy FailCount and ConnSetupProxyFailScript see chapter 10 7 ODETTE Parameters Keep connectio
72. software 958408 If that is not possible for you please contact your sales partner Phone from Germany 0800 664 77 45 Phone from other countries 49 375 606 19 902 Email rvs service t systems com We can send the software also on DVD to you Networks Communication line based on TCP IP TLS ISDN XOT Proxy TCP IP und Proxy TLS Hint ISDN is only available with Windows32 installer ISDN system requirement ISDN is only for Windows platform available For Unix platforms XOT should be used If you want to use rvsEVO to exchange data via the ISDN network you need the following equipment rvsEVO User Manual Version 6 01 Rev 28 10 15 17 T Systems rvs Systems rvsEVO User Manual ISDN type telephone connection with sg bus having at least two data channels B channel and one control channel D channel ISDN adapter CAPI 2 0 driver software for operation of the ISDN card under Windows How to install the ISDN interface Install the ISDN card into your computer and attach the ISDN card to the ISDN connection Make sure that the ISDN card works properly Note Many card manufacturers supply suitable software for a self test such as a call from one data channel to another Restart your computer after installation and the test in order to make the CAPI 2 0 driver available for other applications External ISDN If you use an external ISDN router with remote CAPI Interface e g router BinTe
73. text file BIN binary file Text File in format F If the record length deviate from the specified one Parameter MaxRecl the line will be filled with blanks or will be cut up to defined value Text File in format v longer records will be cut up to defined value Binary files The length of all records is the max record size except the length of the last one Binary files in format F If the size of the last record is shorter than the specified one the line will be filled to the defined value Conversion Table For ASCII EBCDIC conversion the following conversion tables are available ASCII IBM037 ASCII IBM273 ANSI IBM073 ANSI IBM273 For EBCDIC ASCII conversion the following conversion tables are available IBM037 ASCII IBM273 ASCII IBM037 ANSI IBM273 ANSI For using your own conversion table please read the note for Conversion tables on page 133 External Job ID Parameter for an external JobID which can refer to several rvsEVO JobIDs The external JobID is a string of alohanumeric characters By default External Job ID is an optional para meter With entry key client transfer sendJobWizard externalJobId value mandatory definition in SRVSHOME conf rvsEvoClient prefs file you can set up External Job ID to mandatory parameter This setting is only valid for sendjobs what are created via rvsEVO GUI File Description Comment free text available only in connec
74. the original filename which are seperated by points into the new VDSN Examples Original filename AAA BBB CCC VDSN Observer PART1 PART2 New VDSN PART 1 BBB PART2 Original filename DEH KMUKQY AS 111 ASN D123 T456 VDSN Observer DEH KMUKQY AS ASN New VDSN DEH KMUKQY AS 111 ASN Original filename DEH KMUKQY AS 111 ASN D123 T456 VDSN Observer New VDSN DEH KMUKQY AS 111 ASN You can also use the original filename as file description This function is controlled by the properties file SRVS_HOME conf rvs system properties With the definition observer sfiddesc usefilename true 9 3 2 Displaying Observer Observer lists Observers can be listed via a single click on the Observer entry in the navigation tree The list is displayed in a new view The following informa tion are given ID Number awards by rvsEVO in format YYMMDDhhmms scccc State Directory Mask VDSN SID Originator SID Destination With a single click on the column headings you get a sorted output The list can be refreshed via refresh icon at the top right edge Via greyed out row beneath the column header you can set output filters The wildcards for one or more signs and for one sign are permitted Via Reset Filter symbol you can switch off the filter function Detailed view With a double click on an entry in the Observer list you get the detailed view of an Observer Another way to output the jobstart detail
75. to end When not set a local node can acknowledge the receipt of a Data Packet before forwarding it on the next node X 25 Facilities Special information or facilities for an X 25 trans mission see the information of the X 25 service in use 68 Management of Stations XOT Parameters Partner Parameter Description X 25 Modulo In X 25 data transmission exist two modulo ope rationg standards Modulo 8 and Modulo 128 Modulo 128 means that you must select bigger window size via parameter FACILITIES The standard window size for modulo 8 is 2 X 25 PacketSize Size of date packets during data transmission lt PacketSize gt X 25 Userdata User data for an X 25 transmission see the infor mation of the X 25 service in use X 25 Window Size lt Win window size 7 recommended for ISDN dowSize gt window size 2 recommended for X 25 native Note Window size in X 25 ISDN communication is the number of packets that can be outstanding without acknowledgment The window size will be negotiated during connection setup but we recommend you to use the correct window size depending on the partner network 5 3 4 Delete a Neighbour Station Right click the neighbour station to be deleted and select Delete Entry to delete a station 5 3 5 Activate a Neighbour Station Right click the station and select Activate Station to activate the station and receive files from this station
76. upwards certificate validation via OCSP and CRL is also available for TLS certificates 22 2 Configuration of PKI Binding The PKI binding should be configured in the Stations perspective via the OFTP parameters Certificate Validation Type and PKI Hint Usually the PKI binding should be configured for a partner station For the local station it can be interesting only if you want to validate your own certificate Parameters for PKI Binding Parameter Description Certificate Validation This parameter describes the type of the certifi Type cate validation The following three types are supported OCSP Online Certificate Status Protocol CRL Certificate Revocation List CertPath None in this field means No validation will be done PKI If the checkbox is activated the PKI functionality is used 22 3 Validation Methods Which validation method will be used depends on security standards in the company rvsEVO User Manual Version 6 01 Rev 28 10 15 265 Q T Systems rvs Systems rvsEVO User Manual OCSP Ifyou use OCSP as validation method the OCSP service must be available for the rvsEVO nodes CRL The validation with CRL can be done offline The rvsEVO user administ rator can provide the list of certificates CRL and store it manually or download the list via the key management of rvsEVO see 22 4 Certificate Validation via Key Management Perspective The disa dvantage of this
77. via rvsEVO GUI The functionalities ACX Deliver Certificate ACK Request Certificate and ACX Replace Certificate can be executed via the corresponding icons in the function bar Instruction for entering the parameter values Station IDs can be written into the input feld or selected from the combobox If you enter the value dircetly into the input field you can use the wild cards and A checkbox is to be enabled or disabled by single click in the checkbox Deliver Certificates Use this feature to deliver a certificate to a partner station and import it at the partner station Open the wizard for ACX Deliver certificate via a single click on the following icon in the toolbar g rvsEVO User Manual Version 6 01 Rev 28 10 15 115 Q T Systems rvs Systems rvsEVO User Manual Request certificate 2 ER ICK Deine cti Panem ee Sn 2 ACX Deliver certificate amp 3 This dialog is used to deliver certificate SID originator LOC X E Select all 5 ES 6 Select certificates 7 LOC2 E Select all RVS54 SID destinations Select the station ID of the certificate s originator via selection box SID Originator Select the certificates to be delivered via Select certificates selection box If the check box Select allis activated all certificates are delivered Hint Selection of the certificate is done via certificate index You find the index in the list view and detail
78. way is that certificate can expire between two updates CertPath For CertPath validation you only need the certificate to be validated and the certificates of the issuer up to the root certificate Normaly these certi ficates change rarely So not much service is necessary With CertPath validation the formal correctness of the certificate the certificate of the issuer up to the root certificate is checked It is not checked whether a certificate was revocated Default Procedure with Encryption via TLS You need to set up parameter Certificate Validation Type to CRL or OCSP for CRL or OCSP validation Else CertPath validation takes place With all outgoing calls certificate validation takes place To validate certifi cates of incoming calls parameter Client Authentification is to be set up to NEEDED Or WANTED see table TLS and Proxy TLS Parameters Local on page 49 Default Procedure with File Encryption There is no certificate validation by default Validation with OCSP or CRL always includes the validation of the chain For using OCSP and CRL validation you need to set up parameter Certificate Validation Type Hint rvsEVO don t accepets expired certificates 22 4 Certificate Validation via Key Management Perspective A certificate can also be validated via Key Management perspective in the detailed view of the key section Certificate validation The detailed view can be opened by a double click on the certi
79. you can set up the file permissions of the temporary file Default read write execute permission for owner and group Placeholder of all jobstarts DSN DataSetName name of local data set where received infor mation has been stored rvsEVO User Manual Version 6 01 Rev 28 10 15 131 Q T Systems rvs Systems rvsEVO User Manual VDSN Virtual data set name under which the data set was trans mitted DTAVAIL Date when the data set was available for sending Format TT MM JJ HH MM SS FORMAT Record format of data set BYTES Number of transmitted bytes RECORDS Number of transmitted records for F and V format data sets always zero for T und U format data sets DTRCV Date when data set was delivered to local user in format TT MM JJ HH MM SS UID User ID SID Station ID DSNTEMP Name of temp data set Placeholder of jobstart type SND MAXRECL The meaning of this field depends upon the record format of the transmitted data set F format length of each record V format maximum length a record may have T und U format always 0 zero LABEL string if the send command contained a LABEL parameter Can be used to identify the send command SECN rvsEVO JobID number of send command SE in rvs portable SKCN rvsEVO JobID number of send command SK in rvs portable SIDORIG Station D of originatior SENDATT number of unsuccessful attempts after which the pr
80. 0 Format Filename xml yyMMddHHmmss cccc The following settings of RevisionLog file can be done via parameter group MAINTENANCE Of Parameter perspective The maximum size and maximum number of revision files can be indicated via MaxRevisionLogSize and MaxRevisionLogCount para meters If the value in MaxRevisionLogSize parameter is reached a new RevisionLog file is created Any terminated and failed jobs older than 7 days will be deleted every 24 hours by default This configuration can be set up via the parameters CleanupDays Cleanupinterval and CleanupTime please see chapter 10 5 MAINTENANCE for getting the description of the parameters Hint You can also start the deletion of job data by launching the script archiveJobs at the command prompt as an alternative See chapter 12 8 archiveJobs Deletion of Job Data from Database Deletion of an Individual Job You also have the option to delete an individual job This can be reached via the script archiveJob see chapter 12 9 archiveJob Deletion of an Individual Job from the Database or via the GUI see chapter 6 6 Operations on Jobs rvsEVO User Manual Version 6 01 Rev 28 10 15 261 Q T Systems rvs Systems rvsEVO User Manual 262 Backing Up and Recovering rvsEVO Data 21 Backing Up and Recovering rvsEVO Data You can back up all relevant rvsEVO data and recover them if necessary This is particularly important when an
81. 2 bin for 32 bit OS and rvsEVO setup Linux64 bin for 64 bit OS Hint There is the following difference on UNIX systems Java runtime envi There is an additional dialog for defining the JRE Java runtime environ ronment ment for rvsEVO operation The installer searches for installed compon ents on your systems and proposes the versions found in a dialog rvsEVO has been released for use of JVM version 1 7 X onwards For encryption rvsEVO uses an extension of Java runtime environment JCE Java Cryptography Extension of Oracle Corporation to implement the cryptographic features Due to import control restrictions of some countries the JCE jurisdiction policy files allow strong but limited cryp tography to be used It is necessary to install these extension of the Java runtime environment to use unlimited cryptographic strengths This is available for most countries rvsEVO User Manual Version 6 01 Rev 28 10 15 27 Q T Systems rvs Systems rvsEVO User Manual For more information about JCE files read the RVS_HOME docu readme txt file Important Without JCE you cannot transfer encrypted files If you try to transfer encrypted files and you did not install JCE you will get the following message invalid key length If you use a central JRE After updating your operating system the JCE settings could be lost In this case it is strictly necessary to install the JCE again Installation Modes The instal
82. 28 10 15 T Systems rvs Systems 247 rvsEVO User Manual 19 6 12 exportKeys Export of Keys and Certificates Use this tool to export the certificates from the database into a file and replace a file with the same name if necessary Syntax exportKeys f Required Parameter File r help verbose v Parameter f File file lt File gt Description Path and name of the file in which the certificates are to be imported Optional Parameters Parameter Description r To replace a file with the same name if neces replace sary If a file with the same name is present and this parameter was not set the process is failed with an error message h Displays a description of the current command help Displays a description of the current command V Verbose message output verbose 19 6 13 importKeys Import of Keys and Certificates Use this tool for importing keys and certificates into the database and deleting the present key data Syntax importKeys f lt File gt Required Parameter c help verbose v Parameter f lt File gt file lt File gt Description Path and name of the file from which the data are to be imported into the database 248 rvsEVO Database Optional Parameters Parameter C clean Description To delete the old data before new keys and c
83. 3 exportCertificate2ComSecure 195 G getCertificateList 196 GUI 36 H handleEERP 63 I importUsers 253 ISDN connection 15 ISDN Parameters 49 ISDN Parameters Partner 66 J Job Status 93 JobInfoList 181 N Network Parameters Card Number 50 Card number 66 Client Authentication 49 Dial Retry Count 67 Dial Retry Wait Time 67 Enabled 50 52 enabled 48 49 IP Address 48 49 66 rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 269 rvsEVO User Manual Index ISDN Address 50 66 EERP Out 63 ISDN Facilities 50 66 Encryption 65 ISDN Protocol 50 66 Encryption Algorithm 65 ISDN Terminal Identifier 50 67 ERP Signature 65 ISDN User Data 50 Exchange Buffer Credit 63 ISDN Userdata 67 Exchange Buffer Size 63 Local IP address 52 File Encryption 64 Local Port 52 File Service Proxy 65 Max IncOmming Sessions 52 File Signature 65 Max Incomming Sessions 48 49 51 Odette ID 62 Number of Associated Receiver 66 68 OFTP Version 62 Ordinal Number 48 49 52 PKI 64 Port 48 49 66 Receive Password 62 Proxy Bastion 48 49 66 Restart 63 RCV Time Out 50 Security Feature Set 65 Receiver Number 50 Send Password 62 ReceiverNumber 67 SFIDDESC as Filename 63 Router IP Address 52 68 VDSN charse 63 Router Port 52 68 P Time Out 48 49 50 52 portable2codetable 28 timeout 67 68 R Type 50 66 Remote GUI 37 X 25 Address 51 52 67 68 replaceCertificate 194 X 25 Closed User Group 51 67 requestCertificate 19
84. 3 X 25 DBit 67 68 restartListener 189 X 25 Dbit 51 53 RVS_HOME 25 X 25 Facilities 51 53 67 68 rvsbat X 25 Modulo 53 69 Commands X 25 PacketSize 51 52 67 69 FAILURE 214 X 25 User Data 51 53 RESENTR 211 X 25 Userdata 67 69 SEND 206 X 25 Window Size 68 69 SENDJOB 213 X 25 WindowSize 51 53 Jobstart Parameters 215 O Send Create Parameters 207 Observer Parameters RVSENV 26 Directory 139 S Enabled 139 showCRLs 198 Maske 139 T Time 139 TCP IP and TLS Parameters Partner 66 ODETTE parameters TCP IP Parameters 48 Authentication 64 TLS Parameters 48 Certificate Validation Type 64 Type 50 Compression 65 EERP in 62 Typographic conventions 14 270 Index X XOT Parameters Partner 68 XOT Parameters 51 rvsEVO User Manual Version 6 01 Rev 28 10 15 271 T Systems rvs Systems
85. 5 43 F rther Funeli nallliesz 355 2353 cece en ed chee IE a E 71 5 5 Virtual Stations ses ssa 02 20 REED eee Pee MAGA ES AER ARP Od A 71 5 5 1 Adda Virtual Station syrup Ev ERI sad 71 5 5 2 Setting up a Virtual Station x sie eR Soa dh dyed DERE ACE eke dates 72 5 5 3 Further Funchonalities so 4 2 0 822 daw ed ede ba acce dan 72 5 6 Proxy Bastion S oad eue foe ee nad e e ale esha nee od oh Hes ke wale BERE 73 5 6 1 Add Proxy Bastion usce onean era V Rute Re ONES gere RAE eS 73 5 6 2 Display Proxy Bastions 12 02 00 iere eei ee RIDE cr a ed he 74 5 6 3 Setting up Proxy Bastion sts coser ax Mee es iss ET NA D dut ILE 74 5 6 4 Delete Proxy Bastion sa senec are isst 74 5 7 Station Configuration via rvsStationlist xml 0 0 0 0 lesen 74 6 File Transmission with rvsEVO lllleeeeeess 77 6 1 User Interface of Transfer Perspective 000 0 es 77 6 2 Createa Send JOD uns en ee acte Y Ru Pha M eo RU e Med ade eae is 78 6 2 1 Send Parammielels ocu scl dentate oe dos Dr Ce og da tice ein ad Rc 81 6 3 Create Send and Remove Templates for Send Jobs 0000 cece eae 86 6 4 Deletion of Job Data from Database 020 es 86 6 5 Display of Receive and Send Jobs 2 Re ym xvn 87 6 5 1 Create Transmission Queries Zaun RR ieee ED KERN RE REESE YS 88 6 5 2 Editing of Transmission Queries 2 62205 eee de enw RR ru x Rn 90 6 5 3 Deleting of Transmission Queries lllelslllselle
86. 5 e se BER o 3 Automation p Transfer B User Management f Stations E Key Management E Monitoring 0 Parameter Key Management X O E Active Panel 3 Key EVO54 ucevo54 ju Key EVO54 ucevo54 Key Management v Basic l 4 BS AI 2 Private Keys Station ID EVOS4 ss Partner Certificates Eder 3 Intermediate Certificate SR CA Certificates Label ucevo54 mM cns Status Enabled Valid From 27 02 2013 15 41 27 0 Valid To 25 02 2023 15 41 27 0 Version 3 X m r PE x Save Cancel Create CA Ret Import CA Re i Show X 509 C Show PEM J BS All Keys 23 il CA Certificates Live Monitor Log B3 CRL View SBAJ repo All Keys A Type Status SID Index Label Valid From Val B z Enabled EVO54 CA2 2012 11 15 20 35 20 0 202 Ed Enabled UC2 4 130227 2013 02 27 17 26 28 0 202 Ed Enabled EVO54 UC2 3 130227 2013 02 27 17 24 50 0 202 _ Ti m gt Active RDDE9D84 3755 6 01 00 SNAPSHOT 2015 03 18 00 23 20 SE rvs Ad In the center left section of the GUI window the Key Management view offers the following entries All Certificates Private Keys Partner Certificates Intermediate Certificates CA Certificates CRLs In the center right section the detailed view of certificates and CRL s and the list view of the Active Panel is positioned Please see chapter 7 6 Active Panel for more information about Active Panel
87. CII xml converter characterSetConverters In the example above cid ANSI IBMO37 cid IBM237 ASCII is the used name in rvsEVO and conversion ANSI IBMO37 xml conversion IBM237 ASCII xml is the name of your XML file Please restart rvsEVO after your complement 9 2 3 Displaying Jobstarts Listings of jobstarts can be output via a single click on the appropriate entry in the navigation tree The list is displayed in a new view by default at the bottom of the window It can be opened several jobstart lists The view in foreground is to be selected via a mouse click on the tab The following information is given ID Job ID awards by rvsEVO in format YYMMDDhhmmsscccc Direction VDSN SID Originator SID Destination Enabled and Send Attempt With a single click on the column headings you get a sorted output The list can be refreshed via an icon at the top right edge Via greyed out row beneath the column header you can set output filters The wildcards for one or more signs and for one sign are permitted Via Reset Filter symbol you can switch off the filter function With a double click on an entry in the jobstart list you get the detailed view of the jobstart Another way to output the jobstart details is to right click the jobstart and thereafter select Open in New View In the second case the detailed view of several jobsta
88. D UID In chapter 14 3 4 Jobstart Parameters you can find a description of the jobstart parameters Example for creating a jobstart after receive RESENTR c SIDORIG DSN TESTFILE1 SIDDEST LOC DSNNEW C NDaten rvsbat testsNDSNNEW TEST txt ENABLED Y LUID UID Files receiving by local station Loc with a virtual filename that includes the character set TESTFILE1 are renamed in DSNNEW TEST txt and saved in C NDaten rvsbat tests directory The parameters LUID and UID are without function Hint One of the parameters SID SIDORIG DSN and SIDDEST has to distinguish from existing jobstarts after receive Example for updating a jobstart after receive 214 rvsbat Batch Interface RESENTR u SIDORIG DSN TESTFILE1 SIDDEST LOC DSNNEW C NDaten rvsbat testsNDSNNEW TEST txt REPLACE Y ENABLED Y LUID UID In example above the previously created jobstart is updated as follows Existing files with the same name like the new one are replaced REPLACE Y By default the existing file is kept and a timestamp is added to the name of new file Hint The parameters SID SIDORIG and DSN must be identical to the jobstart that is to be updated DELETE Example for deletion of a jobstart after receive RESENTR DELETE SIDORIG DSN TESTF
89. EERP NERP TSTAMP No Function for compatibility with rvs amp portable Possible values Y N default XID Parameter for an external JobID which can refer to several rvsEVO JobIDs The external JobID is a string of alphanumeric characters GUI name External Job ID 14 3 Managing of Jobstarts via rvsbat In this Chapter you get information about managing of jobstarts via rvsbat Jobstarts after receive RESENTR command after send attempt SENDJOB command and after processing error FAILURE command can be created modified or deleted Please read chapter 9 2 1 Creating a Jobstart for further information about jobstarts You can create update or delete a jobstart by starting rvsbat and thereafter entering the appropriate command in the command promt or by reading the command from an input file see chapter 14 1 2 and 14 1 3 14 3 1 Jobstart after Receive You can use the RESENTR command of rvsbat script for managing Jobstarts after receive in accordance with resident receive entries in rvs portable rvsEVO User Manual Version 6 01 Rev 28 10 15 213 Q T Systems rvs Systems rvsEVO User Manual CREATE Update The function that is to be executed can be indicated with the RESENTR command RESENTR CREATE or C create a jobstart after receive RESENTR UPDATE or U edita jobstart after receive
90. ER iint tae aed Renee as 167 12 2 updateStationList wad Sey ale ed canal Sy PRE ee RENTA NM ote eee 167 12 3 File Transmission em Sy cae re 168 12 3 LAGUIVALESIANON Ser e reci od fas CR RC RO RD ma En RU RO OR Re iw Tres 168 12 3 2crealeSendJob u ica ec ee Rr US RASA Xx aan ihr ages 169 12 3 3handleEERP Deleting or releasing EERPs Lulslslsssllslssssssse 174 1253 4DOl JOD s aoo btt DER Re ACR BS eS er EXPE ese pes utem dira d ep d 174 1253 5delete JOD as e espe edo o ba E UO P ponat Eo wt GR ED iis 175 12 3 6deleteJobsOlder Delete Old Jobs 20 0 0 cee 176 12 3 releaseJoD rok s Fenton tached te Rid no RAS EIS ET ea 177 T2 eBrestabtdOD e eos tono Cat deor abt n elegante esce d nut M idles Send Aceon A dd ede iG 177 12 3 SST MINAlCSCSSION sz roe xav dedo Exc ee Ebr E ea hk d estu 178 124 Display dob D Ala oos es tere punte A put sab d re eui AM Rice 179 12 4 1getJoblist Listing of all Send and Receive Jobs 0 0 eee eee 179 12 4 2getJob Information on a job entry 00 es 180 12 4 3getJobInfoList Create an XML File for an External JobID 200005 181 12 5 VSG A atta ae s ar oet e ite Ta er eke eh ct A 188 12 6 restartListener oue ues rx he a Re deed dA S ndi E unes 190 rvsEVO Benutzerhandbuch 12 7 cleanup Deletion of Jobs and Monlog Data from the Database 191 12 8 archiveJobs Deletion of Job Data from Database 0 0 00
91. EVO 19 1 Derby Derby database is a free java based relational database from Apache Foundation If you select Derby Embedded during the installation proce dure a database will be automatically by rvsEVO installed in the directory RVS HOME db 19 2 Microsoft SQL Server Pre conditions The following pre conditions must be fulfilled if you decided for an MS SQL database aMS SQL user was set up with server role PUBLIC and CONNECT permission aMS SQL database was created and the user was defined as database owner VSEVO was tested with MS SQLServer 2008 R2 MS SQL connec During rvsEVO installation process see chapter 2 4 Fresh installation of tion parameters rvsEVO the following MS SQL connection parameters must be set jdbc url jdbc user jdbc password jdbc url has the following syntax jdbe sqlserver lt host gt lt port gt database lt name gt Example dbc sqlserver 10 33 72 18 1433 databaseName rvsdb Default port for MS SQL is 1433 vc rvsEVO User Manual Version 6 01 Rev 28 10 15 237 Q T Systems rvs Systems rvsEVO User Manual Pre conditions Connection para meters 19 3 Oracle The following pre conditions must be fulfilled if you decided yourself for an Oracle database an Oracle database user was set up with the user rights connect resource create session andcreate table your Oracle configuration is accurate If an Ora
92. EVO User Manual Version 6 01 Rev 28 10 15 205 Q T Systems rvs Systems rvsEVO User Manual 206 rvsbat Batch Interface 14 rvsbat Batch Interface rvsbat is for compability with rvs portable rvsbat gives you an addi tional possibility for creating send jobs and managing jobstarts 14 4 Working with rvsbat In order to create a send job or to manage jobstarts via rvsbat follow the procedure given below start rvsbat via command line enter the command for send jobs SEND or for management of jobstarts RESENTR SENDJOB Or FAILURE via input file see chapter 14 1 2 or via the command prompt window see chapter 14 1 3 Hint Commands and parameters are not case sensitive 14 1 1 Starting rvsbat rvsbat tool is located in RVS_HOME bin directory and can be started via command line Syntax rvsbat c i lt input file gt q Optional rvsbat Parameters Parameter Description i input Read commands from input file The input file may contain the following elements Comment lines starting with Commands may extend over several lines by specifying as the last character in the line to be continued c Continue with rvsbat after an error occured during execution of a utility command By default rvsbat will terminate after an error q Execute user commands in quiet mode i e do not echo them to standard output feedback
93. FE Systems rvsEVO Version 6 01 User Manual rvsEVO User Manual rvsEVO Version 6 01 User Manual 2015 by T Systems International GmbH Holzhauser Stra e 4 8 13509 Berlin This manual is protected by copyright All rights reserved No part of this book may be used or reproduced in any form or by any means including photocopies microfilm or any other means or stored in a database or retrieval system without obtaining prior permis sion from T Systems Rights are also reserved as far as lectures radio and television is concerned We reserve the right to make changes to the content of this manual without giving prior notice T Systems is not liable for technical or printing errors or defects in this manual Moreover T Systems shall not be liable for damage which is directly or indirectly caused by delivery performance and use of this material Content 1 INTOCUCHON Goi once bees eee ees I ee ee ee eee 9 1 1 Short description of the system u 23a a u SR Reha a en Wes ee Pe RS 9 1 2 INSEVO Tiny Editi n kens DE RESO voee TERI EP RE Es vg 11 1 2 rvsEVO Light Edition ou ide soie tamtn mod uh pups ROI Sed n Ud aS SU c wah Cerita d 12 1 4 wsEVO Standard Edition us men xe ER RR doe ek ae 12 1 5 IVSEVO Enterprise Edition s Loose cress oad ke diets ce diet ee 13 1 6 Representation means sisse yee ee eee eRe awa ee RUE See EE ees 14 122 Farget group eeces dot re euet avis ele Db es E duse Set vnd 14 2 In
94. ID gt StationID of the station whose certificate should be sent Optional Parameters Parameter i lt keyIndex gt Description Index of the certificate to be sent If not indicated all certificates of the originator are sent You find the index in the list view and detailed view of a certificate verbose Verbose message output rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 193 rvsEVO User Manual Optional Parameters Parameter Description Requests help information Optional Remote Parameters Parameter SU lt user gt Description Client user for remote login Sp lt password gt Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server 12 10 2 requestCertificate With this tool a certificate for file encryption can be requested from a partner station and an own one can be delivered to this station Virtual file name for ODETTE transfer is ODETTE CERTIFICATE REQUEST Syntax requestCertificate s stationID i s su user sp password sh lt host port gt help verbose v Required Parameter Parameter S lt stationID gt Description ID of the station from which the certificate should be requested Optiona
95. ILE1 In example obove the previously created jobstart is deleted Hint The parameters SID SIDORIG and DSN are requested 14 3 2 Jobstart after Send Attampt Use the SENDJOB command to create edit or delete a jobstart after send attempt The function that is to be executed can be indicated with the SENDJOB command Commands SENDJOB CREATE or C create a jobstart after send attempt SENDJOB UPDATE or U edita jobstart after send attempt SENDJOB DELETE or D delete a jobstart after send attempt Syntax SENDJOB CREATE VDSN filename SID receiver sid ATTEMPTS set id COMMENT lt text gt ENABLED lt set id EXECSYNC set id EXECTIMEOUT set id JOB scrip name PARAMHANDLING lt set id SHELL lt set id SIDSENDER originator sid SIDORIG originator sid UID lt set id SENDJOB parameters supported by rvsRVO Required parameters SID 2 SIDDEST VDSN ATTEMPTS Optional parameters COMMENT ENABLED EXECSYNC EXECTIMEOUT JOB PARAMHANDLING SHELL SIDSENDER SIDORIG Parameters without function for compatibility with rvs portable UID COMPRESSION ENCRYPTION The table in chapter 14 3 4 Jobstart Parameters shows the description of the parameters
96. If TSLAutoUpdate v an automatic update of TSL takes place when the time in parameter TSLAutoUpdateNext is reached See also parameter TSLAutoUpdatelnterval Possible values Y 2 Yes N No default 158 Customizing the Global rvsEVO Parameters Security Parameters Parameter TSLAutoUpdatelnterval Description Time interval for checking parameter TSLAu toUpdateNext A description of the format you can find under http quartzschedu ler org The whole URL you can find below the table Exmples 000 The update is executed daily at 12 00 am default 015 10 The update is executed daily at 10 15 am 0 0 0 6 12 18 The update is executed daily at 12 00 am 6 00 am 12 00 pm and 6 00 pm See also parameter TSLAutoUpdate TSLAutoUpdateNext Time of next automatic TSL update TSLAutoUpdateURI Link to TSL default http www odette org TSL TSL Basic XML With HTTP connection the parameters CRLHttpProxyHost CRLHttpProxyPort CRLHttpProxyUser and CRLHttpProxyPass word should be setted TisCertificateValidati onBehavior Possible values NORMAL default Only the Root or CA certifi cate has to be imported for TLS encryption iden tical to rvsEVO version 5 xx In this case with CRL validation the validation URI must be entered in intermediate or root certificate Hint Value NORMAL replaces LEGACY But LEGACY can also be used DEFAULT In add
97. In this chapter the jobstarts and the Observer automatic generation of send jobs are described 9 1 The User Interface of Automation Perspective Select the menu item View in the function bar and thereafter the subentry Automation to open the Automation perspective The illustration below shows the default view of Standard Edition File View Window Help x v amp o m SF Automation Key Manage gj Monitoring ma Parameter Automation 52 im Automation E3 Jobstarts lk After Receive lk After Send Attempts After Fail S Observer Live Monitor Log 23 Live Monitor Log Date Time Level Module Message Session Station 20140307 0955 INF CTRL CLEANUP COMPLETED 20140307 1005 INF CTRL CLEANUP STARTED m Active RDDE9D84 3755 6 00 03 SNAPSHOT 03 06 00 45 06 SE The symbol in the function bar provides the following functionalities Create Jobstart page 120 Jobstart After Receive Jobstart After Send Attempts Jobstart After Failure Create Observer page 136 Below the navigation tree provides the following entries for list output Jobstarts all jobstarts After Receive After Send Jobstart after Failure Observer automatic generation of send jobs rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 118 rvsEVO User Manual Via a mouse click on th
98. Note The authentication should be done with the X 509 certificates ISDN The ISDN parameters for a local station are described in the following table Please see the chapter 2 1 System Requirement for ISDN system requirements ISDN is only for Windows platform available rvsEVO User Manual Version 6 01 Rev 28 10 15 49 Q T Systems rvs Systems rvsEVO User Manual ISDN Parameters Local Parameter Receiver Number lt OrdinalNumber gt Description Number for differentiating the various receiving channels through which the local station can be reached Each number has a tab with a set of ISDN parameters rvsEVO automatically assigns and manages this number Default 1 Enabled enabled This parameter defines whether or not the ISDN listener is enabled or disabled Default disabled ISDN Address An ISDN number of your local station For the Address 1TR6 ISDN standard the single digit EndSelec tionNumber ESN is assigned to the local sta tion Default Type not configurable Determines the type of connec lt DeviceType gt Card Number lt DeviceCardNumber gt tion within your computer CAPI2 Default CAPI2A A no Diehl Eicon card Number of the ISDN card installed in the compu ter Default 1 ISDN Protocol Specifies the ISDN standard used lt Protocol gt 1TR6 German national standard E DSS1 EURO ISDN Default E D
99. O Serverfarm 00 0 000 eee 225 15 4 Update of rvsEVO Serverfarm 22H 0 000 tee 226 16 ODETTE Protocol 4 odere v REIR Ek eM cess E EE Sa ieee es 229 17 rvs OFTP Proxy dura era eGR a quur niat eu acd eae IE LT 231 1721 ABASICS 4 bse when epo ea Le ey AR qued ee depu wean dos 231 17 2 rvs OFTP Proxy Architecture 02 000 c cece eee ees 231 17 3 Bastion Nsiance iso ERE XE REOR E ee 233 rvsEVO Benutzerhandbuch 18 FileService Module 002030260 824505 a a ERA 235 18 1 BASICS e ade seh x e RC DEE RR ceu t ast tin ee BR eR ed 235 18 2 Architecture of File Service Module llle 235 18 3 Setting up of a Neighbour Station for File Service Module 005 236 19 rvsEVO Database 2 o i ret mn gus ko eR RIA RR OR Rim n 237 19 1 DONO a a e te rr boe Quemar eet en t aom c vec Renae ee open edo ra n t 237 19 2 Microsoft SQL Server ot nk tranteg ee dicis OR adeo e E ROME ACE AUNT E is 237 19 3 NIAC oso oca E Re Wa ed ie C a Se Moo eq ars 238 19 4 Connection Podere eu ot es HU ved e Ubi s rostri ESO AE 239 19 5 How to Delete and Create the Database Tables 0 0000 eee eee eee 240 19 6 Database Maintenance 0 00 240 19 6 1createDefaultQueries 00 255 cs He ER RR re er oe 241 19 6 2doWhnloSdG S ann irat EN ERN o cs OC Et ROG Se o stc a es 241 19 6 3exportCertificateUsageDefinition Export of the Definition of Certificate Usage 241 19 6 4importCertificateUsageDe
100. OFTP security para meters Click Finish to add the neighbour station or Next to continue a wi Add Neighbour Station mina Tien EU OFTP Security Parameters Security Configuration Authentication PKI Certificate Validation Type File Encryption Hash Algorithm NONE OPTIONAL SHA 1 x The next dialog offers the possibility to set up the parameters for OFTP File Service Proxy Click Finish to add the neighbour station or Next continue 58 Management of Stations OFTP File Service Proxy Parameters Settings in case rvsEVO File Service Module is used File Service Proxy NONE Security Feature Set 1 None Compression Encryption File Signature ERP Signature Encryption Algorithm rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 59 rvsEVO User Manual The last parameters are contact data Click Finish to add the neighbour station r x wl Add Neighbour Station er Contact Details E Information about Company and Contact Person Name Phone Remarks Enterprise Location Street Street Number Department Person Fax Email Internet Cancel Hint You can add a neighour station with identical settings to an existing station Right click the neighbour station that is to be duplicated and select Duplicate Station entry from the combo box T
101. Open Definition Or Open Definition in New View from the context menu In this view the filter criterias can be added deleted or changed like described in chapter 6 5 1 Create Transmission Queries 6 5 3 Deleting of Transmission Queries You can delete a query via a right click on the query and then selecting Delete Query from the drop down menu 6 5 4 Job parameters In the following tables the job attributes are described Primary Job Information Parameter Description ID rvsEVO job ID Direction Direction SND sending or RCV receiving VDSN Virtual file name for Odette transfer SID Originator SID of the Originator station SID Destination SID of the recipient 90 File Transmission with rvsEVO Primary Job Information Parameter Source File Name Description The entire path of the original file this file is copied in the rvsEVO outbox directory Filename Path and name of the received or sent file Default is the file in inbox or outbox directory File Description File description Text comment possible with OFTP version 2 If your destination device is not OFTP 2 0 this field is ignored External Job ID ID for external application Other Job Details Parameter Status Description Job status For possible status values please see the rvsEVO user manual 6 5 5 Status for Send Jobs and Receive Jobs Last Change Time of the
102. Protocol OFTP to ensure the reliable transfer of a data set The OFTP enters a protocol session with the OFTP on the remote rvsEVO station which logically runs on top of the linedriver connection After the OFTP session has started both sides exchange their ODETTE IDs and passwords negotiate some parameters like ODETTE exchange buffer size ODETTE credit value the number of buffers the sending side can send without waiting for a response and exchange information about name approximate size and format of the data set to be trans ferred During transfer a compression and decompression of data is performed After the data have been transferred the byte count is checked between both sides After the data set has successfully been stored a receipt is sent to the sending station If the transfer has been disrupted for example by a link failure the OFTP protocol provides a mechanism that allows to restart the transfer at the point of rupture Change direction feature allows the receiver to become sender and to send acknowledgments and data sets For protocol details kindly refer to the publications of the ODETTE and VDA groups ODETTE Specifications for File Transfer Shown below is the general but simplified message flow within an ODETTE session The sending side acts as initiator the receiving side as responder Initiator sender Responder receiver Connect network connect gt lt SSRM
103. RGP log PIE ra Dr er KA IRE TCR RERO ed 205 13 9 race File Sm ora E envio Our deca Maure Mcr uM en LEE E a Ya a RR 205 14 rvsbat Batch Interface 0420 ne aaa 207 14 1 Working with rysSbat y a err ERE eh aont eO REESE AA ERIS EE I REG 207 14 1 18tarting Ivsbal cians td tongs Reg eee eee le es be de bd E rade 207 14 1 2lmport a Command via Input File lllellleelelselelen 207 14 1 3Call the Command via Command Prompt 00 c eee ee 208 14 2 Create a Send Job with SEND CREATE Command 22 222 neee rennen 208 14 2 1 Send Create Parameters Supported by rvsEVO 000 eee ee 209 14 3 Managing of Jobstarts via rvsbat 00 ee 213 14 3 1Jobstart after Receive an sr els Gunes duce Ae eh a an Ke RE ae 213 14 3 2Jobstart after Send Attampt wesen EN a ae ae ies 215 14 3 3Jobstart after Failure See a ate 2 ete eM es e eed de RO RUE 216 14 3 4 Jobstart Parameters see ER Ex REESE Ue m etes sd Rx Ree RU RE 217 15 Multi Instance Functionality of rusEVO lslssleeessss 223 15 T Introduellan a dre dee ree e Rx esee a E Seas qu x eae awe 223 15 1 1 ail Salgly wis iar hig dha eb adu varia tines dentate de lc it Rus s ln bor kot id Cla vro REN inh d 223 15 1 2Load Balancing eR en RE x peux x en 224 15 1 9 596alabilily 2 eere xh eret eroe Ero ehe qae ex oda anis ep lo V idit 224 15 2 System Requirements Architecture of a Serverfarm 2 0 0 c eee ee eee 224 15 3 Installation of a rvsEV
104. SS1 ISDN Facilities Special information or facilities of the ISDN trans lt Facilities gt mission ISDN User Data lt Userdata gt User data for the ISDN transmission ISDN Terminal Identifier lt Tei gt Only required for X 31 Terminal End Identifica tion Default 0 no TEI assigned Time Out Time Out in miliseconds after which the commu lt Timeout gt nication program the connection closes if the partner station does not answers Default 60 RCV Time Out Only valid for the local station Cancellation time lt RestartTimeOut gt in miliseconds after which the receiver interrupts the waiting for incoming calls and reconnects to the card driver Default 0 50 Management of Stations XOT ISDN Parameters Local Parameter Max Incomming Sessi ons lt Sessions gt Description Maximal number of simultaneous active receipt processes on the same channel Default 1 Maximum 100 X 25 Address lt X25Address gt 15 digit X 25 DTE address of the local station This number is optional It is however advisable for an ISDN connection to enter the ISDN number here as some partners expect an X 25 address X 25 PacketSize lt PacketSize gt Size of data packets during data transmission Default 128 X 25 WindowSize lt WindowSize gt X 25 Facilities lt X25Facilities gt Window size in X 25 ISDN communication is the number of packets that can be outst
105. Security Feature Set Compression Encryption Encryption algorithm File signature and Request signed EERP NERP 138 Automation with rvsEVO Security Parameters Security Parameters for Observer d Security Feature Set 1 None Compression Encryption Encryption algorithm None File signature Request signed EERP NERP m E n d Create the Observer with a single click on Finish button In the next dialog you are given a brief overview of selections you have made The last dialog informs about the successful creation of a new Observer In the following table the observer parameters are described Observer parameters Parameter Description Enabled This parameter defines if the feature observer is active or not Time Time interval between two checks Directory Directory which should be scanned Mask The regular expression which should be applied The wildcards for one sign and for one or more signs and are permitted If it finds them it will create a send entry All other parameters from an Observer panel are for the sending a file Please see chapter 6 2 1 Send Parameters for further information Notes You can use the wildcard in the Observer parameter VDSN for taking rvsEVO User Manual Version 6 01 Rev 28 10 15 139 Q T Systems rvs Systems rvsEVO User Manual over segments of
106. TTE group parameters rvsEVO User Manual Version 6 01 Rev 28 10 15 61 Q T Systems rvs Systems rvsEVO User Manual Required OFTP Parameters Partner Parameter Description Odette ID ODETTE ID is a worldwide unique identification lt OdettelD gt of all nodes using the ODETTE file transfer proto col OFTP This 25 character name consists of the letter o an 18 character organization identifier provided by the ODETTE codification group and a6 character computer sub address that is administrated by each organization OFTP Version which OFTP version should be used Possible lt Level gt values 1 3 1 4 and 2 0 Optional OFTP Parameters Partner Parameter Receive Password lt PasswordReceive gt Description The password rvsEVO expects from the neigh bour station Send Password lt PasswordSend gt The password rvsEVO sends to the neighbour ODETTE password exchange between two neig hbour stations and verification always occurs while a sessio n is being established Hint With activateStation tool chapter 12 3 1 this password can be overwritten tem porarily for the unique connection EERP in lt EERPIn gt Procedure for receiving receipts EERPs NERPs Possible values NORMAL The transmission is successfully termi nated after receiving of EERP NEVER no EERP is needed The transmission can be terminated without receiving a receipt Hint some operator
107. The standard window size for modulo 8 is 2 Default 8 5 3 Neighbour Stations This chapter shows how to add or delete a neighbour station and how to set up the parameters of a neighbour station 5 3 1 Add a Neighbour Station Follow the description below to add a neighbour station Right click the local station and select Add Neighbour Station from the drop down menu or click the Add Neighbour Station icon in the function bar Select a network for the communication Possible are TCP IP TLS Proxy TCP IP Proxy TLS XOT and ISDN A TLS connection is rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 53 rvsEVO User Manual needed for line encryption Click Next to continue Network type selection Please select the network type Supported neighbour station network types eicB OTLS Proxy TCP Proxy TLS XOT ISDN Inthe next window you have to insert the station ID Odette ID OFTP Version IP Address or hostname of your neighbour station In Remark field you can insert a text Click Finish to add the neighbour station or Next to insert the optional parameters 54 Management of Stations TCP Mandatory Parameters Mandatory parameters for TCP SID Odette ID OFTP Version IP Address Remark If needed define the optional parameters and click Finish to add the neighbour station or Next to insert the optional
108. The XOT parameters for a local station are described in the following table XOT Parameters Local Parameter Ordinal Number lt OrdinalNumber gt Description Number for differentiating the various receiving channels through which the local station can be reached Each number has a tab with a set of ISDN parameters rvsEVO automatically assigns and manages this number Default 1 Enabled lt enabled gt This parameter defines whether or not the XOT listener is enabled or disabled Default disabled Local IP address Local station only optional own IP address IP addresses have the form 255 255 255 255 f you have not specified a value for the local sta tion you permit automatic definition of the IP address If your own station has only one IP address this field should be left empty Local Port lt LocalPort gt Port of the local station Default 1998 for XOT communication X 25 Address lt X25Address gt 15 digit X 25 DTE address of the local station This number is optional It is however advisable for an ISDN connection to enter the ISDN number here as some partners expect an X 25 address Max Incomming Sessi ons Maximal number of simultaneous active receipt processes on the same channel lt Sessions gt Default 1 Maximum 100 Time Out Time Out in miliseconds after which the commu lt Timeout gt nication program the connection closes if the partner station doe
109. Use the get Joblist program to list all jobs Syntax getJobList a e verbose help su lt user gt sp lt password gt sh lt host port gt Optional Parameters Parameter Description a Detailed information on jobs currently being pro cessed in addition display of creation date SID of neighbour station and VDSN ac S Additional information on original filename e Information on determinated jobs f Information on failed jobs verbose Verbose message output help Displays a description of the current command 2 Requests help information rvsEVO User Manual Version 6 01 Rev 28 10 15 179 Q T Systems rvs Systems rvsEVO User Manual Optional Remote Parameters Parameter Description su lt user gt Client user for remote login Sp lt password gt Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server If you call getJobList without parameter the display contains a list of all jobs currently being processed Examples getJobList e Result rusEU0_66661 bin gt getJobList a ob Transmission Status CreatedAt SIDORG SID UDSN 1402131138150000 lt SND gt SCHEDULED 13 62 14 11 38 15 LO EV054 TESTFILE TRT 1 4621311393766688 lt SND gt SCHEDULED 13 62 14 11 39 37 LO EUO54 TEST54 1312161250560000 lt SND gt PREPROGESSING_FAILED 16 12 13
110. VS NERP REASON CODE lt nerpReasonCode gt Nerp Reason Code RVS NERP REASON TEXT lt nerpReasonText gt Nerp Reason Text RVS RECORD FORMAT lt recordFormat gt Format RVS RECORD LENGTH lt recordLength gt Record Length RVS RESTART POSITION lt restartPos gt Restart Position RVS SECURITY FEATURE SET lt securityFeatureSet gt Security Feature Set RVS SEND ATTEMPTS lt sendAttempts gt Send Attempts RVS SERIALIZE lt serialization gt Serialization RVS SID lt SID gt RVS SID DESTINATION lt sidDestination gt SID Destination RVS SID ORIGINATOR lt sidOriginator gt SID Originatior RVS SIGNATURE sign File Signature RVS SIGNATURE EERP lt signEERP gt Request Signed EERP NERP RVS STATUS status Status RVS TIME Time of lt creationDate gt RVS TIME START FILE lt timeStartFile gt Time Start File RVS TRANSMITTED BYTES lt transmittedBytes gt Bytes Trans mitted RVS VDSN lt VDSN gt VDSN The table Explanation of the job attributes on page 182 shows the description of the environment variables Parameter Handling REPLACE A copy of the denoted file is created and discarded into t emp directory The placeholders of the scripts are substituted for job data The placeholders are encased by e g move DSN home rvsevo incomming becomes move home rvsevo rvsEVO files inbox TEST TXT home rvsevo incomming With MAINTENANCE parameter PermissionTempScript
111. Window Help Sr 3 Automation E Key Manage HB Monitoring Parameter 8 Stations iy Transfer User M E Parameter 52 amp m LH Pa meter NOTIFICATION X S e Parameter Parameter NOTIFICATION 4 rj Parameter Groups EURE A BASIC CENTRAL_JOURNAL AgentActive N DIRECTORIES AgentHeartbeatintervall 30000 J MAINTENANCE AgentHostname localhost J NOTIFICATION AgentLogL evel 0 ODETTE AgentPort 3744 RESOURCES_CHECK v SECURITY m ave ance E Live Monitor Log 23 Active RDDE9D84 3755 6 00 03 2014 0 10 09 33 30 SE e You can find the installer of rvs SNMP Agent in the RVS_HOME SNMP Agent directory For more information about this feature please read the rvs SNMP Agent User Manual After installation of rvs SNMP Agent the manual is stored in C Programs rvsSNMPAgent doc directory by default rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 149 rvsEVO User Manual The following parameters have to be edited in rvsEVO to be able to work with rvs SNMP Agent Parameters for Notification Parameter Description AgentActive This parameter defines whether or not rvs SNMP Agent is enabled Possible values v Yes or N No Default v Yes AgentHeartbeat Intervall This parameter defines the interval in seconds at which rvsEVO sends a Heartbeat message to the Agent UDP address
112. XP rvsX Syntax importTSL f TSL filename verbose v help Ie Hint Don t use this functionality with 2048 bit keys Required Parameters Parameter Description pri private key gt Name and path of private ComSecure key 198 Command Line Tools Required Parameters Parameter Description pub lt public key gt Name and path of public ComSecure key see also parameter x509 s lt sid gt StationID of the station the key pair belongs to x509 x509 filename Name and path of public key instead of pub if the certificate is in X 509 format Optional Parameters Parameter Description help Displays a description of the current command Requests help information 12 11 showCRLs Use this tool to display a list of the imoprted CRLs Certificate Rovocation List Syntax showCrl help verbose v Optional Parameters Parameter Description verbose Verbose message output help Displays a description of the current command 2 Requests help information 12 12 Display Monitor Messages 12 12 1 showMonitorLog Trace Current Monitor Messages Use the showMonitorLog program to trace the current monitor messages and to analyze error messages When starting the program the last 25 messages are displayed Syntax showMonitorLog help verbose v rvsEVO User Manual
113. about success or failure of the operation will still be provided 14 1 2 Import a Command via Input File Using the example of SEND CREATE command we describe what steps are neccessary to import the rvsbat commands and the parameters via input file rvsEVO User Manual Version 6 01 Rev 28 10 15 207 Q T Systems rvs Systems rvsEVO User Manual Provide the file to be transfered example test t xt Provide the input file which contains the rvsbat command and send parameters Example for an input file input txt SEND C SIDORIG LOC DSN C docs test txt SID EVO54E DSNNEW TESTVDSN In the above example a send job is created for sending the file C docs test txt from local station LOC to station EVO54E with VDSN TESTVDSN e Start rvsbat with the input file input txt Expample rvsbat Ic docs input txt 14 1 3 Call the Command via Command Prompt To enter the rvsbat commands and the parameters into the command prompt follow the procedure given below using the example of SEND CREATE command Call rvsbat via command prompt Example rvsbat Input the commands and the send parameters into the prompt window after rvsbat was started successfully message Command START USER successfully executed Example SEND CREATE SIDORIG LOC DSN C docs test txt SID EVO54E DSNNEW TESTVDSN
114. and Contact Details Please see Chapter 22 PKI Connection for getting information of PKI and Certificate Validation Type Parameters The description of the other parameters you can find in chapter 5 3 3 Parameter Groups of the Partner Station Hint You can add a virtual station with identical settings to an existing station Right click the virtual station that is to be duplicated and select Duplicate Station entry from the combo box The settings of the duplicated stations are used as default values of the new station SID and Odette ID parameters must be changed The remaining parameters can also be edited if neccesary 5 5 2 Setting up a Virtual Station Please see chapter 5 3 2 Setting up of a Neighbour Station The procedure is the same with all stations 5 5 3 Further Functionalities A right click opens a drop down menu which offers the following additi onaloptions Open In New View Duplicate Station Delete Entry The description of this functionalities you can find in chapter 5 3 Neighbour Stations Hint At the partner station the treatment of a virtual station is the same as the treatment of a routed station 72 Management of Stations 5 6 Proxy Bastion You need to add a Proxy Bastion instance as pre condition for using the functionality rvs OFTP Proxy 5 6 1 Add Proxy Bastion Click on Add Proxy Bastion icon in the function bar The dialog box below opens and you can edit the paramet
115. anding wit hout acknowledgment The window size will be negotiated during connection setup but we recommend you to use the correct window size depending on the partner network Possible values 1 7 default 7 We recommend 7 for ISDN and 2 for X 25 native Special information or facilities of the ISDN trans mission X 25 User Data User data for the ISDN transmission lt X25UserData gt X 25 Dbit D bit Delivery Confirmation an X 25 data packet lt DBit gt flag used to request end to end acknowledgment for the packet X 25 Closed User Group lt ClosedUserGroup gt SDN and X 25 allow for the formation of a closed user group Allmembers of such a group can communicate with each other via the public tele communication network Connection requests to group members received from participants not being a member of the closed user group will be rejected by the switching exchange The same applies to connection requests from group mem bers to participants not being a member of the closed user group This service attribute is called Closed User Group CUG XOT X 25 over TCP IP routers are able to route X 25 packets between a TCP IP network on one side and an X 25 or ISDN network on the other side System requirements Please read the chapter XOT systems requirement on page 19 rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 51 rvsEVO User Manual
116. anual true the certificate usage will be checked and the key is used for encryption only if Key Encipherment parameter is activated in the certificate false the settings of X 509 certificate will not be checked javax net debug ssl Via this definition you can activate the debug display for TSL connec tions By default this is disabled rvs_evo controller check_security_by_sfid false If OFTP parameter of partner station File Encryption forced via this definition you can define that the setting is also valid for ComSe cure Possible values true The setting of File Encryption parameter refers to OFTP transmission only Unencrypted files are refused with File Negative Answer SFNA false The setting of File Encryption parameter refers to ComSe cure too Unencrypted files are refused with End Session Indication ESID after receiving of the first data package java rmi server hostname lt IP gt IP address for RMI communication 162 User Management 11 User Management Via User Management perspective you can create edit or delete users and display user lists or detailed information of a user Hint The User Management perspective is only available for user with admi nistrator rights The data of default user cannot be edited or deleted 11 4 User Interface of User Management Perspective Select the menu item View in the function bar and thereafter the subentry User Management to open
117. archiveJob Deletion of an Individual Job from the Database Hint The name of the program is historical Up to rvsEVO version 6 00 archiveJob was used for archiving jobs Use this program to delete the data of a specific ended or failed transmis sion job which is older than the defined date Syntax archiveJob j lt arg gt help verbose v 192 Command Line Tools Required Parameter Parameter jobID lt arg gt j lt arg gt Description ID of the job jobs to be deleted Several job ID have to be seperated by comma Optional Parameters Parameter Description verbose Verbose message output help Displays a description of the current command Requests help information 12 10 Key Management with rvsEVO 12 10 1 deliverCertificate With this tool a certain certificate for file encryption can be delivered to a partner station and imported in its database Virtual file name for ODETTE transfer is OD Syntax deliverCertificate s lt stationID gt KITE ERTIFI DEL IV G CATE ER 1 lt keyIndex gt r lt stationID gt su user sp password sh host port help verbose v Required Parameters Parameter Description r lt stationID gt StationID of the partner station to which the certi ficate should be sent S lt station
118. are to file lt File gt be imported Optional Parameters Parameter Description r To replace a file with the same name if neces replace sary If a file with the same name is present and this parameter was not set the process is failed with an error message h Displays a description of the current command help Displays a description of the current command V Verbose message output verbose 19 6 4 importCertificateUsageDefinition Import of the Definition of Certificate Usage Use this tool to import the definition of certificate usage into the database and delete the present database entries Syntax importCertificateUsageDeninition f File c help verbose v Required Parameter Parameter Description f lt File gt Path and name of the file from which the data are file lt File gt to be imported into the database 242 rvsEVO Database Optional Parameters Parameter C clean Description to delete the old data before new data are impor ted h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 5 exportConfiguration Export of rvsEVO Configuration Data Use this tool to export the rvsEVO configuration data from the database into a file and replace a file with the same name if ne
119. arters f lt File gt r help verbose v Required Parameter Parameter Description f lt File gt Path and name of the file in which the jobstart file lt File gt data are to be imported 246 rvsEVO Database Optional Parameters Parameter r replace Description To replace a file with the same name if neces sary If a file with the same name is present and this parameter was not set the process is failed with an error message h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 11 importJobstarters Import of Jobstart Files Use this tool to import the data of jobstarts into the database and delete the present jobstart data Syntax importJobstarters f verbose v Required Parameter File c help Parameter f lt File gt file lt File gt Description Path and name of the file from which the data are to be imported into the database Optional Parameters Parameter C clean Description To delete the old data before new jobstart data are imported h help Displays a description of the current command V verbose Displays a description of the current command Verbose message output rvsEVO User Manual Version 6 01 Rev
120. ase Optionale Parameter Parameter r Beschreibung Remote availables deletion during rvsEVO is running t type Type of entry to be deleted Possible values JOBS default data of ended or failed jobs MONLOG monlog data ALL jobs and monlog data help Requests help information Displays a description of the current command rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 191 rvsEVO User Manual Optionale Parameter Parameter Beschreibung verbose v Verbose message output 12 8 archiveJobs Deletion of Job Data from Database Hint The name of the program is historical Up to rvsEVO version 6 00 archiveJob was used for archiving jobs Use this program to delete ended and failed transmission jobs from the database which are older than the defined date Syntax archiveJobs d lt date gt r help verbose v Required Parameter Parameter Description d lt date gt This option needs a date in the following format yyMMddHHmmss or yyMMdd The jobs which are older than the date will be deleted from the data base Optional Parameters Parameter Description r remote availables deletion during rvsEVO is run ning verbose Verbose message output help Displays a description of the current command Requests help information 12 9
121. ata Use this tool for importing user data into the database and deleting the present users Syntax importUsers f File c help verbose v Required Parameter Parameter f lt File gt file lt File gt Description Path and name of the file from which the data are to be imported into the database Optional Parameters Parameter C clean h help Description to delete the old user data before new data are imported Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 27 switchDatabase Exchange of Database Use this tool to exchange the rvsEVO database rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 257 rvsEVO User Manual Syntax switchDatabase dbtype type driver driver url url username name password password jdbcfile path skiptest switchonly testonly help h verbose v Required Parameters Parameter Description dbtype Type of database Possible values derby oracle mssql Optional Parameters Parameter Description driver Name and path of jdbc driver url jdbc URL see chapter Kapiteln 19 2 MS SQL und 19 3 Oracle username Login name of database user password Password of databa
122. ate Time Text a E 2015 07 02 09 34 12 696 L schen von ENDEND FAILED Jobs lter als 150625093412 gestartet a u 0ta 7n Inhliste wird reinitialisiert m nt Active RDDE9D84 3755 6 01 02 SNAPSHOT 6 30 00 20 01 SE The symbols in the function bar provide the following functionalities Add Neighbour Station Add Virtual Station Add Proxy Bastion rvsEVO User Manual Version 6 01 Rev 28 10 15 43 T Systems rvs Systems rvsEVO User Manual Navigation tree List view Proxy Bastion List Stations Recently Accessed Show Live Monitor Log Active Panel Reset Perspective Thereunder the view Stations offers the following functionalities via tool bar Focus on next routed station in current station view view of neighbour station Navigation to first routed station view of routed station Navi gation to the next routed station Focus on neighbour station in current station view Focus on local station in current station view Reload Column configuration Minimize Maximize In the stations view the navigation tree is positioned All existing stations local station virtual stations Neighbour stations and routed stations are displayed in the navigation tree A click on the small arrow to the left of the connection type TCP IP ISDN XOT TLS Proxy TCP IP or Proxy TLS which is reachable via the entry Partner stations blends or masks out the neighb
123. ated with creation 14 3 3 Jobstart after Failure Use the FATLURE command to create edit or delete a jobstart after processing error The function that is to be executed can be indicated with the FAILURE command Commands FAILURE CREATE or C create a jobstart after processing error FAILURE UPDATE or U edita jobstart after processing error FAILURE DELETE or D delete a jobstart after processing error Syntax FAILURE Create VDSN filename SIDDEST receiver sid SIDORIG originator sid COMMENT text ENABLED lt set id EXECSYNC lt set id EXECTIMEOUT lt set id JOB lt scrip name PARAMHANDLING lt set id SHELL set id FAILURE parameters supported by rvsRVO Required Parameter VDSN 216 rvsbat Batch Interface CREATE UPDATE DELETE Optional parameters COMMENT ENABLED EXECSYNC EXECTIMEOUT JOB PARAMHANDLING SHELL SIDDEST SIDORIG The table in chapter 14 3 4 Jobstart Parameters shows a description of the parameters Example for creation a jobstart after failure FAILURE C VDSN Test txt SIDORIG LOC SIDDEST RVS JOB C rvsTest scripts failure bat After receiving an error massage after send attempt of a file with VDSN Test txt from station LOC to station RVS the job C rvsTest s
124. b fsp dont keep receive file tru By default files received via FileServiceModul feature are kept until receiving the EERP If rvs evo routed job fsp dont keep receive file true this function is deactivated and the files are deleted after successful routing observer sfiddesc usefilename tru If the file transmission takes place via Observer you can define whether the original filename is to be used as file description SFID DESC rvs evo tracing odette enable network data true Via this definition you can define whether the network data is to be displayed in case of Odette tracing Possible Values true network data is to display default false no network data are displayed rvs_evo tracing odette station_ids SID1 SID2 SID3 If parameter Traceltem O parameter group ODETTE of Parameter perspective this definition enables Odette tracing per station Values SID for what Odette tracing is enabled Seperate multiple station IDs by comma rvs evo controller underscore in vdsn allowed true Use this definition to allow underscores in VDSN Possible values true underscores are admitted in VDSN false underscores are not admitted in VDSN default useKeyUsage false Via this definition you can define whether the certificate usage of X 509 certificate is to be considered or not rvsEVO User Manual Version 6 01 Rev 28 10 15 161 Q T Systems rvs Systems rvsEVO User M
125. been assured no file reception transmission and no encryption compression The system variable RVSENV is to be set for logged on user Set RVSENV by choosing Start Control Panel System Advanced Environment Variables The following steps need to be done for migration from rvs portable to rvsEVO Install rvsEVO on the same machine where rvsXP rvsX is installed like described in chapter 2 3 rvsEVO User Manual Version 6 01 Rev 28 10 15 29 T Systems rvs Systems rvsEVO User Manual The installer searches through your system for an existing rvs portable If you are asked whether you wish to import the settings from rvs portable press the Yes button Import rvsPortable X a rmvsPortable found Import settings stations and JS RE entries from msPortable Only with encrypted transmission import your own key pair with the program importComSecureKeyPair see chapter 12 10 8 importComSecureKeyPair Important If the public key is not existent in format X 509 you have to insert the additional information in the file SRVS_HOME conf certificate properties xml Sample file certificate properties xml l common name gt entry key subject cn gt rvsEVO comsecure j lt entry organisastion unit gt entry key subject ou gt rvs lt entry gt organisastion gt entry key subject o gt T Systems International GmbH l
126. byte of a file to be sent in decimal representation as a character string Default 1 Value of the last sent byte of a file to be sent in decimal representation as a character string Default 1 lastStateChange Time of the last change in the job status in the format DD MM YY HH MM SS lengthOriginFile Length of the original file while sending in bytes before processing through the service provider This parameter is set to 0 in case of receiving oidDest OdettelD of the target station oidNeighbor OdettelD of the neighboring station oidOrig OdettelD of the sending station Originator outputCharset without function recCount Number of the data records sent records recordFormat Format of the file to be transferred T Text a consequence of ASCII characters F Fixed fixed record length V variable variable record length U unstructured binary file recordLength Maximum record length Command Line Tools Explanation of the job attributes Parameter releaseAllowed Description This parameter gives information as to whether releasing a jobs depending on the status is allo wed Possible values true yes false no Default false restartPos restart position in case of which a new transfer of the file should be started scheduleDateTime Planned time for the job start in the form DD MM YY HH MM SS securityFeatureSe
127. c Brick you do not need an internal ISDN card In this configura tion several applications can share the same Brick router The Brick router supports the Remote CAPI interface This means that every computer in your LAN uses the Brick router as if it were a local ISDN card in the computer Note T Systems has successfully tested the following ISDN devices for use with rvsEVO ISDN Devices Device Manufacturer EICON DIVA Server BRI Eicon http www eicon de 2M EICON DIVA Pro 2 02 PCI Eicon http www eicon de EICON DIVA 2 0 Eicon http www eicon de Longshine LCS 8051A Longshine http www longshine de BIANCA BRICK XS Funkwerk EC XM XL2 X4000 http www funkwerk ec com X4100 X4300 R1200 R4100 und R4300 rvs Service Support Center will provide you with the current list of tested devices Phone from Germany 0800 664 77 45 Phone from other countries 49 375 606 19 902 Email rvs service t systems com Installation XOT systems requirement On demand we shall send you a separate document with examples how to configure CISCO or BinTec router for XOT To use the XOT functionality in rvsEVO you need a TCP IP connection to the XOT capable router e g CISCO 801 CISCO 2600 or BINTEC X4300 R1200 R4100 and R4300 CISCO http www cisco de BINTEC http www funkwerk ec com 2 2 Obtaining a License You need a license key to work with rvsEVO rvs after sa
128. can be opened The view in foreground is to be selected via tab The illustration below shows the Transfer perspective with the job list at the bottom and the detailed view on the right hand area rvsEVO User Manual Version 6 01 Rev 28 10 15 87 Q T Systems rvs Systems rvsEVO User Manual 32 Automation E5 Key Manage E Monitoring Parameter 8E Stations Sl Create Query Definition Query Result ENDED J E Job Details 140306140 3 Cl S ACTIVE SEND JOBS ACTIVE RECEIVE JOBS ENDED JOBS FAILED JOBS 4 ill Manage Templates RVS54 Standard v Primary Job Information ID Direction File Name Source File Name VDSN SID Originator SID Destination v Other Job Details SFID Counter SFID Date Time Status Job Details 1403061400540000 SND C rvsEVO 60001 files outboxXTestfile txt 1403061400540000 C Daten Testfile txt TESTFILE TXT LOC EVO54 0001 06 03 14 14 00 54 ENDED T QU Recreate J Xo Cleanup 3 Show Eror 2 Live Monitor Log 23 BE lt lm Live Monitor Log 20140306 1400 INF NET Date Time Level Module Message CONNECTION_CLOSE_SUCCESS m Session Station 477222 EVOS4 Tex Wee RDDE9D84 3755 6 00 03 SNAPSHOT 2014 03 06 00 45 06 SE 6 5 1 Create Transmission Queries To create transmission queries proceed as follows Right click Transmission Queries
129. cessary Syntax exportConfiguration f lt File gt r help verbose v Required Parameter Parameter f lt File gt file lt File gt Description Path and name of the file in which the configura tion data are to be imported Optional Parameters Parameter r replace Description To replace a file with the same name if neces sary If a file with the same name is present and this parameter was not set the process is failed with an error message h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 6 importConfiguration Import of rvsEVO Configuration Data rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 243 rvsEVO User Manual Use this tool to import the rvsEVO configuration data into the database and delete the present configuration data Syntax importConfiguration verbose v Required Parameter f File c heip Parameter f lt File gt file lt File gt Description Path and name of the file from which the data are to be imported into the database Optional Parameters Parameter Description C to delete the old data before new data are impor clean ted h Displays a description of the current command help
130. cle client is installed on your machine you can test the configuration with the following command sqlplus ORACLE user ORACLE Network servername password Example sqlplus skk RVS TSYSTEMS DE skk If this command could be executed successfilly if a user exists and a database is available you can start the rvsEVO installation The following Oracle database was tested Oracle 11g While installation of rvsEVO see Chapter 2 4 Fresh installation of rvsEVO the following Oracle connection parameters have to be set jdbc url has the following Syntax jdbc oracle thin lt server gt lt port gt lt servi Example thin localhost 1521 rvsORA jdbc oracle Default port for Oracle is 1521 jdbc url jdbc user jdbc password und Net Servic Name ce name Note If Oracle is running on an external computer this computer must be defined in the Oracle configuration file SORACLEHOME network admin tnsnames ora Example tnsnames ora TNSNAMES ORA Network Configuration File product 8 1 7 network admin tnsnames ora Generated by Oracle configuration tool RVS TSYSTEMS DE DESCRI PEE ON ADDRESS_LI ST ADDRESS 1521 PROTOCOL TCP HOST opt oracle S rvsaix3 PORT 238 rvsEVO Database CONNECT DATA SERVICE NAME rvsDB
131. cripts failure bat is to be started Hint The parameter VDSN has to distinguish from existing jobstarts after failure Example for updating a jobstart after failure FAILURE U VDSN Test txt SIDORIG LOC SIDDEST RVS JOB C rvsTest scripts failure bat ENABLED N In the example above the priviously created jobstart is disabled ENABLED y Hint The parameters VDSN SIDORIG and SIDDEST must be identical to the jobstart that is to be updated SIDORIG and SIDDEST only if indicated with creation Example for deletion a jobstart after failure FAILURE D VDSN Test txt SIDORIG LOC SIDDEST RVS In the example above the priviously created jobstart after failure is deleted Hint The parameters VDSN SIDORIG and SIDDEST are requested SIDORIG and SIDDEST only if indicated with creation 14 3 4 Jobstart Parameters The following table shows the description of the jobstart parameters Required Jobstart Parameters Parameter Description DSN only RESENTR Virtual file name Allowed SID string and wildcard at the end the beginning or instead of the string GUI name VDSN SID only SENDJOB Station ID of target station Allo or SIDDEST wed SID string and wildcard at the end GUI name SID of Destination SID only RESENTR Station ID of source station Allo wed SID string and wildcard at the end
132. d tools The user ID and password of the user arranged with the user administration must be specified for all the command line calls which are started remotely Example activateStation s SID u user p password 42 Management of Stations 5 Management of Stations To be ready for data exchange an entry in the stations configuration is needed for every participated station your local station the neighbour stations routed stations and virtual stations if needed The obligatory parameters for the local station have already been polled during installa tion 5 1 User Interface of Stations Perspective The stations management is reachable via menu item view gt Stations The illustration below shows the default view of stations pers pective in Standard Edition r ee MEE File View Window Help Jt 2 KB Sle Uy Transfer gj Monitoring P Stations a Key Management f Automation ma Parameter amp User Management GF Stations 2 A Buocx gu ww Z Lc Stations Tree General zi type filter text Loc Sene v Required Parameters fm Virtual stations Lg m ise E 4 Partner stations E 4 Sd Remark ai TCP TCP 1 emai E Stations Recently X 5 TCP 2 v Contact Details Name Stations Recently Phone Accessed Enterprise SID Odette ID LOC MOID E A od ri N Save Cancel E Live Monitor Log 22 e Ga Live Monitor Log EX Job D
133. de conversion PC Mainframe Additionally the following components can be linked communication components ISDN for Windows and XOT File Service Module Hint Please see the rvsEVO Product Datasheet for binding information of the technical data You can download the datasheet from the following adress https servicenet t systems com business inte gration rvs produktdatenblatt 927428 1 4 rvsEVO Standard Edition Features of rvsEVO Standard Edition subject to modifications 999 partner stations direct or routing partner 20 parallel connections sessions routing functionality 1 virtual station communication components TCP IP and TLS encryption and compression Derby database embedded Central Journal Introduction SNMP Agent code conversion PC Mainframe remote GUI Additionally the following components can be linked communication components ISDN for Windows and XOT File Service Proxy further virtual stations Hint Please see the rvsEVO Product Datasheet for binding information of the technical data You can download the datasheet from the following adress https servicenet t systems com business inte gration rvs produktdatenblatt 927428 1 5 rvsEVO Enterprise Edition rvsEVO Enterprise Edition provides all the basic requirements for secure data transfer with a simultaneous performance even at high loads rvsEVO Enterprise Editio
134. decryption the own key pair and the partner s public key It will no longer be possible to decrypt files sent by the partner if one of the three necessary keys is lost The private key is also needed for creating a signature 8 3 Electronic Signature rvsEVO uses electronic signature to increase security The signature ensures that data do not undergo any unnoticed changes during trans mission The electronic signature of the End To End Response EERP NERP ensures the traceability of data transmission 8 4 Key Management in rvsEVO This chapter describes how to create export and import keys as well as you get information about using CA certificates Hint From rvsEVO version 6 00 onwards there are fundamental impro vements in the key management simplified procedure for creating own key pairs independend of the functionality functional assignment of the keys certificates via management of stations saving of the keys certificates in the database ACX Request ACX Deliver and ACX Replace via graphical user inter face Only the administrator may execute the management of private keys 8 4 1 User Interface of the Perspective of Key Management The key management is reachable via menu item View Key Mana gement The illustration below shows the default view of perspective of key management in Standard Edition 106 Secure Transmission with rvsEVO File View Window Help X
135. ded and imported during the next establishment of connection Via security parameters CRLAutoUpdate and CRLAutoUpdatelnterval you can configure that automatic updates should take place See chapter 10 9 Security Parameters for the description of the parameters 268 Index Symbols RVS_HOME 14 RVSTINY_HOME 14 B bastion 229 C certificate properties 27 Client 37 Command Line Tools activateStation 168 archiveJob 191 archiveJobs 190 backup 257 cleanup 190 createSendJob 169 deliverCertificate 192 exportCertificate2ComSecure 195 exportCertificateUsageDefinition 238 exportConfiguration 240 exportJobs 242 exportJobstarters 243 exportObservers 246 exportOftpProxies 247 exportQueries 249 exportStationlist 250 exportUsers 252 getCertificateList 196 getJob 179 getJobInfoList 180 getJoblist 178 handleEERP 173 importCertificateUsageDefinition 239 importComSecureKeyPair 197 importComSecurePublicKey 195 importConfiguration 240 importJobs 242 importKeystores 246 importObservers 247 importOftpProxies 248 importQueries 249 importTSL 196 importUsers 253 releaseJob 176 replaceCertificate 194 requestCertificate 193 restartJob 176 restartListener 189 restore 258 rvsbat 205 rvsEVOservice 32 showCRLs 198 showMonitorLog 198 showMonitorLogFile 198 startGUI 31 startServer 31 stopServer 33 terminateSession 177 updateStationList 167 D deliverCertificate 192 Directory 139 E EERP 62 63 Enterprise Edition 1
136. drop down menu which offers the following additional options Delete User Open in New View Copy to Clipboard Duplicate User Detailed view With a double click on the user in the list you get detailed information about the user Another way to output the user details is to right click the user and thereafter select Open in New View from the drop down menu In the second case the detailed view of several jobs can be opened The view in foreground is to be selected via tab 11 3 Create New User Single click the following button in the function bar to add a user E The dialog box Create New User opens E Crete New User flde Create New User 3 This dialog is used to create a new User v Mandatory Parameters Login 9 Password Role User v Optional Parameters First Name Last Name The following parameters are mandatory Login user account 164 User Management Password for login Role Administrator Operator or User are to be selected via combo box Optional parameters are the First Name and Last Name of the user After setting up the parameters click the Create button to add the user The last window displays the data of the new user Another way to add a new user is to right click the appropriate subentry in the navigation tree and afterwards choose Create Administator Create Operator Of Create User from the context menu In this case you cannot select the role i
137. e u URI remote help verbose v Required Parameter Parameter Description f lt TSL filename Path of the file which includes the TSL Hint Only one parameter can be set f or u u lt URL gt URL for CRL download Hint Only one parameter can be set f or u Optional Parameters Parameter Description remote Availbles to start the tool during rvsEVO is run ning verbose Verbose message output help Displays a description of the current command Requests help information 19 6 25 exportUsers Export of User Data Use this tool to export the user data from the database into a file and replace a file with the same name if necessary Syntax exportUsers f lt file gt r help verbose v Required Parameter Parameter f File file lt File gt Description Path and name of the file in which the user data are to be imported 256 rvsEVO Database Optional Parameters Parameter r replace Description To replace a file with the same name if neces sary If a file with the same name is present and this parameter was not set the process is failed with an error message h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 26 importUsers Import of User D
138. e IP address or hostname of rvsEVO Server port is the port of rvsEVO Server Hint If the activating is not successful please notice the messages in command prompt window beginning with Message or Error 12 3 2 createSendJob With the createSendJob tool you can create a send job This functio nality is identical with the Create New Transmission function via GUI Syntax createSendJob d filename s receiver sid i receiver oid v vdsn t lt table name gt f originator sid gt F lt format gt M lt length gt S serialize 1 lt label gt nocp D lt disposition gt C Y rsr sfs lt set id gt sif Yalg lt encryption algorithmen gt Ycin issuer name gt Ycsn serial no gt sifcin rvsEVO User Manual Version 6 01 Rev 28 10 15 169 Q T Systems rvs Systems rvsEVO User Manual issuer name gt Ycsn serial no help verbose Sd init date St init time Sh idf lt filename2 gt xid external job id gt so origi nator sid gt rm record mode gt su user sp lt pass word sh lt host port gt Required createSendJob parameters Parameter Description d filename Name of the file to be send S receiver sid Station ID of destination i receiver oid Odette ID of destination as an option to Station ID v lt vdsn gt Virtual file na
139. e Maintenance Below you can find a description of the scripts for importing and exporting data into from the database The scripts are located in RVS_HOME tools directory Attention With Derby database the rvsEVO server must be stopped before running the skripts With Oralce and MS SQL database the scripts can also be executed with a started server But we highly recommend to stop the rvsEVO server before launching the input scripts Exeption the downloadCRLs tool must be lauched with started rvsEvo server Hint The following error messages indicate that another process has access to the database You have to stop this process before starting the script again java sql SQLException Failed to start database C rvsEVO db with class loader sun misc Launcher java sql SQLException Another instance of Derby may have already booted the database C rvsEVO db 240 rvsEVO Database 19 6 1 createDefaultQueries Use this tool for creating default queries for Monitor Log messages see chapter 7 4 Monitor Log Queries and job lists see chapter 6 5 Display of Receive and Send Jobs You only can execute this tool successfully if there are no default queries in the database anymore queries called ACTIVE SEND JOBS ACTIVE RECEIVE JOBS ENDED JOBS FAILED JOBS or MONITOR LOG QUERY Follow these steps to establish wether there are queries named as mentioned before and to rename the queries if necessary
140. e corresponding entry in the navigation tree a list of jobstarts or Observer is output At the bottom of the GUI the Live Monitor Log view is positioned 9 2 Jobstarts The Jobstart configuration comprises rules that allow special processes to be started when appropriate files are being sent or received or when a job fails Hint We recommend to save your own scripts in SRVS_HOME jobs directory which has no other use and is taken into consideration in case of backup and recovery Don t save changed scripts and your own one in SRVS HOME bin directory or subdirectories of SRVS_HOME bin because these will be overwritten during update installations Job filter If more than one jobFilter applies to the send job receive job or failed job the job is started whose jobFilter applies most exactly eg while using wildcards test doc is more exact than test d 9 2 1 Creating a Jobstart Anew Jobstart will be created via the symbol in the functionbar or with a right click on the subentry Jobstart After Receive Jobstart After Send Attempt Or Jobstart After Fail inthe Administ ration tree and then subsequently select Add New Entry Jobstart After Receive A Jobstart After Receive is triggered after file receive and before sending an EERP In the following example the program C resentr bat will be started after the local station Loc receives a file with the virtual file name TESTFILE from the neighbour stati
141. e error type is transmission these error texts are identical with the ones from ESID EFNA SFNA of the Odette log errorType Type of error possible values Internal Transmis sion MissingReceipt Undefined externalJobld JobID for external application fileDescription File description Text comment possible after the OFTP version 2 If your destination device is not OFTP 2 0 this field is ignored filename The entire path of the file which is sent from the rvs EVO outbox directory While sending the file is copied initially from the original directory to the outbox directory and then it is sent filenameSrc The entire path of the original file this file is copied in the rvsEVO outbox directory filePos Number of the read bytes of the dispatch file rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 183 rvsEVO User Manual Explanation of the job attributes Parameter holdAllowed Description This parameter gives information as to whether the stopping a job depending on the status is allowed Possible values true yes false no jobNumber rvsEVO JobID label Label for serialization All the files which have been sent in the same group should have the same ID label If this parameter in case of seria lization Y true is not set VDSN is used as a label lastByteRead lastByteSend Value of the last read
142. e illustration below shows the default view of parameter perspective in Standard Edition File View Window Help gl amp g 32 Automation Key Manage E Monitoring Parameter EF Stations in Transfer Parameter E Parameter 3 ices S A E Paran Parameter BASIC BASIC ODETTE SECURITY ma Parameter Groups CENTRAL_JOURNAL DIRECTORIES MAINTENANCE HostDenyFile host deny NOTIFICATION RMIServiceHost RDDE9D84 Parameter Name Parameter Value HostAllowFile host allow RMIServiceName rvsEVO RESOURCES CHECK RMIServicePort 3155 E Live Monitor Log 23 Live Monitor Log 20140307 1305 INF Date Time Level Module Message Session Station CTRL CLEANUP COMPLETED n RDDE9D84 3755 6 00 03 SNAPSH 06 00 45 06 SE The navigation tree on the left side of Parameter View contains the following entries BASIC general parameters CENTRAL_JOURNAL parameters for Central Journal DIRECTORIES paths of directories which includes the transfer and jobdata MAINTENANCE parameters for archiving of completed or failed jobs NOTIFICATION parameters refering to the feature rvs SNMP Agent rvsEVO User Manual Version 6 01 Rev 28 10 15 143 T Systems rvs Systems rvsEVO User Manual ODETTE OFTP Parameters RESOURCES CHECK Parameters for error handling relating to resource check and expiring cer
143. e of the server farm Nodes Please enter information about your cluster node The dialog below offers to initialize the database If installing a server farm you have to initialize the data base only during installing the first node Please see chapter 15 Multi Instance Functionality of rvsEVO for more information about cluster functionality Init rvs database Do you wish to initialize rvs database This action is necessary if you install first or only one rvs cluster node Continuance for all Subsequently please define the username and the password of the editions default user with administrator rights as well as the IP address or hostname default hostname of your machine and the RMI port default 3755 Hint Due to the special role of the default user concerning the local Client Server communication you cannot change his data in the User Management rvsEVO User Manual Version 6 01 Rev 28 10 15 25 Q T Systems rvs Systems rvsEVO User Manual Please enter the Default user and configuration of wsEVO server Default user for vsEVO server Password for default user IP address or hostname of rvsEVO Server RMI Remote Method Invocation port e Username WESTI ETY Password EI cic IP address or hostname f you have already installed rvs portable on your system you can define to import the sett
144. e risks to be considered seriously in internet all data are susceptible to the attacks of their confi dentiality and integrity Their authentication is also not ensured without further ado This may result into that the data are repudiated by its obvious sender Such risk is encountered with suitable protocols such as TLS and HTTPS For CAD data and also for EDI and any other data OFTP version 2 has been standardized as a secured internet protocol Any further risk arises through malware which is spread widely and auto matically in internet Virus worms Trojan and other harmful programs can damage the IT infrastructure of the company considerably In order to minimize this risk network areas are developed which are separated from the corporate networks through the firewalls also referred to as demilitarized Zone DMZ For example http proxies are set in DMZ which transport the user data without allowing direct connections between internet and intranet rvs OFTP Proxy offers the similar solution which can be implemented in DMZ in order to transfer the cont rolled data of OFTP protocol version 1 and 2 between intranet and internet 17 2 rvs OFTP Proxy Architecture The rvs OFTP Proxy is run with two instances bastion instance and connection instance which is integrated in rvsEVO Following figure should illustrate these facts rvsEVO User Manual Version 6 01 Rev 28 10 15 231 Q T Systems rvs Systems rvsEVO User Man
145. e value empty string rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 219 rvsEVO User Manual Optional Jobstart Parameters Parameter NEWDIR Description With this parameter you can save the received file in another directory than Inbox directory no indication file is saved in Inbox indication of new path the file is saved in the indicated directory GU name New Directory NEWNAME With this parameter you can save the received file with another name no indication VDSN is file name indication of new name the file is saved with the new name GUI name New Filename PARAMHANDLING With this parameter you can decide how to trans mit the job data to the process Possible values ARGS job data are passed as arguments default ENV job data are set as environment variables REPLACE for compatibility with rvs portable For further information see chapter Parameter Handling on page 130 REPLACE With REPLACE parameter you decide how to handle receiving files which own the same name like existing files Possible values Ror Y yes replace the existing file N no create new data set with uniquename timestamp is added default SHELL Command Shell for executions of the program inicated with JOB parameter e g ksh csh on Unix systems SIDDEST Station ID of target station GUI
146. eSendJob script to create a send job see chapter 12 3 2 createSendJob 6 2 1 Send Parameters The tables below give a description of all send parameters Required send parameters Parameter Template Name Description This parameter offers the opportunity to select a template from the drop down menu if they were previous created Adressing Mode With this parameter you can indicate whether the sendjob shoud be created via station ID or via Odette ID By default this parameter is not des played and the station IDs must be inserted With lt entry key client sendjobs allow OID addressing value yes gt definition in SRVSHOME conf rvsEvoClient prefs file you can set up the display of Adressing Mode rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 81 rvsEVO User Manual Required send parameters Parameter SID Originator Description Station ID of originator Possible values SID of local station default SID of virtual Station Hint Depending on parameter Adressing Mode input of SID Originator or OID Originator is required SID Destination Station ID of destination Hint Depending on parameter Adressing Mode input of SID Destination or OID Destination is required OID Originator Odette ID of originator possible values OID of local station default OID of virtual station Hint Depending on parameter Adres
147. ection gt lt encryption gt false lt encryption gt lt encryptionCertificateSerialNumber gt lt encryptionCertificateSerialNumber gt encryptionCertificateIssuerName encryp tionCertificatelssuerName lt fileDescription gt lt fileDescription gt lt filename gt C rvsEVO files outbox rvsenv dat 091222132218000 lt filename gt lt filenameSrc gt C rvs rvsenv dat lt filena meSrc gt lt filePos gt 789 lt filePos gt lt holdAllowed gt false lt holdAllowed gt lt lastStateChange gt 22 12 09 13 22 20 lt last StateChange gt lt lastByteRead gt 1 lt lastByteRead gt lt lastByteSend gt 1 lt lastByteSend gt lt lengthOriginFile gt 789 lt lengthOriginFile gt lt oidDest gt OXP lt oidDest gt oidNeighbor OXP oidNeighbor oidOrig OGEDASEVO oidOrig lt recordFormat gt U lt recordFormat gt lt recordLength gt 0 lt recordLength gt lt recCount gt 0 lt recCount gt lt releaseAllowed gt false lt releaseAllowed gt lt restartPos gt 0 lt restartPos gt lt scheduleDateTime gt lt scheduleDateTime gt lt sendAttemps gt 0 lt sendAttemps gt lt serialisation gt false lt serialisation gt lt SID gt XP lt SID gt sidOriginator LOC sidOriginator rvsEVO User Manual Version 6 01 Rev 28 10 15 187 Q T Syste
148. ed 4VDSN 5 Date of the job 6 Time of the job 7 Number of attempts to send 8 Format of a file 9 Record length of a file 10 Transmitted Bytes For explanation of send parameters see chapter 6 2 1 Send Parameters How these parameters should be used ina script see the example at the end of this chapter file SRVS_HOME bin jobstart jobstart_detailed bat not for Remote GUI please see parameter pro cess Server Process Server For Remote GUI instead of parameter Process 128 Automation with rvsEVO Jobfilter elements Parameter Record Handling Description With this parameter you decide whether each line of a received file in F or V format is termina ted by line feed Possible values VF TXT Files in F or V format are saved in text mode Line feed is inserted at the end of each record default VTXT FBIN Files in V format are saved in text mode files in F format are saved in binary mode Replace With parameter Replace you decide how to handle receiving files which own the same name like existing files If the checkbox is activated the existing file is replaced Otherwise a timestamp is added default Send Attempts Number of failed attempts to send Successful file transmission is indicated by 0 here Shell Command Shell for executions of the program e g ksh csh on Unix systems SID of Destination Station Id of target
149. ed view of a certificate Insert the station IDs of the neighbours to whom the certificate is to be sent via input box SID destinations If the check box Select all is activated the specified certificates are delivered to all neigh bours Right click the Deliver certificate button to execute the process Use this feature to request a cerificate from the neighbour station and to deliver an own one with default label to this station e Open the wizard for ACX Request certificate via a single click on the following icon in the tool bar r X ACX Request certificate e cros ACX Request certificate This dialog is used to request certificate SID originator LOC Select certificate 1 SID destination NEE ia ct 116 Secure Transmission with rvsEVO Select the station ID of the certificate s originator via selection box SID Originator Select the certificate to be sent via Select certificates selection box Hint Selection of the certificate is done via certificate index You find the index in the list view and detailed view of a certificate Select the station ID of the neighbour to whom the request is to be sent via selection box SID destination Right click the Request certificate button to execute the process Hint The imported certificate gets the default label by default If there is already a certificate with default label that one with the latest expiration date is u
150. eeeseleeleeee 90 6 04 Sob parameters cts 5b OM ecient arx aste ica ord SU EN cs aeo Beh died Goles d tera ke 90 6 5 5 Status for Send Jobs and Receive Jobs sillelllslleslllleeseless 93 6 6 Operations ondJODS 245 a he nu a a d Loa o dr dd M c c M 95 J MONNOHNG soni rao e ooa Aca RC ca CIC EI o tee E D P Ra RR 97 7 1 User Interface of Monitoring Perspective 0 02 eee es 97 7 2 hive Monitor Log 422 5 42 4 arte de s Sua bee m d ronde od qud ae land 98 7 8 Deletion of MonLog Entries from Database 000000 ee 99 7 4 Monitor Log Queries seed fee eS Ran Dee Bere EE 100 7A Denne Filter Griera seo ERES ba ete Br DE Dae CURE YE p E Ede 101 455 MON OT LOO s FIGS 2 0 eost osse Mme e ed oad ok educere ON ceo BA US T Ls 102 17 85 Active Panel cse siue eu nee ERES ERE eee daar haw dee 102 8 Secure Transmission with rvsEVO eeee 105 B l Line EnerypllOntu x ue das Reet Re RI Es m Ard a eka bam ae earn Ese ira 105 8 2 File Encryption ours itia co iP Pork A aes MRE AR She ortu P e Se ee arate Ale ed 105 8 2 1 Principle and Sequence of rvsEVO Encryption llle 106 6 3 Electronic SIGNALE Sea sore Fb EXE eU BE DAL ER URP RO Re e te 106 8 4 Key Management in IVSEVO 6 6 esa bars e RR de ae a ra ade ore en 106 8 4 1 User Interface of the Perspective of Key Management lille esses 106 8 4 2 Necessary Steps for Encrypted Transmission via rvSEVO 000 00ers 108 8 43
151. em requirements as well as the rvsEVO installation procedure 2 1 System Requirement To successfully operate rvsEVO you need the following software Software Operating system Windows XP Windows 7 Windows 8 1 Windows Server 2008 R2 Windows Server 2012 R2 or UNIX AIX Solaris SunOS HPUX Linux zLinux Java runtime environment Version JRE 1 7 XX or higher Hint With Windows and Linux systems the Java runtime environment Version 1 8 0 05 is installed automatically during the installation With UNIX systems you can select an installed JRE during the installation Initially you need at least 400 MB free space on your hard disk Depending on the amount of usage the retention period for old entries and the time between database cleanups the space requirement may be considerably larger Attention Please note that there are different installer for 32 bit and 64 bit operating systems for Windows and Linux systems rvsEVO will not work properly when using an installer for 64 bit systems on 32 bit operating system The other way round you can use an installer for 32 bit systems on 64 bit operating systems Auf einem 32 Bit Betriebssystem k nnen Sie nicht den Installer f r ein 64 Bit Betriebssystem verwenden Anders herum ist auf einem 64 Bit Betriebssystems der Installer f r ein 32 Bit Betriebssystem verwendbar You can download rvsEVO from the following web page https servicenet t systems com business integration
152. ement EP Stations 7 Ej W ioc zz Beh e ER Loc Stations Tree m General type filter text i LOC E General Required Parameters PN OFTP fem Virtual stations E 4 B Partner stations oli SID Loc TCP X digne Remark LS TCP 1 ME Stations Recently X 5 TCP 2 v Contact Details Name Stations Recently a Accessed Enterprise SID Odette ID a LOC MOID m D E Live Monitor Log 23 amp RH Live Monitor Log 20 Job Date Time Text 2015 07 02 09 34 12 696 L schen von ENDEND FAILED Jobs lter als 150625093412 gestartet 2015 07 02 09 34 12 771 Inhliste wird reinitialisiert m 5 2 2 Parameter Groups of Local Station There are the following parameter groups General OFTP Keys and Listeners With a single click on the small arrow to the left of listeners the receivers can be blended or blanked General The mandatory parameter is SID The parameter SID is a locally unique station ID which can consist of up to sixteen characters It is a strictly local definition remote stations do not have access to these names In Remark field you can insert a text The other parame ters are contact data They are optional OFTP ODETTE parameters For the local station it is only necessary to setup the ODETTE ID ODETTE ID is a worldwide unique identifi cation of all nodes using the ODETTE file transfer protocol OF TP This 25 character name consists of
153. ement Ei Monitoring 53 amp G E WonitorLogFile monitor log 53 amp n Monitoring Monitor Log File monitor log ads Z Live Monitor Log Size 4KB Beginning 2015 04 08 10 28 42 Ending 2015 04 08 11 31 21 E E Monitor Log Files 10 28 42 645 CTRL CLEANUP STARTED Er 2015 04 08 10 28 42 759 INF CTRL REINIT JOBLIST 2015 04 08 10 28 42 788 INF CTRL CLEANUP COMPLETED 2015 04 08 10 28 43 132 INF NET LISTENER START SUCCESS 2015 04 08 10 28 43 193 INF CTRL SERVER STARTED 11 25 36 591 INF CTRL STOP RCVCH ZZ Live Monitor Log 23 S n Live Monitor Log 7o EULI UT UU ties 2015 04 08 11 3 INF LISTENER START SUCCESS TCP 2015 04 08 11 3 INF SERVER STARTED Active RDDESAKI 3755 6 01 00 SNAPSHOT 20 15 04 08 00 21 03 EE r The symbols in the function bar provide the following functionalities Cleanup MonLog Live Monitor Log Reset Perspective Below the navigation tree of Monitor Tree View contains the following entries Live Monitor Log current Log messages Monitor Log Queries only with Enterprise Edition and Oracle or MS SQL database rvsEVO User Manual Version 6 01 Rev 28 10 15 97 Q T Systems rvs Systems rvsEVO User Manual Language Setting Configuration Monitor Log Files old Log messages Active Panel 7 2 Live Monitor Log Via a single click on the Live Monitor Log entry in the navigation tree the curre
154. enerated in PKCS 10 format rvsEVO User Manual Version 6 01 Rev 28 10 15 111 Q T Systems rvs Systems rvsEVO User Manual Import of own certi ficates Import of the partner s certificate Sendthe request to the TrustCenter CA With Odette CA you can make your application online https www odetteca com Please see https forum odette org repository odette ca help pdf for more information You receive your server certificate your public key signed by CA a CA root and an intermediate certificate if all entries of your certificate order are correct Import the Root certificate via a right click on entry CA Certifi cates in the navigation tree and then select Import CA Certifi cate from the drop down menu Import the intermediate CA certificate a via right click on Interme diate Certificates entry and single click on Import Interme diate Certificate entry from the drop down menu Import the server certificate with the Import CA Reply entry which is reachable via a right click on the private key in the list view You can also execute this function via the Import CA Reply button in the key s detailed view Send the certificates to your partner and import the certificates of your partner as described below Importthe Root certificate of your partner via a right click on entry CA Certificates in the navigation tree and selecting Import CA Certificate from the dro
155. ens a list of current transfers in a new view The following information is available Active Panel parameters Parameter Description Neighbour Station ID of the neighbour station State Initiator own station is an active side of the communication process Responder own station is the passive side of the communication process Command Create Session creation of session Start File beginning of the transfer Transmit File transfer of the file End File end of the transfer Originator SID of originator Destination SID of destination Direction Sending Receiving File Name virtual file name Line Speed transfer rate in KB sec Progress percentage closed content of the transfer Start File Time of the beginning of the transfer SessionID Is automatically signed for each transfer Start Session Time of the session start Line Type Network type Hints You can get a sorted output by clicking on the parameter column headings you want to sort Also a filter function is provided Please read chapter 7 5 Monitor Log Files section List view for description of the filter function Use the symbol for refreshing at the upper right hand border for refres hing the list Terminate Session Via the Terminate Session button a session can be terminated There is also a symbol at the upper right hand for this functionality rvsEVO User Manual Version 6 01 Rev 28 10 15 103 Q T Systems
156. entry you can upload the files to be transmitted into out box directory of rvsEVO server 40 Graphical User Interface Uploading In order to transfer a file to the server into outbox directory you can select the menu item uploading in the transfer tree The input window is selected in three sections In Local Host Section you can select the file to be sent The Remove Host Section offers the possibility of renaming the file In File Type Section the transmission format can be selected Press Execute for starting uploading On rvsEVO Server the file is saved in SRVS HOME files outbox directory So Uploading a Send file from localhost to rvs Server Local Host Section Please select the file for uploading File a Remote Host Section Allows to enter alternate file name for the uploaded file Host RDDE9D84 Directory Outbox n File File Type Section Please choose a transfer type for file transfer File Transfer in Binary Format File Transfer in Text format ASCI Hint For the upload the server connects via a port opened by the client The port can be set up by the definition ent ry key client remotefileloader port value 3756 in the RVS HOME conf rvsEvoClient prefs file Downloading In order to receive a file from inbox directory of the server you select the menu item downloading in the transfer perspective The input window
157. er G IGNCERT LEDESC lt file desc 14 2 1 IN issuer name SI GNRESP set id D lt external job id gt ription gt XI Send Create Parameters Supported by rvsEVO Required Send Create Parameters Parameter DSN Description Path and name of local data set to be sent DSNNEW Virtual file name the length of the file name used for ODETTE transfer must not exceed 26 charac ters Hints The parameter is to be enclosed in paren theses Via defintion rvs_evo controller underscore_in_vdsn_allowed true in SRVS HOME conf rvs system properties file you can configure that underscores are allo wed GUI name VDSN OIDDEST Odette ID of receiver enclosed in parantheses Only one of the parameters must be specified OIDDEST or SID SID Station ID of receiver enclosed in parantheses Only one of the parameters must be specified OIDDEST or SID Optional Send Create parameters Parameter Description CODEIN Code of local file Possible values A ASCII E EBCDIC Default code of local system rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 209 rvsEVO User Manual Optional Send Create parameters Parameter Description DISP Disposition of local file after successful send attempt Possible values K keep file will not be deleted after se
158. er Su user Description Client user for remote login Sp password Password of the client sh host port host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server Hint The following information is for encrypted transmission only Jobs which can not be decrypted or encrypted by the Service Provider were changed to the SP FATLED status Use the button Error to display the error number and the description After bug fixing you can activate the job with the tool restartJob 12 3 9 terminateSession With this tool an active session can be terminated Syntax terminateSession s session id su user sp password sh host port help verbose v Required Parameter Parameter s session id Description ID of the job to be terminated 178 Command Line Tools Optional Parameters Parameter Description verbose Verbose message output help Displays a description of the current command 2 Requests help information Optional Remote Parameters Parameter Description SU lt user gt Client user for remote login Sp password Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server 12 4 Display Job Data 12 4 1 getJoblist Listing of all Send and Receive Jobs
159. ers Thereafter the rvsEVO server should be restarted Add Proxy Bastion 3 Add Proxy Bastion Description Required Parameters Server Service Port OFTP Parameters Start Command Backup Hostname Backup Port RMI Sender IP ee i I service 3762 The parameters to be entered have already been saved during the instal lation of Bastion Instance In the following table you find the description of Proxy Bastion parame ters Required Proxy Bastion Parameters Parameter Server Description Name or IP address of the server on which the Bastion Instance has been installed When using NAT Network Address Translation procedure the public IP address Service Name of the Bastion Service Default service Port Port of the Bastion Instance for the RMI commu nication on which a listener is started rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 73 rvsEVO User Manual Optional Proxy Bastion Parameters Parameter Description Start Command Directory and Start Command of rvs OFTP Proxy Backup Hostname Name or IP address of a machine with a back up installation of Proxy Bastion Backup Port Port for RMI communication of the Backup instal lation on which a listener is started RMI Sender IP Hostname or IP address of the sender used by rvsEVO server for connection with the Proxy Bastion
160. erti ficates data are imported h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 14 importKeystores Import of a Keystore File Use this tool to import the certificates of a keystore file into the database This functionality is important if your rvsEVO is updated from version 5 xx to 6 00 or upwards Syntax importKeystores Optional Parameters help verbose v Parameter C clean Description To delete the old certificates before new data are imported h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 15 importLicense Import of rvsEVO License Key Use this tool to import a new license key at runtime The old license file is renamed in license properties plus date pattern and the new one is saved in RVS HOME conf directory and renamed in license proper ties A Monitor Log message gives you information about the success of the operation rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 249 rvsEVO User Manual LICENSE IMPORTED successful import LICENSE NOT IMPORTED import was not successful Syntax importLicense f File verbose help Required Parameter Pa
161. ficate Pre condition is that the parameter Certificate Validation Type was set up see chapter 22 2 266 PKI Connection EI S o 3 Automation C Transfer P Stations E Key Management lj Monitoring Ij Parameter 2 User Management 49 Key Management X 5 Bj Key ES4TSL UC1004e54tsl 23 Key E54TSL UC1004e54tsl Key Management Esuer CNECAI UU Tvs testing U T Systems Si Berlin C UE 4 Bs AI Serial Number hex 100004 dec 1048580 Pp Private Keys CUEUCNE i53 Partner Certificates E Intermediate Certificates Public Key Algorithm RSA ER CA Certificates Public Key Size 1024 E CRL s Signature Algorithm 1 2 840 113549 1 1 5 MD5 Fingerprint E9 93 45 19 71 06 E7 4B 27 D9 C C CE 37 80 25 F2 SHAI Fingerprint 9B C1 98 AD 3B 43 25 22 F7 8D 9B 9F 59 A5 97 40 9E E7 69 2F v Certificate Validation Validation Type Validation URI Import CRL Validate Certificate Set from Issuer Reset from Certificate Distribution Validation URI CRL Import CRL Distribute to Issued Certificates T 71 7 d Save 1 Cancel Create CA Requt Import CA Reply E Show X509 Cen hE ShowPEM B3 All Keys Pp Private Keys G Partner Certificates 3 Intermediate Certificates CA Certificates Live Monitor Log CRL View amp d B cu Partner Certificates S Type Status Valid Fro E al i T RDDE9D84 3777 6 01 00
162. finition Import of the Definition of Certificate Usage 242 19 6 5exportConfiguration Export of rvsEVO Configuration Data 005 243 19 6 6importConfiguration Import of rvsEVO Configuration Data 00 243 19 6 7exportCRLs export of a CR nics vita Sew oret are N 244 19 6 8exportJobs Export of all Send and Receive Jobs 0 00 c eee eee 245 19 6 9importJobs Import of Send and Receive Jobs 0 002 eee 246 19 6 10exportJobstarters Export of Jobstart Files 0 00 00 c ccc ees 246 19 6 11importJobstarters Import of Jobstart Files 222 0 00 0 247 19 6 12exportKeys Export of Keys and Certificates 0 0 0 00 cece eee 248 19 6 13importKeys Import of Keys and Certificates 0 0 eee eee 248 19 6 14importKeystores Import of a Keystore File 0 0 cc eee 249 19 6 15importLicense Import of rvsEVO License Key 22222222 cece eee eee 249 19 6 16exportObservers Export of the Configured Observers 000 cee eee 250 19 6 17importObservers Import Observer Data 0000 c eee eee 251 19 6 18exportOftpProxies Export of Proxy Bastion Instances 000eeeeee 251 19 6 19importOftpProxies Import of Proxy Bastion Instances 00000 eee 252 19 6 20exportQueries Export of Queries l l 253 19 6 21importQueries Import of Queries sanasana erae 254 19 6 22exportStationlist Export of the Stati
163. gment Possible values 1 999 default 999 No entry means that the default value is used Exchange Buffer Size lt BufferSize gt Maximal size of ODETTE Exchange Buffer in Bytes Possible values 1 99999 default 10 000 No entry means that the default value is used Attention With ISDN connection the value should not be over 4 000 bytes since otherwise the transmission of large files can cause pro blems VDSN charset For receive jobs only allowed character set for lt VdsnCharset gt VDSN Possible values ODETTE ODDETTE character set is allowed only default ALL all ASCII characters are allowed Restart This parameter defines whether a restart is allo lt restart gt wed after an error message Possible values true default or false SFIDDESC as Filename lt UseDescAsFilename gt SFID Start File ID is used as filename instead of VDSN for the transmisson rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 63 rvsEVO User Manual OFTP Security Parameters Partner Parameter Authentication Authentication Description Authentification on ODETTE level at the begin ning of the transmission Possible values Yes X 509 certificate has to be exchanged No PKI Please read chapter 22 2 Configuration of PKI Binding for detailed information Certificate Validation Type CertificateValidat
164. h button to create the new Jobstart After Send Attempts The last window displays the most important parameters of the jobstart Hint Please see table Jobfilter elements on page 127 for the descrip tion of the parameters Jobstart after It is possible to define a number of aborted send attempts after those a Aborted Send job is to be started Therefor set the parameter Send Attempts If several Attempts jobs are to be started after a different number of send attempts this is handled as follows Example Program 1 P1 shall be started after one send attempt and program 2 P2 shall be started after three send attempts then 1 send attempt gt P1 send attempt gt P1 send attempt gt P2 send attempt gt P1 send attempt gt P1 oa Aa co Inm send attempt gt P2 Jobstart After Fail In the following example a file with the virtual filename TESTFILE should be send from local station Loc to neighbour station RVS The program C Failure snd bat isto be started after receiving an error message after send attempt In the first dialog the mandatory parameters must be entered Enabled Comment SID of Originator SID of Destination and VDSN 124 Automation with rvsEVO After Fail Mandatory Parameters Required Parameters for creating a new Jobstart Trigger FAIL Enabled v Comment Testjs SID of Originator LOC SID of Destination RVS VDSN TESTFILE
165. he installing user needs execute rights for EMP directory defined via TEMP environment variable If he has no execute rights he needs to create a TEMP directory with execute rights H rvsEVO User Manual Version 6 01 Rev 28 10 15 19 Q T Systems rvs Systems rvsEVO User Manual before the installation procedure is started and to define this directory via SIATEMPDIR environment variable If you want to install rvsEVO Enterprise Edition and use an Oracle database from version 12 on please make the following Oracle setting before installing of rvsEVO Assign the quota unlimited to the Oracle database user for the table space used by him Failure to follow this steps will cause the installation to fail Hint rvsEVO can be installed without input of any data You only have to press the return button In this case the configuration will done with the default values Exception this procedure cannot be executed in german language on console 2 3 1 Installation on Windows Systems Start Windows and log in as a Windows user with administrator rights Hint Unlock the firewall before the installation procedure for the ports of the listeners that should be used for receiving data from your partner station if the Windows firewall is enabled e Start the installer rvsEVO setup Windows32 exe respectively rvsEVO setup Windows64 exe for 32 bit or 64 bit OS by double clicking or using the Windows command Start gt Ru
166. he local station can be reached Each number has a tab with a set of TCP IP parameters rvsEVO automatically assigns and manages this number Default 1 Enabled This parameter defines whether or not the TCP lt enabled gt IP listener is enabled or disabled Default disab led IP Address IP address or DNS name of the own station If lt IPAddress gt Proxy Bastion you own station has only one IP address you can left this field empty Only for Proxy TCP IP you can select the Bastion from a list of the Bastion instances crea ted in rvsEVO in which the receiver listener should be started Port lt Port gt Port on which a TCP IP listener is to be started 3305 by default Max Incomming Sessi ons Maximal number of simultaneously active receipt processes on the same channel lt Sessions gt Maximum 100 Time Out Time Out in miliseconds after which the commu lt TimeOut gt nication program the connection closes ifthe partner station does not answers Default 30 0 means that the default value is used The TLS and Proxy TLS parameters are necessary for the encrypted communication with a partner TLS Transport Layer Security is an encryption protocol for data transmission in an internet It provides an encryption during the communication way on the session level 48 Management of Stations TLS and Proxy TLS Parameters Local Parameter Ordinal Number lt Recei
167. he settings of the duplicated stations are used as default values of the new station SID and Odette ID parameters must be changed The remaining parameters can also be edited if neccesary 5 3 2 Setting up of a Neighbour Station Open the detailed view for setting up of a neighbour station Edit the parameters and then click Save 5 3 3 Parameter Groups of the Partner Station There are the following parameter groups General OFTP Keys und Listeners With a single click on the small arrow to the left of listeners the receivers can be blended or masked out General The mandatory parameters are SID and Network Type The parameter SID is locally unique station ID which can consist of up to 60 Management of Stations sixteen characters A Z 0 9 _ and are possible characters may not rank first SID is a strictly local definition remote stations do not have access to these difinitions they only know the ODETTE IDs The network parameter was assigned during adding a neigbour station In Remark field you can insert a text The other parameters are optional contact data Keys This group displays the certificates what are available for this station At the top of the windows all certificates are listed You get the following information Type Private Key Partner Certificate Intermediate Certificate m CA Certificate Index Label Valid From Valid To Status Via the i
168. i onType gt Please read chapter 22 2 Configuration of PKI Binding File Encryption lt SecuritySet gt Defines whether or not encryption is to be used during file transmission Values File Encryption NO Encryption is impossible The job aborts with an error message if a send job requires encryption File Encryption OPTIONAL Encryption possible as an option and can be spe cified in the send job File Encryption FORCED Encryption is compulsory If a send job is schedu led without encryption a warning is issued If a partner station sends an unencrypted file recep tion of this file is refused Default SECURITY OPTIONAL Hint By default this parameter refers to trans mission via OFTP2 only If this setting should be valid also for ComSecure the rvs evo controller check security by sfid false dedinition of the RVS HOME conf rvs system pro perties file has to be set Hash Algorithm The following values can be selected SHA 1 default SHA 256 SHA 512 64 Management of Stations OTFTP File Service Proxy Parameters Partner Parameter File Service Proxy lt Proxy gt Description Only for File Service Modul possible values NONE default INTERNAL EXTERNAL Please see chapter 18 File Service Module for detailed explanation Security Feature Set lt SecurityFeatureSet gt Send parameter on station level Only a
169. ider has processed job successfully SP FAII ENDED ED Service provider failed during processing of job Job has successfully ended ENDED WITH JS ERROR Job run into error during call of jobstart ERROR Job run into fatal error ED Job got deleted Status for Send Jobs CREAT WF SF SFID ED Job was created but not sent ID ANSWER Sendjob waits for answer to already sended WF CDT Sendjob waits for credit renewal WF EF ID ANSWER Sendjob waits for answer to already sended EFID WE WE SYNCH EERP Sendjob waits for EERP EERP ROUTING Wait for EERP during Routing RONIZE ERROR Sendjob run into synchronize error HELD Sendjob got holded SED Sendjob got released ED WITH NERP NERP received RELEA FAIL FAIL FAILE ED WITH SFNA Receiving of SFNA with setting Restart No D WITH INVALID PROTOCOL VERSION Transmissions failed based on invalid protocol version SCHED ULED Send job created execution deadline not reached Status for Receive Jobs RESTAI for retransmission RT_AFTER_EFNA Transmission with error EFNA send waiting RESTAI failed assuming partner will send file again RT_AFTER_EFPA_FAILURE File already
170. iew Activate Station only partner station Activate Station without Transfer only partner station Duplicate Station Delete Entry Add Routed Station only partner station Certificate Request to one Station Certificate Deliver to one Station Below the Stations view the Stations Recently Accessed view is positioned It contains a list of 10 stations with the latest access At the bottom of the GUI the Live Monitor Log View is displayed Detailed view ofa You get detailed information of a station via a single click on this station or station via a right mouse click and then selecting Duplicate View The second case several Detailed Views are opened at one The View in the front can be selected via registrations cards In the detailed view the stations parameters can be edited 5 2 Local Station Normally the local station parameters are already set during the installa tion In this chapter you find the explanation of all parameters concerning the local station It is described how to edit the parameters and how to add receivers 5 2 1 Setting up of a Local Station Open the detailed view of the local station to set up the parameters rvsEVO User Manual Version 6 01 Rev 28 10 15 45 T Systems rvs Systems rvsEVO User Manual File View Window Help 2 bw xime Gy Transfer Monitoring P Stations Key Management 4f Automation 0 Parameter User Manag
171. ile does not exist Jobstart fails after successful send attempt END ED Wl ITH JS ERROR EFNA error End File Negative Answer after transmission 126 Automation with rvsEVO receipt of NERP Negative End to End Response Receive transmission dispatch of SFNA dispatch of EFNA e g the byte count of the received file is not conform to the byte count of the transmitted file subsequent treatment fails e g missing private key for decryption SP_FAILED JobStart after receive fails ENDED_WITH_JS_ERROR 9 2 2 Jobstart Parameters Jobfilter elements Parameter Comment Conversion table Description free Text For ASCII ANSI EBCDIC conversion the follo wing conversion tables are available ASCII IBMO37 ASCII IBM273 ANSI IBMO37 ANSI IBM273 For EBCDIC ASCII ANSI conversion the follo wing conversion tables are available IBMO37 ASCII IBM273 ASCII IBMO37 ANSI IBM273 ANSI For using your own conversion table please read the note for conversion tables on page Conversion tables on page 133 Direction Defines filter rules for the communication direc tion Possible values SND when sending files RCV when receiving files FAIL after processing error Enabled With this parameter you decide whether the job is to be started or not New Directory With this parameter you can sa
172. ile name regular expression as filter Parameter Handling Hint Subsequently you can find a detailed description of the alignment Parameter Handling ENv and Parameter Handling REPLACE Parameter Hand Parameter Handling ENV job data are set as environment variables ling ENV The following environment variables are specified in angle brackets name in XML file in brackets GUI name RVS COMPRESSION compression Compression RVS CONVERSION TABLE conversionTable Code Table RVS CREATED AT creationDate SFID Date Time RVS DATE Date of lt creationDate gt RVS DESCRIPTION lt fileDescription gt File Description RVS DIRECTION direction Direction RVS DISPOSITION disposition Disposition RVS ENCRYPTION encryption Encryption RVS ENCRYPTION ALGORITHM lt encryptionAlgorithm gt Encryption Algorithm RVS ERROR ID lt errorlD gt Error Number RVS ERROR TEXT lt errorText gt Description RVS EXTERNAL JOB ID lt externalJobld gt External Job ID RVS FILE NAME filename Filename RVS FILE NAME SRC lt filenameSrc gt Source File Name RVS JOB ID lt jobNumber gt ID RVS LABEL label Label RVS LAST CHANGE lt lastStateChange gt Last Change 130 Automation with rvsEVO Parameter Hand ling REPLACE RVS_NERP_CREATOR_ODETTE_ID lt nerpCreatorOdettelD gt Nerp Creator OdettelD R
173. ings from rvs portable In case of migration from rvs portable click the Yes button Please read chapter 2 5 Migration from rvs portable to rvsEVO for further information about migration from rvs portable f you install just the GUI you can also ignore the dialog below It deals with the settings of the local station Please read the chapter 5 3 3 Parameter Groups of the Partner Station for more information about setting the station parameters e g how to obtain the ODETTE ID The neighbour station will be configured after installation 26 Installation procedure via GUI See chapter 5 3 1 Add a Neighbour Station eo Please enter information about your local station Station name Pr2 l Installin IP address or hostname Port Odette ID Inthe next dialog you are given a brief overview of selections you have made installation directory link directory The required and the currently available disk space is also displayed Press the Next button to start installation and to copy the installation files into the directories you specified The last dialogs informs you about the successfully installation of rvsEVO 2 3 2 Installation on Linux and UNIX Systems Installation on UNIX systems runs nearly analog to an installation on Windows systems The installation file for Generic UNIX is named rvsEVO setup GenericUnix bin For Linux systems please use rvsEVO setup Linux3
174. ion failed to be established before rvsEVO tries to establish the connection again Default 10 000 ConnSetupProxyFail Number of failed connection attempts with rvs Count OFTP Proxy after which the script defined in ConnSetupProxyFailScript parameter should be started ConnSetupProxyFail Job to be started after the number of failed con Script nections which is defined in ConnSetupProxy FailCount parameter is reached LooptestNeighbourSID ID of the station via which the loop test transmis sion of a file to the own local or virtual station is performed The file is to be transmitted to the own station and rvsEVO sends this file via a neigh bour station back to the own station If no StationID is specified the file is delivered directly to inbox of local station and not routed via a neighbour station rvsEVO User Manual Version 6 01 Rev 28 10 15 151 T Systems rvs Systems rvsEVO User Manual OFTP Parameters Parameter MaxSessions Description Maximum number of simultaneously running receiving processes for TCP IP communication Default 20 Maximum number is restricted by system resources and the licensekey MaxSessionsISDN Maximum number of simultaneously running receiving processes for ISDN communication Default 1 no limit Maximum number is restricted by system resources and the licensekey OFTPTimeout Time out in milliseconds at ODETTE level defaul
175. is parame ter Default 7 days Note You can set only one of cleanup parame ters cleanupdays or cleanuptime rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 147 rvsEVO User Manual Parameters for Operation and Maintenance Parameter Cleanupinterval Description Time interval in minutes between two cleanup cycles This parameter has no relation to the other two cleanup parameters CleanupDays or CleanupTime Default 1440 CleanupTime Specify time in the format HH mm ss 24 hour for mat for cleanup of completed and failed jobs Any jobs older than the time specified will be deleted Note You can set only one of cleanup parame ters cleanupdays or cleanuptime MailLocalAddress Mail address of the sender of warnings See also Mail parameter in chapter 10 8 MailSMTPHost Hostname or IP address of the mail server if warnings are sent See also Mail parameter in chapter 10 8 MaxRevisionLogCount Number of RevisionLog files that can be genera ted Default 1000 MaxRevisionLogSize Maximum file size of the RevisionLog file in lines 1 line has maximal 10 kbytes Default 1 000 000 MonloginDatabase In this parameter you define whether the log mes sages should be written into the database Important hint The database table is not clea ned up by rvsEVO l e the user has to clean up the table because otherwise it would fill up Pos
176. isplay of Receive and Send Jobs Listings and detailed information of jobs can be output via Transmis sion Queries entry in the navigation tree Job lists The following default queries are provided by rvsEVO ACTIVE SEND JOBS listing of active send jobs ACTIVE RECEIVE JOBS listing of active receive jobs ENDED JOBS listing of ended jobs FAILED JOBS listing of failed jobs They can be opened with a right click on the query and then selecting Open Definition Right click the query and select Open Defini tion in New View to open the query in a new view The view in fore ground is to be selected via tab A query can be executed with a simple click on the query or via the Execute button in the opened view Alternatively you can right click the query and afterwards select Open Query Result in New View In chapter 6 5 1 Create Transmission Queries you come to know how to generate your own transmission queries Create Defatult If the queries are changed or removed you have the possibility to Queries generate new ones This functionality is executable via the tool SRVS HOME tools createDefaultQueries Detailed view With a double click on the job in the list you get the detailed view of the transmission job Another way to output the job details is to right click the job and thereafter select Open in New View In the second case the detailed view of several jobs
177. ition to the root and server cer tificate the user certificate has to be imported See chapter 8 4 5 Use of CA Certificates for more information TlsCertificateValidati onType Only effective if parameter TIsCertificateValida tionBehavior NORMAL With this parameter the validation type can be indicated Possible values CERT_PATH OCSP CRL See chapter 22 3 Validation Methods for fur ther information rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 159 rvsEVO User Manual Security Parameters Parameter Description TisPerfectForwardSe Algorithms used Possible values crecy FORCED Cipher Suites List contains DHE algo rithms CLIENT_PREFERED Cipher Suites List con tains all algorithms but DHE algorithmus is prefe rably used JVM_DEFAULT Cipher Suites Liste remains unchanged After changing a restart is necessary TIsPerfectForwardSecre Regular expression Default cyFilter DHE 1 ECDHE After changing a restart is necessary TisVersions Possible values of TLS protocol TbSv1 TLSv1 1 TLSv1 2 You can specify more than one version seperated by comma and spaces Default TLSv1 2 TLSv1 1 TLSv1 After changing a restart is necessary URL for format description of CRLAutoUpdatelnterval parameter http quartz scheduler org doc
178. l Parameters Parameter i lt keyIndex gt Description Index of the certificate to be sent If not indicated all certificates of the originator are sent You find the index in the list view and detailed view of a certificate o lt stationID gt ID of the station whose certificate is to be sent If not indicated the ID of local station is used verbose Verbose message output Requests help information 194 Command Line Tools Optional Remote Parameters Parameter su lt user gt Description Client user for remote login sp lt password gt Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server 12 10 3 replaceCertificate With this tool a certificate for file encryption can be sent to a partner station and replace an already existing certificate in this station Virtual file name for ODETTE transfer is ODETTE CERTIFICATE REPLACE Syntax replaceCertificate s lt stationID gt i lt keyIndex gt r stationID su user sp password sh lt host port gt help verbose v Required Parameters Parameter Description r lt stationID gt StationID of the partner station to which the Separate certificate certificates are sent The old certificate s belonging to the indi
179. lation on UNIX and Linux systems can be done in different modes console default awt orsilent For graphical modes awt the UNIX environment variable DISPLAY for the X Server should be set Example export DISPLAY IP address of X Server gt 0 0 Note Make sure to call the installation file as a shell script when you perform installation Default mode is the console mode Example sh rvsEVO 601 00 SE setup sh The installation prompts are identical in both modes see section 2 3 1 Installation on Windows Systems Hint There are minor differences for particular UNIX platforms mentioned in the release notes for the respective version SRVS HOMENdokuNreadme txt document 2 4 rvsEVO update installation Requirements The system variable RVS HOME is to be set for the logged on user the value of RVS HOME is the installation directory of rvsEVO Set RVS HOME by choosing Start Control Panel System Advanced Environment Variables e Start the rvsEVO setup X XX XX exe installer by double clicking or using the Windows command Start Run Attention Use a Windows32 installer if you communicate via ISDN On the other hand an error message is displayed 28 Installation Click the Update button if the installer asks you whether you would like to install a new version or to update your current rvsEVO f rvsEVO found 2 Previous rvsEVO installation found
180. le is automatically activated depending on the encryption component used by the sending partner station EXTERNAL this partner station is marked as an external station located in the internet for this option all encryption and compression fea tures are available The next parameters are only available if FileProxy Service EXTERN The table Security parameters on page 84 shows a description of the parameters Security Feature Set Offline Compression Encryption File Signature Requested signed EERP NERP Encryption Algorithm Hint Both direct neighbour stations and routing stations can be marked by File Service Module Therewith the configured File Service Module function is station wide fixed and can not be overwritten while creating a transmission This corresponds with a forced encryption during activated encryption Security FORCED 236 rvsEVO Database 19 rvsEVO Database From rvsEVO version 6 00 upwards the following data are written into the database Jobdata Data of user management Data of rvsEVO configuration Data of key management Data of jobstarts Data of Observer The following databases are available Derby for Standard und Tiny Edition Microsoft SQL and Oracle for Enterprise Edition While installa tion of rvsEVO you have to define what database is to be installed See chapter 2 3 New Installation of rvs
181. les Please contact the rvs Service Support Center to receive a license key REDNER phone from Germany 0800 664 77 45 phone from other countries 49 375 606 19 902 email rvs service t systems com To receive a license key Please send the hostname and the Odette ID to the rvs Service Support Center You get the hostname as typing hostname in the command prompt window Run cmd You can request the Odette ID with the VAD http www vda de de verband fachab teilungen logistik infos odette id index html You will be sent your licensekey file by email Save the license key file in the SRVS_HOME conf directory as license properties Note For more information about the ODETTE ID see chapter 5 2 2 Parameter Groups of Local Station Renew a License Use the tool importLicense to import a new license key at runtime This could be required if your license key expires or if you need a license for added rvsEVO components Please see chapter 19 6 15 importLicense Import of rvsEVO License Key for more informa tion Test License For receiving a test license please contact the rvs Service Support Center too In this case you must not inform the rvs Service Support Center about your hostname and the Odette ID 2 3 New Installation of rvsEVO This chapter describes the installation of rvsEVO Please read the chapter 2 1 System Requirement before installing Attention For successful installation t
182. lient sh host port host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server Examples createSendJob d C text txt s RVS v test rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 173 rvsEVO User Manual In this example the C text txt file is sent to the station RVS with a virtual name test 33 The virtual file name parameter option v is mandatory createSendJob d C text txt s RVS v OFTP TEST F F M 80 In this example the C text txt file is sent to the station RVS with a virtual name OFTP TEST this file is a text file of which each line has a length of 80 characters without CR LF F F M 80 createSendJob d C part txt s RVS v PART AUTO S Y E In this example the C part txt file is sent to station RVs with a virtual name PART this file belongs to the serialized group of files with the label for the whole group AUTO 12 3 3 handleEERP Deleting or releasing EERPs Use the program hand1eEERP to delete or release EERPS NERPs Syntax handleEERP r d lt JobID gt verbose v su user sp password sh lt host port gt Required Parameters Parameter Description d JobID ID of the job for which an EERP is to be deleted n lt JobID gt ID of the job for which an NERP is to be deleted r lt JobID gt ID of the job for which the EERP is to
183. log the security parameters can be set up Click Finish to start the job or Next to set up the general parameters Hint If you use File Service Module the security parameters have to set up via Stations perspective In table Security parameters on page 84 you can find the description of the parameters rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 79 rvsEVO User Manual Security Parameters This page provides the optional Security related parameters Security Feature Set 1 None Offline Compression Encryption Encryption Algorithm None File Signature Request signed EERP NERP Save As Template Reset From Template Reset From Default Jm s In the following window further optional parameters can be set up After you finished the input press Finish button to start the send job Hint In table Other Optional Parameters on page 85 you can find the description of the parameters Before starting your send job you have the possibility to save the job as template via mouse click on Save as Template button 80 File Transmission with rvsEVO Label Disposition K keep No Copy Save As Template Reset r AR Create New Transmission m ESSET General Parameters P This page provides other optional parameters Hold Schedule fe Serialization From Template Reset From Default Hint You can also use the creat
184. m the drop down list of the input box Login History Details 4 3 2 Features of Remote GUI The rvsEVO GUI on the client computer differs marginally from the rvsEVO GUI on the server computer The following differences exist n addition the transfer perspective provides the functionality of creating the sendjob remotely or locally Thereby the parameters for the file dispatch remain the same P rvsEVO LOC File View Window Help AS amp el r B 3 Automation wy Key Manage El Monitoring C Parameter f Stations gu Transfer Th Create New Transmission Local Th Create New Transmission Remote Uploading amp Downloading I Transmission Queries ACTIVE SEND JOBS ACTIVE RECEIVE JOBS ENDED JOBS FAILED JOBS E Manage Templates local54 Z Live Monitor Log 2 Live Monitor Log oO Date Time Level Instance Module Message Session Station Job 20140613 10401 INF rvs VO CTRL EERP ASSIGNED 1406131040130 7 20140613 10401 INF rvsEVO CTRL TERMINATE SENDJOB EIGENEN m J D Active RDDE9D84 3755 6 00 04 SNAPSHOT 2014 06 11 01 56 49 SE gui Further there is an option of uploading transferring files to the server or downloading fetching transferring files from the server of files 4 3 3 Create New Transmission Remote If you create a new transmission remote you can only select files from outbox directory Via Uploading
185. me Conversion Table rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 211 rvsEVO User Manual Optional Send Create Parameters enclosed in parentheses Parameter Description COMPRESSION Compression during transmission active only in connection with sfs 2 3 oder 4 Possible values Y Yes the file is to be compressed before sen ding N No default This parameter has to be placed after SID para meter Example SEND C DSN MhomeNtestNtestll txt SID RTZ COMPRESSION Y GUI name Offline Compression CRYPTCERTSN Serial number of the certificate for file encryption active only in connction with sfs 4 and ENCRYP TION Y GUI name Encryption Cert Serial Number CRYPTCERTIN Issuer name of the certificate for file encryption active only in connction with sfs 4 and ENCRYP TION v GUI name Encryption Cert Issuer Name ENCRYPTION File encryption active only in connection with sfs 2 3 or 4 Possible values Y Yes the file is to be encrypted before sen ding N No None encryption This parameter has to be placed after SID para meter Example SEND C DSN MhomeNtestNtestll txt SID RTZ COMPRESSION Y ENCRYPTION Y FILEDESC File description active only with sfs 4 OFTP 2 0 GUI name File description NOCOPY With this parameter you can decide whe
186. me Serialization SIDORIG Station ID of originator local station default or virtual station GUI name SID Originator 210 rvsbat Batch Interface Optional Send Create parameters Parameter Description VFTYP In this parameter you indicate the mode of files in format F or V see also FORMAT parameter Possible values X text file record mode TXT in the GUI U binary file record mode BIN in the GUI Please see parameter Record Mode in chapter 6 2 1 Send Parameters for further information GUI name Record Mode Optional Send Create Parameters enclosed in parentheses Parameter Description ALG CODEOUT Active only in connection with OFTP 2 0 sfs 4 OFTP 2 0 CMS The following algorithms are possible 3DES AES GUI name Encryption Algorithm Desired code of data set at receiver possible values A ASCII E EBCDIC Example send c dsn C test22 dat CODEIN A FORMAT V SID RTT CODEOUT E DSNNEW FIXOGBE TEXT CODETABLE Defines the code table which is to be used for the code conversion see Parameter Conversion table in the table in Required send parameters on page 81 Indicate the alias name of conver sion table Example send c dsn c programs rvsEVO files outbox test22 dat FORMAT V SID RTT CODETABLE ASCII IBM037 MAXRECL 80 DSNNEW FIXOGBE TEXT GUI na
187. me the length of the file name used for ODETTE transfer must not exceed 26 charac ters Hint Via defintion rvs_evo control ler underscore in vdsn allowed true in RVS_HOME conf rvs system properties file you can configure that underscores are allowed in VDSN Optional Send Parameters Parameter Description Requests help information C ODETTE compression offline compression D lt disposition gt Disposition of local file after successful send attempt Possible values K Keep file will not be deleted after sending D Delete file will be deleted after sending desc lt description gt Comment free text available only in connection with OFTP version 2 If your partner does not support OFTP version 2 this field will be ignored f originator sid gt Odette ID of originator local default or virtual station 170 Command Line Tools Optional Send Parameters Parameter Description F lt format gt Format of the file to be sent T text file a stream of ASCII characters U unstructured binary byte stream V variable variable record length F fixed fixed record length Hint set also the M parameter for files in v or F format Please see also the parameter rm h Displays a description of the current command idf filename The ID of the job is written in this file after suc cessful transmission return c
188. ments Observer user data 21 2 Recovering the rvsEVO Data Use the RVS HOME tools restore bat script to recover the rvsEVO data Syntax restore b file t file u s i verbose help All parameters are optional Restore Parameters Parameter Description backup lt file gt Name of the backup file b temp Directory for temporary data t userfiles Parameter for importing the user data see also u the same parameter of backup script skipjobs Parameter for disabling the import of job data S initdb Parameter for initializing the database before i restore 2 Requests help information help Displays a description of the current command h verbose Verbose message output 264 PKI Connection 22 PKI Connection In this chapter the configuration and the functionality of the rvsEVO PKI binding will be described You also get information about certificate vali dation via GUI 22 1 Introduction In a PKI Public Key Infrastructure public keys with their certificates are stored Following features are available for rvsEVO PKI binding obtaining of public keys and certificates from a PKI for a partner station certificate validation with OCSP Online Certificate Status Protocol CRL Certificate Revocation List or CertPath Transfer of information from a OCSP server by HTTP Hint From rvsEVO version 6 00
189. meter r replace h help Description To replace a file with the same name if neces sary If a file with the same name is present and this parameter was not set the process is failed with an error message Displays a description of the current command Displays a description of the current command rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 245 rvsEVO User Manual Optional Parameters Parameter Description V Verbose message output verbose 19 6 9 importJobs Import of Send and Receive Jobs Use this tool to import the transmission jobs into the database and delete the present transmission data Syntax importJobs f File c help verbose v Required Parameter Parameter Description f lt File gt Path and name of the file from which the data are file lt File gt to be imported into the database Optional Parameters Parameter Description C To delete the old data before new transmission clean data are imported h Displays a description of the current command help Displays a description of the current command V Verbose message output verbose 19 6 10 exportJobstarters Export of Jobstart Files Use this tool to export the configured jobstarts from the database into a file and replace a file with the same name if necessary Syntax exportJobst
190. ml version 1 0 encoding 1S0 8859 1 gt RVS STATION CONFIG StationLoc StationLoc lt StationNeighbour gt lt StationNeighbour gt lt StationRouted gt lt StationRouted gt lt StationVirtual gt lt StationVirtual gt lt RVS_STATION_CONFIG gt Lines starting with lt and ending with gt are interpreted as comments Edit the rvsStationlist xml file if you have to change mandatory parameters ODETTE ID TCPIP_Basic or if you wish to assign values to other optional parameters such as Contact Use a text editor e g Edit TextPad to do so Please make sure to save your XML files as valid XML documents after editing as otherwise rvsEVO will not be able to read them and may fail to start correctly The changes in the GUI will be visible immediately after saving in the XML station configuration file the changes in the XML station configura tion file will be visible in the GUI only after a new start of the rvsEVO command startGUI Please see chapter 12 2 updateStationList for getting information about setting up the stations at run time Note For correct TCP IP communication you must ensure that the IP ports for RMI 1099 and for Odette e g 3305 are free For the description of the parameters in the rvsstationlist xml file please refer to the description of the GUI parameters The parameter label is not configurable via the GUI
191. mmand V verbose Verbose message output rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 253 rvsEVO User Manual 19 6 21 importQueries Import of Queries Use this tool for importing the previously exported queries into the database and deleting the present queries Syntax importQueries f v Required Parameter File c help verbose Parameter f File file lt File gt Description Path and name of the file from which the data are to be imported into the database Optional Parameters Parameter Description C to delete the old queries before new data are clean imported h Displays a description of the current command help Displays a description of the current command V Verbose message output verbose 19 6 22 exportStationlist Export of the Stationlist Use this tool to export the stationlist from the database into a file and replace a file with the same name if necessary Syntax exportStationlist f File remote r replace help verbose v Required Parameter Parameter f File Description Path and name of the file in which the stationlist is to be imported 254 rvsEVO Database Optional Parameters Parameter remote Description This parameter availbles to start the tool duri
192. mmss Level Kind of message Possible values INF Information WRN Warning importent hint ERR ERROR rvsEVO User Manual Version 6 01 Rev 28 10 15 203 T Systems rvs Systems rvsEVO User Manual Output Parameters of Log Messages Parameter Description Module Module of rvsEVO which transmitted the message Possible values SRV rvsEVO Server CTRL controller NET network OF TP Odette protocol CONF configuration P A S ERS persistence CX automatic exchange of certificates P Service Provider OBSR Observer Message Message key Session ID of OFTP session Station SID of neighbour station Job rvsEVO jobID Text Text message from message key GUI or parameter for text message log file 13 2 rvs logFile The error messages of rvsEVO Server are saved in RVS_HOME 1log rvs log file These messages are not displayed via GUI The maximum file size and maximum number of rvs 10og files can be defined in the element appender name rvslog in the SRVS HOME conf rvsLogger xml file Maximum size use the function maxFileSize Syntax lt param name MaxFileSize value 2097152 gt Maximum number of log files use the function maxBackup Index Syntax lt param name maxBackupIndex value 10 gt 13 3 rvsClient log File The warnings and error messages of the command prompt are saved in
193. ms rvs Systems rvsEVO User Manual lt sidDestination gt XP lt sidDestination gt lt signCertificateSerialNumber gt lt signCerti ficateSerialNumber gt lt signCertificatelssuerName gt lt signCertifi catelssuerName gt lt status gt ENDED lt status gt lt timeStartFile gt 1261484539412 lt timeStart File gt lt transmittedBytes gt 789 lt transmittedBytes gt transferFileLength 789 transfer FileLength gt lt user gt lt user gt lt VDSN gt WEIH6644 lt VDSN gt lt virtualSID gt lt virtualSID gt lt waitTime gt 0 lt waitTime gt lt jobSecurityAndSign gt lt securityFeatureSet gt 1 lt securityFea tureSet lt encryptionAlgorithm gt lt encryptionAlgo rithm gt lt sign gt false lt sign gt lt signEERP gt false lt signEERP gt lt jobSecurityAndSign gt lt JobDetails gt lt JobExtendedDetails gt lt JobInfoList gt 12 5 rvscli This tool provides the possibility to execute the GUI functions via commandline Start rvscli via command line After a successful start you can write the command and the parameters into the command line Syntax rvscli trace help su user sp password sh lt host port gt 188 Command Line Tools Optional Parameters Parameter trace Beschreibung This parameter activa
194. n With the first window you get information on installation of rvsEVO Thereafter you can choose the language of the installation wizard e Ifthere is already an rvsEVO installation on your machine you have to decide whether you would like to install a new version or to update your current rvsEVO If you decide to upgrade your existing rvsEVO please continue how descript in chapter 2 4 rvsEVO update installa tion else click on Install button for going on rvsEVO found N I b Previous rvsEVO installation found Previous rvsEVO installation found in C wsEVO63 Update current risEVO or install a new version Cancel 20 Installation Next you have to choose the install set Information about Client Installation only GUI you can find in chapter 4 3 Remote GUI Server and GUI Installs Server RCP GUI SWING GUI and CMD Tools Server only Installs Server and CMD Tools GUI only Installs RCP GUI SWING GUI and CMD Tools In the following window you can decide which rvsEVO edtion is to be installed Please select rvsEVO edition Install Cornglata Inthe dialog below you can indicate the rvsEVO destination directory This directory may not exist rvsEVO User Manual Version 6 01 Rev 28 10 15 21 T Systems rvs Systems rvsEVO User Manual Where Would You Like to Install C rvsEvo Restore Default Folder
195. n You can configure a time interval for sending heartbeats to prevent the interrupt of connection if there is no transmission This functionality is to be set up in parameter 1istener controller thread sleep time and listener controller thread keep alive counter in SRVSPROXY_HOME conf RemoteListenerProperties proper ties file of rvs OFTP Proxy program Use the listener controller thread sleep time parameter to set up the sleep time in milliseconds of the controller thread before it checks next time for status of listener Use the listener controller thread keep alive counter parameter to define the number of checkups before the next heartbeat is sent rvsEVO User Manual Version 6 01 Rev 28 10 15 233 T Systems rvs Systems rvsEVO User Manual 234 File Service Module 18 File Service Module 18 1 Basics The internet is increasingly used for exchanging commercial and business critical data which are especially security relevant OFTP version 2 is standardized as a secure internet protocol for CAD data EDI and any other data File Service Module works as an OFTP router which de and encrypts files accordingly OFTP2 for stations which do not support OFTP2 itself 18 2 Architecture of File Service Module The File Service Module works as a OFTP router and de and encrypt files for internal stations substitutional before he forwards them The illustration below shows the File Service M
196. n includes an automatic adjustment of the processing capacity and uses a professional external database Features of rvsEVO Enterprise Edition subject to modifications 9 999 partner stations direct or routing partner 999 parallel connections sessions routing functionality 1 virtual station all communication components encryption and compression Oracle database connection Microsoft SQL database connection Central Journal SNMP Agent code conversion PC Mainframe PKI connection File Service Proxy remote GUI 10 users Multi instance operation Additionally the following components can be linked rvs OFTP Proxy for OFTP2 further virtual stations rvsEVO User Manual Version 6 01 Rev 28 10 15 13 T Systems rvs Systems rvsEVO User Manual Hint Please see the rvsEVO Product Datasheet for binding information of the technical data You can download the datasheet from the following adress https servicenet t systems com business inte gration rvs produktdatenblatt 927428 The available features are limited by the license key For more Information on rvsEVO Editions please contact your sales partner Phone 49 375 606 19 902 E Mail rvs service t systems com 1 6 Representation means This chapter describes the typographic conventions used in this manual and explains the meaning of specially highlighted expressions Typog
197. n the Create New User dialog box You can add an user with identical settings to an existing user Right click the user that is to be duplicated in the list view and select Duplicate User entry from the combo box The settings of the duplicated user are used as default values of the new user The value of Login parameter must be changed The remaining parameters can also be edited if neccesary Hint A basic User may use the rvsEVO program to send and receive files An Operator may execute operator commands An Administrator has the rights of the user and the operater and in addition to this he may execute the management of private keys and users and configure the rvsEVO system In addition to this an Administrator may execute the management of private keys and users and configure the rvsEVO system 11 4 Edit User Data Open the detailed view to edit the user data rvsEVO User Manual Version 6 01 Rev 28 10 15 165 T Systems rvs Systems rvsEVO User Management File View Window Help amp mlsg Ll Automation Key Manage a Era Parameter E User Management X Al erl User 3 All Users Users User Management User user1 User amp All Users amp Administrator v Mandatory Parameters Login user Password eeeee Role User v Optional Parameters First Name Max Last Name d Tester CE See Denen B sen EB Live Monitor Log amp Administrator
198. n this group the already configured listeners receivers are displayed Add Listener You can add several listeners of one network or listeners of several networks for your local station Add a listener via a right mouse click on the entry Listeners in detailed view of your local station and then select the network An other way to add a listener is to right click the local station in the navigation tree and thereafter select Add Listener from the context menu Hints To add a Proxy TCP IP or Proxy TLS listener you need to set up a Proxy Bastion before see chapter Proxy Bastion For Windows systems Unlock the firewall for the ports of the listeners that should be added if the Windows firewall is enabled Delete Listener Right click the listener to be deleted and then select Remove Receiver to delete a listener rvsEVO User Manual Version 6 01 Rev 28 10 15 47 T Systems rvs Systems rvsEVO User Manual TCP IP and Proxy TLS and Proxy TLS You can also delete a listener by a right mouse click on the local station in the navigation tree thereafter selection of the option Remov Receiver and then selection of the listener In the next table you will find the description of the TCP IP and Proxy TCP IP TCP IP parameters TCP IP and Proxy TCP IP Parameters Local Parameter Ordinal Number lt ReceiverNumber gt Description Number for differentiating the various receiving channels through which t
199. ndicate the mode of files in format F or V Possible values TXT text file BIN binary file Code Table Name and path to conversion table Disposition This parameter decides whether the file to be sent remains as it is or is deleted locally after sending Possible values K Keep File remains as it is after sending D Delete File is deleted after sending Serialization If this parameter is activated your files are send in a serial order All the files which should be sent in the same group should have the same ID Label Label Label for serialization All the files which have been sent in the same group should have the same ID label See also parameter Serializa tion Security Features Parameter Description Security Feature Set Security Features possible values 1 none 2 ComSecure V1 3 ComSecure V2 4 OFTP 2 0 Compression Odette compressing if the checkbox is activated Encryption Encoding if the checkbox is activated 92 File Transmission with rvsEVO Security Features Parameter Description Encryption Algorithm Encoding algorithm possible values blank no algorithm DES EDE3 CBC Triple DES AES256_CBC File Signature If the checkbox is activated the file is signed Request Signed EERP NERP If the checkbox is activated signed EERP NERP
200. nding default p delete GUI name Disposition FORMAT Format of the file to be sent Possible values T text file a stream of ASCII characters U unstructured binary byte stream F fixed fixed record length V variable variable record length Default U INITTIME With this parameter you can decide what time the send job is to be created Possible values date and time in format YYYY MM DD HH mm ss H or HOLD job is created with HOLD status Nor NOW job is started immediately default 2 GUI parameters Hold Schedule LABEL User label up to 20 characters used to serialize on a proceeding send job if SERIAL Y or which can be used for serialization by a subsequent send request MAXRECL Max record length for the files in format F or v see also FORMAT parameter NOCOPPY With this paramter you can decide whether the file which should be transmitted is to copy to Outbox directory or not Possible values Y no copy N copy is saved in Outbox dorectory default Note not with format U and code conversion OIDORIG Odette ID of originator OID of local station or OID of virtual Station SERIAL If you set SERIAL Y the files will be sent in the same sequence as the send jobs were created The next job will only be sent if the previous is completely finished All send jobs for the serializa tion must have the same LABEL Possible values Y Yes N No GUI na
201. ne Tools Optional Parameters Parameter Description Requests help information 12 3 7 releaseJob Use this program to release a send job in status HOLD Syntax releaseJob n su user sp password sh lt host port gt Required Parameter Parameter Description n ID of the job to be released Optional Parameters Parameter Description verbose Verbose message output help Displays a description of the current command 2 Requests help information Optional Remote Parameters Parameter Description su lt user gt Client user for remote login Sp lt password gt Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server 12 3 8 restartJob Use restartJob to restart a job in status FATLED WITH SFNA Or SP FAILED Syntax restartJob n su user sp password sh lt host port gt rvsEVO User Manual Version 6 01 Rev 28 10 15 177 T Systems rvs Systems rvsEVO User Manual Required Parameter Parameter n Description ID of the job to be restarted Optional Parameters Parameter Description verbose Verbose message output help Displays a description of the current command 2 Requests help information Optional Remote Parameters Paramet
202. network parameters rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 55 rvsEVO User Manual sf Add Neig ihbour Static TCP IP Optional Parameters TCP IP Optional parameters description Number of Associated Receiver 1 Port 3305 Parallel Session 1 Active Connection Hint If you selected an ISDN network you have the possibililty to set up the X 25 parameters in the next window 4 The following tables insert the description of the network parameters TCP IP TSL Proxy TCP IP and Proxy TLS Parameters Partner on page 66 ISDN Parameters Partner on page 66 XOT Parameters Partner on page 68 The dialog below offers the possibility to set up the OFTP Optional Parameters Click Finish to add the neighbour station or Next to contiue You can find the description of the OFTP parameters in table 56 Management of Stations Optional OFTP Parameters Partner on page 62 OFTP Optional Parameters OFTP Parameters Receive Password Send Password EERP In EERP Out Exchange Buffer Size Exchange Buffer Credit VSDN Charset Restart SFIDDESC As Filename rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 57 rvsEVO User Manual The next dialog offers the possibility to set up the
203. ng rvsEVO is running r replace To replace a file with the same name if neces sary If a file with the same name is present and this parameter was not set the process is failed with an error message h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 23 importStationlist Import of a Stationlist Use this tool for importing a stationlist into the database and deleting the present station settings Syntax importStationlist lt File gt c help verbose v Required Parameter Parameter f lt File gt file lt File gt Description Path and name of the file from which the data are to be imported into the database Optional Parameters Parameter C clean Description to delete the old station data before new data are imported h help Displays a description of the current command V verbose Displays a description of the current command Verbose message output rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 255 rvsEVO User Manual 19 6 24 importTrustedServiceList Import of a TSL Use this tool to import a TSL Trust Service Status List into the rvsEVO database Syntax importTrustedServiceList f TSL filenam
204. nput box Default Key the Key with default label can be defined Import certificates Via the buttons Import Certificate and Import Comsecure Certifi cate the certificates of your partner can be imported The certificate which was imported at first gets the default label by default In the check box Default Certificate you Can edit this setting The block Key Usage offers the possibility of functional appropriation Key Usage Parameters Partner Parameter Description OFTP2 File Signature Select the certificate using for file signature by default OFTP2 Response Signa Select the certificate using for EERP NERP ture signature by default ComSecure File Signa Select the certificate using for signature of files ture which are encrypted via ComSecure The next parameters only have to be set if you wish to use another certifi cate than that one with default label Certificate Usage Parameters Partner Parameter Description OFTP2 Authentication Select the certificate of your partner which you want to use for authentication OFTP2 File encryption Select the certificate of your partner which you want to use for file encryption ComSecureFile encryp Select the certificate of your partner which you tion want to use for ComSecure encryption OFTP This group contains the parameters which refer to ODETTE protocol In the following table you will find detailed explanation of ODE
205. nt messages are displayed at the bottom of the window in a new view The language setting of the Live Monitor Log can be aligned via user language parameter in RVS_HOME conf rvs properties file Changes only take effect after a restart of rvsEVO server The latest 1000 messages are displayed by default This setting can be configured via the definition entry key client moni torlog livelog pagesize value 1000 gt in SRVS_HOME conf rvsEvoClient prefs file Anymore it is possible to highlight the display of information INF warnings WRN and error messages ERR This is configurable via the definitions lt entry key client moni torlog INF WRN ERR colour r g b value 255 0 gt in SRVS_HOME conf rvsEvoClient prefs file Examples entry key client monitorlog ERR colour r value 255 gt In the example above the error messages are displayed red colour r entry key client monitorlog WRN colour g value 255 gt In the example above warnings are displayed in green colour g Hint The GUI must be restarted to make the changes effective By default the Live Monitor Log is automatically updated Via the button the auto refresh can be stopped and via the button the auto refresh can be started again Hint Via the buttons amp G atthe top ofthe Live Monitor Log View you have the possibility to refresh the Live Monitor Log View to select the col
206. nt views e g tree view list view detailed view You can re position a view via Drag amp Drop Thereby a frame gives you a preview of the new position and the docking site is displayed by an arrow Via a right click on the tab a dropdown list opens and the following func tionalities are avaiable Close the active view Close others the views in background Close all Hints Minimized windows can be restored with a mouse click on the symbol at the top of the window Drag the GUI window to the top of the screen to maximize the window Draw the GUI window to the right or left edge of the screen to change to half screen Draw the window to the center of the screen to go back to previous position A mouse click on the menu item Window Reset Perspectiv resets the perspective to default view 4 2 Local GUI The illustration below shows the basic structure of the GUI in the Standard Edition of the Stations perspective rvsEVO User Manual Version 6 01 Rev 28 10 15 37 Q T Systems rvs Systems rvsEVO User Manual 4 rvsEVO LOC fou x File View Window Help Jd x M uxiEISICIo I Transfer 2 Monitoring Ef Stations a Key Management e Automation Ij Parameter e User Management EP Stations 3 6 B LOC 3 Sen A Z c Stations Tree General type filter text M _ Ww Loc Sane v Required Parameters f Virtual stations 3 4 Par
207. ntiating the various receiving channels through which the local sta tion can be reached Each number has a tab with a set of ISDN parameters rvsEVO automatically assigns and manages this number Default 1 Type Determines the type of connection within your computer CAPI2 Default CAPI2A A no Diehl Eicon card Card Number Number of the ISDN card installed in the compu ter Default 1 ISDN Protocol Specifies the ISDN standard used 1TR6 German national standard E DSS1 EURO ISDN Default E DSS1 ISDN Facilities Special information or facilities of the ISDN trans mission 66 Management of Stations ISDN Parameters Partner Parameter ISDN Userdata Description User data for the ISDN transmission ISDN Terminal Identifier Only required for X 31 Terminal End Identifica tion Default 0 no TEI assigned Time Out Time Out in miliseconds after which the commu nication program the connection closes if the partner station does not answers Default 60 Dial Retry Count Count of dial retries if the partner does not ans wer Dial Retry Wait Time Wait time between two dial retries if the partner does not answer Number of Associated eceiver lt ReceiverNumber gt Number for differentiating the various receiving channels through which the local station can be reached Each number has a tab with a set of ISDN parameters
208. ode error level 0 j lt start job gt without function label Name of group of serialized send jobs User spe cified descriptive label for this job See para meter Serialization M lt length gt Maximal record length for the files in format F or Vv Hint with sfs 4 OFTP 2 0 the record length will be determined automatically if M is not set Please see also the parameter rm lt record mode gt nocp By default creating a send entry the files to be send are copied to Outbox directory of rvsEVO With option nocp the original file will be deleted after transmission was successfull Not if the for mat of the file to be send is U Attention If you have installed a serverfarm this parameter must not be activated The transmitted files need to be copied to outbox directory on the NFS drive so that each node is able to access the file see also chapter 15 Multi Instance Functionality of rvsEVO rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 171 rvsEVO User Manual Optional Send Parameters Parameter Description rm record mode In this parameter you indicate the mode of files in format F or V Possible values TXT text file BIN binary file Text File in format F If the record length deviate from the specified one Parameter MaxRecl the line will be filled with blanks or will be cut
209. odule architecture OFTP2 Internal Partner station OFTP1 Station Encryption decryption virus scan Hint You can combine the File Service Module with rvs OFTP Proxy see chapter 17 rvs OFTP Proxy The following functions are available The File Service Module works as an OFTP router Protocol alternation OFTP1 lt gt OFTP2 all elements EERP even En and decryption of files acting for stations Automatc Certificate Exchange acting for stations rvsEVO User Manual Version 6 01 Rev 28 10 15 235 Q T Systems rvs Systems rvsEVO User Manual Virus scan of received files Connection to the PKI for downloads of certificates OCSP check download of CRL 18 3 Setting up of a Neighbour Station for File Service Module In this chapter is described the adjustment of setting up of a neighbour station for the OFTP File Service Module Please read chapter 5 Management of Stations for detailed description of station configura tion The relevant parameter for File Service Module is Required File Service Module parameter Parameter Description File Service Module This parameter enables the File Service Module Possible values NONE File Service Module is not needed default INTERNAL this partner station is an internal station located in the intranet When receiving an encrypted file which is routed to an internal station the mechanism of encryption at the File Service Modu
210. og for further information Thereunder the status line is arranged and gives information about rvsEVO installation 4 3 Remote GUI In rvsEVO you can login via remote access Pre requisites The following prerequisites should be fulfilled for a remote connection AnrvsEVO client should be installed on the client side see chapter 2 3 New Installation of rvsEVO The client user is to be set up as a user on the server side The server should be started 4 3 4 Starting the GUI from remote computer You can start rvsEVO GUI via the rvsEVO program group Start gt A11 programs rvsEVO GUI Alternatively this function can be started in the command line with the script RVS_HOME bin startGUI Syntax SRVS HOME bin rvsGUI r u user p password The following window is opened and you can login to the server vsEVO 6 RDDE9D84 3755 RDDE9D84 3755 rs og Kk Required specifications User Name Login to rvsEVO to the server with the user set up in the user management user ID Password Password of the user rvsEVO User Manual Version 6 01 Rev 28 10 15 39 Q T Systems rvs Systems rvsEVO User Manual Server Host Name Name or IP address of the remote computer and port to which the computer adheres to The following syntax is to be considered RMI Server Port Default port is 3755 Hint From the second login on you can select your login data fro
211. ogram is to be started Placeholder of jobstart type RCV MAXRECL The meaning of this field depends upon the record format of the received data set F format length of each record V format maximum length a record may have T und U format always 0 zero CNQS rvsEVO JobID command number of EERP End to End Response for received file in rvs portable CNIE rvsEVO JobID command number of IE for received file in rvs portable 132 Automation with rvsEVO CNIZ rvsEVO JobID command number of IZ for received file in rvs portable Conversion tables Note The next section is a short explanation of the conversion tables that are offered by rvsEVO Text files are stored on most systems in one of two computer codes namely ASCII American National Standard Code for Information Inter change or EBCDIC Extended Binary Coded Decimal Interchange Code ASCII is the standard code for UNIX and DOS Windows systems EBCDIC was developed for IBM Mainframe computers ASCII US ASCII ISO 646 the ASCII character set defines 128 charac ters 0 to 127 decimal This character set is a subset of many other character sets with 256 characters including the ANSI character set of MS Windows ANSI Windows ANSI Values 0 to 127 are the same as in the ASCII character set values 128 to 255 are similar to the ISO Latin 1 character set EBCDIC 037 support characters which are used in the following coun t
212. ollow the introduction below to create a send job Pressthe Create New Transmission entry in the navigation tree or Create New Transmission symbol in the function bar to open the wizard for creating a send job nput the mandatory parameters in the first dialog Press Next to set up the optional parameters or Finish for starting the send job Hint In table Required send parameters on page 81 you can find the description of the parameters There is the possiblity to create templates for data input See chapter Create Send and Remove Templates for Send Jobs on page 86 for further information Press the arrow to the right of input box Template Name to get the list of created templates and select a template that is to be used You can edit the imported values The job is started via a mouse click on Finish button 78 File Transmission with rvsEVO Mandatory Parameters Mandatory Parameters required for new send transmission Template Name 7 Set as default Addressing Mode Station ID c SID Originator LOC c SID Destination EVO54 File CADaten Testfile2 txt VDSN TESTFILE2 TXT Format U unstructured En Max Record Length 0 Record Mode Si TXT Conversion Table s File Description ExternalJobD Save As Template Reset From Template Reset From Default LS In the next dia
213. on Oracle database jdbc passsword is his password For further information see chapter 19 3 Oracle rvsEVO User Manual Version 6 01 Rev 28 10 15 23 T Systems rvs Systems rvsEVO User Manual Please enter the JDBC URL user name password and net service name for the database JDBC URL has the following format jdbc oracle thin lt host gt lt port gt lt servicename gt auon SUES Analogous to Oracle database set the MS SQL connection parame ters with MS SQL database jdbc url has the following syntax jdbc sqiserver host port databaseName name Default port for MS SQL is 1433 v rvsEVO Choose a persistence mechanism how the rvsEVO data will be stored into a database using Hibernate Microsoft SQI Server bi Enter the JDBC URL user name and password for the database JDBC URL has the following format jdbc sglserver host port databaseName name jdbc url jdbc salserver 10 33 72 18 1433 databaseName rvsdb jdbc username rys jdbc password rvs 24 Installation The following window contains the parameters for setting up the cluster node Group name is the name of your server farm The Group name must be the same on all cluster nodes Node name is an unambiguous designation of the node to be installed Furthermore you were asked for the Node IP the Node port and the IP addresses or hostnames of the other nod
214. on RVs The file is renamed to TESTFILE NEW and saved in RVS HOME files inbox directory Inthe first dialog the mandatory parameters must be entered Enabled Comment SID of Originator SID of Destination and VDSN 120 Automation with rvsEVO After Receive Mandatory Parameters Required Parameters for creating a new Jobstart Trigger RCV Enabled Press the Finish button to create the jobstart or NEXT to setup the parameters for starting a process Process Parameter Handling Shell Synchronized and Timeout Sync Process Start Parameters for Starting a Process V Process C resentr bat Parameter Handling ARGS Shell Synchronized ia Timeout Sync 60000 rvsEVO User Manual Version 6 01 Rev 28 10 15 121 T Systems rvs Systems rvsEVO User Manual Press the Finish button to create the jobstart or NEXT to setup the delivery parameters New Filename New Directory Replace Time Stamp TimeStamp Format Conversion Table and Record Handling p 3 Create a new After Receive Jobstart Delivery Parameters Optional Delivery Parameters for creating a new After Receive Jobstart x New Filename E Testfile nw New Directory Replace TimeStamp TimeStamp Format TIME Conversion Table Record Handling VFTXT i f lt Back Next Cancel
215. on via CRL and OCSP Please see chapter 22 PKI Connection for more information about certificate validation rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 155 rvsEVO User Manual 3 Automatisierung g Transfer Benutzerverwaltung EP Stationen Schl sselverwaltung E M E Parameter 22 amp 5 E Parameter SECURITY 22 amp IL Parameter Parameter SECURITY 4 ra Parametergruppen Name Wert CRLAutoUpdate N CEE XRUNNAL A Te 000 DIRECTORIES P MAINTENANCE CRLHttpProxyHost NOTIFICATION CRLHttpProxyPassword ODETTE CRLHttpProxyP ort RESOURCES_CHECK CRLHttpProxyUser SECURITY CRLLocalAddress CRLOftpProxyInstance CRLUseHttpProxy CRLUseOftpProxy OCSPHttpProxyHost OCSPHttpProxyPassword OCSPHttpProxyPort OCSPHttpProxyUser OCSPLocalAddress OCSPOftpProxyInstance OCSPUseHttpProxy OCSPUseOftpProxy TSLAutoDownload TSLAutoUpdate TSLAutoUpdatelnterval 000 TSLAutoUpdateNext TSLAutoUpdateURI http www odette org TSL TSL Basic XML TisCertificateValidationBehavior NORMAL TisCertificateValidationType CERT PATH TisPerfectForwardSecrecy JVM_DEFAULT TisPerfectForwardSecrecyFilter DHE ECDHE TisVersions TLSv12 TLSv1 1 TLSv1 r 4 Speichern Abbrechen RDDE9D84 3755 6 01 00 SNAPSHOT 2015 03 04 10 49 13 SE rvs Ad or 156 Customizing the Global rvsEVO Parame
216. one default N none disk space check 154 Customizing the Global rvsEVO Parameters Parameters for Certificate and Resource Check Parameter Mail Description Email address to which the warning is to be sent at the server startup if 1 the number of free disk space is less than defi ned in DiskSpace parameter The warning will be sent cyclically as defined in SuspendTime para meter 2 the values defined in parameters Certificate ExpirationWarning and CertificateExoira tionError are underrun See also parameters MailLocalAddress and MailSMTPHost in Parameters for Operation and Maintenance on page 147 RcvStopDiskSpace Number of kilobytes that has to be free in every checking rvsEVO directory before a warning in Monitor Log will be issued If the number of free kilobytes is less than a value of this parameter all rvsEVO receiver processes will be stopped No receiving of data will be possible Default 120 000 kB SuspendTime Time between the resourse checks after the value given in RevStopDiskSpace parameter was underrun Default 600 System a script which should be executed if the critical limit level is reached See CriticalDiskSpace parameter in this table Time Time in seconds between two resource checks Default 600 10 9 Security Parameters In this group you can configure proxy settings for the monitoring of certifi cations validati
217. onlist llli 254 19 6 23importStationlist Import of a Stationlist llle 255 19 6 24importTrustedServiceList Import of a TSL anaana ee 256 19 6 25exportUsers Export of User Data llli 256 19 6 26importUsers Import of User Data 000 ee ee 257 19 6 27switchDatabase Exchange of Database 0 ee 257 19 6 28Command Line Tools for Backup and Recovery 2 222 sense seen eee 258 19 6 29Command line tools for internaluse ee eee 259 20 Archiving the rvSEVO Data 00 eee 261 21 Backing Up and Recovering rvsEVO Data 263 21 1 Backups eek qe dee er er ERDE are Ph toes e a e bt ede ed 263 21 2 Recovering the rvsEVO Data uer I ERES Bi eens ins 264 22 PKlConnecliOm iiio ah ERE Ra te ees 265 22 1 Introd ctlon eoe Te RE RO RES Re hPa ER RR d ROC CI Roa n 265 22 2 Configuration of PKI Binding s RR DER an Pee eRe s 265 22 3 Validation Methods 0 00 cette eee eens 265 22 4 Certificate Validation via Key Management Perspective 0020e ee eee 266 rvsEVO Benutzerhandbuch Introduction 1 Introduction In this chapter you will find a short description of rvs and rvsEVO as well as an explanation of typographic conventions used in the present manual 1 1 Short description of the system What is rvs rvs Rechner Verbund System The abbreviation rvs stands for the German word Rechner Verbund Sy
218. ool for creating a jobstart list xml file from rvs portable rvs portable must be launched Syntax portable2jobstart lt file gt file is the xml file name The file can be imported into the rrsEVO database via RVS HOME tools importJobstarters script portable2stationlist Use this tool for creating a stationlist xml file from rvs portable rvs portable must be launched Syntax portable2stationlist lt file gt file is the xml file name The file can be imported into the rvsEVO database via SRVS_HOME tools importStationlist script 2 6 rvsEVO Version Via the Help functionality in the menu bar you get information about the installed rvsEVO version As an alternative you can execute the script SRVS_HOME tools rvsver bat 2 7 Uninstall rvsEVO In order to uninstall rvsEVO please follow the procedure given below rvsEVO User Manual Version 6 01 Rev 28 10 15 31 Q T Systems rvs Systems rvsEVO User Manual Windows e Start the program RVS_HOME UninstallerData Unin stall exe and follow the dialog e Inthe first dialog you can indicate the components to be deleted Those are available Remove rvs database Remove inbox outbox and archive files Remove all other files logs user files Click on Uninstall button to uninstall rvsEVO This will remove features installed by InstallAnywhere It will not remove files and folders created after the installation
219. our stations Via the arrow to the left of the neighbour stations the routed stations are blended or blanked Via the input box above the navigation tree the display can be filtered If you prompt rvs into the input box only the stations beginning with rvs are displayed Moving the cursor on a station in the navigation tree opens a tooltip displaying the Odette ID and the remarks There are two types of display navigation tree and list view The type of display can be selected via the symbols in the tool bar le By default the list view displays the following information SID Odette ID Type Network Gateway only for routed Stations SID of the neighbour the routed station is reachable over and Remark The parameter can be blended or blanked via a right mouse click on the column header and then selecting the appropriate entry With a single click on the column headings the list entries are sorted The list view provides a filter function Insert the string you want to filter on into the top of the correspondent column You can start the following operations with a right mouse click on a station in list view or navigation tree 44 Management of Stations Local Station Open in New View Add Neighbour Station Add Virtual Station Add Listener Remove Listener Virtual Station Open in New View Duplicate Station Delete Entry Neighbour station and routed Station Open in New V
220. ows service By default rvsEVO is installed as a Windows service Note The term service means a program that can be started from the operating system and works in the background rvsEVO as Windows service can also be started via the batch script rvsEVOservice exe Syntax rvsEVOService install ini gt configure ini lt remove ini gt debug ini gt run ini Optional rvsEVO Service Parameters Parameter Description install ini Installs rvsEVO as service SRVS_HOME bin rvsEVOService ini Is used by default configure ini For new configuration of an installed rvsEVO Windows service SRVS_HOME bin rvsE VOService ini is used by default remove ini Removes rvsEVO as service SRVS_HOME bin rvsEVOService ini Is used by default debug ini For starting a console application for debugging SRVS_HOME bin rvsEVOService ini Is used by default run ini Starts rvsEVO as service on console SRVS_HOME bin rvsEVOService ini Is used by default Hint After installation of rvsEVO as a service you can find rvsEVO in the list of system services Start gt Control Panel gt Adminis 34 Start and Stop of rvsEVO trative Tools gt Services If you want to start rvsEVO with each system start you can set the startup type to Automatic by choosing the Automatic entry from the combo box in the Startup type area 3 4 Automa
221. p userManagerClient rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 201 rvsEVO User Manual 202 Setting Up of the Log and Trace Files 13 Setting Up of the Log and Trace Files rvsEVO messages and warnings are saved in the log files in directory SRVS_HOME 1log The monitor log file contains the Monitor messages the rvs 1log file contains the messages from rvsEVO Server the rvsClient 1log file contains the messages from the command prompt and the rvsClien tRCP log file contains the messages of the RCP GuUls The trace files contains the network data 13 1 monitor log File The Monitor messages are saved in the file RvS HOME 109g monitor log A new monitor log file is generated daily and the old monitor log file is renamed in monitor log plus date pattern plus counter Also a new file is generated if the maximum file size is reached The maximum file size and maximum number of monitor log files can be defined in the element appender name monlog in the SRVS_HOME conf rvsLogger xml file Maximum size use the function MaxFileSize Syntax lt param name MaxFileSize value 10MB gt Maximum number of log files use the function MaxRollFileCount Syntax lt param name MaxRollFileCount value 50 gt Output Parameters of Log Messages Parameter Description Date Time Date and time of the entry format yyyyMMdd HH
222. p down menu Import the intermediate CA certificate of your partner via right click on Intermedia Intermedia Certificates entry and selecting Import Certificate entry from the drop down menu Import the server certificate of your partner via right click on Partner Certificates entry in the navigation tree and selecting Import Partner Certificate from the drop down menu Hints With TLS encryption either Root or Intermediate certificate must be imported With TSL encryption CertPath validation takes place by default Please see chapter 22 PKI Connection for more information 8 4 6 Export of the Own Public Key Right click the key pair in the list view and select Export Certificate from the drop down menu to export your public key into a file X 509 certi ficate A window opens and you can specify directory and file name Finish the export via a single click on the Save button 112 Secure Transmission with rvsEVO 8 4 4 Import and Export of a Partner Certificate rvsEVO enables to import trusted certificates from partners into the key management and to export already imported certificates from the key management into a file Import Right click the entry Partner Certificates in the navigation tree and select Import Partner Certificate from the drop down menu for importing a partner certificate A dialog box opens and you can input the following values sta
223. proceed as follows Right click the Observer entry in the navigation tree and select Add Observer from the drop down menu or press the Add Observer symbol in the function bar to open the wizard for creating an Observer The following window opens and the Mandatory Parameters State Time Directory Mask VDSN SID Originator SID Destination Dispo sition are to be entered In the following example the directory c Observer will be scanned every 60 seconds for all files transfered from neighbourstation EVO54 which file name begins with TEsT and VDSN is TESTFILE 136 Automation with rvsEVO Mandatory Parameters for Observer State Time 60 c Observer TEST VDSN TESTFILE SID Originator LOC SID Destination EVO54 Disposition K keep Create the Observer via mouse click on Finish button or press Next to insert the Optional parameters Format Record Length Record Mode Conversion Table Serialization Label and File Description rvsEVO User Manual Version 6 01 Rev 28 10 15 137 Q T Systems rvs Systems rvsEVO User Manual Optional Parameters Optional Parameters for Observer Format U unstructured Record Length 0 Record Mode Conversion Table Serialization Label File Description Create the Observer via mouse click on Finish button or press Next to insert the Security Parameters
224. r instance of Derby may have already booted the database C rvsEVO db 3 2 Start GUI Language setting The default language of the GUI is English The language setting of the GUI can be aligned via First Language parameter SRVS_HOME conf rvsEvoClient prefs file en English de German This setting does not concern the log messages Changes only take effect after rvsEVO GUI restart Example for language setting English entry key client FirstLanguage value en gt Start the GUI via the program RVS_HOME bin startGUI Syntax StartGUI rcp swing local consol reset help Optional startGUI Parameters Parameter Description rcp RCP GUI is started on local machine default on Windows and Linux systems not available on UNIX systems swing SWING GUI is started on local machine default on UNIX systems local Server and GUI are started in the same process console GUI is started with console output reset GUI display settings are resetted during startup rvsEVO User Manual Version 6 01 Rev 28 10 15 33 T Systems rvs Systems rvsEVO User Manual Optional startGUI Parameters Parameter Description help Requests help information usage Requests help information usage Hint for Windows The GUI can also be started via rvsEVO program group Start gt All programs rvsEVO rvs GUI 3 3 rvsEVO as Wind
225. r you define the time interval in seconds for conside ring the connections of the pool The parameter maxPoolSize defines the maximum number of connections to the database and minPoolSize defines the initial number of connections rvsEVO User Manual Version 6 01 Rev 28 10 15 239 T Systems rvs Systems rvsEVO User Manual For further information please read the C3P0 documentation http community jboss org wiki HowToconfiguretheC3PO0connectionpool 19 5 How to Delete and Create the Database Tables Hints The scipts for deletion and creating database tables are located in SRVS HOME system db directory Stop rvsEVO before executing the database scripts and restart rvsEVO after creating the new tables Remove tables If the data are not required anymore the current database tables can be droped via the script SRVS_HOME system db drop Create tables After the deletion the database tables must be created again Use the following scripts for the creation of the database tables SRVS_HOME system db create for the rvsEVO user and configu ration table SRVS_HOME system db create_default_user for creation of the default user SRVS HOME system db init config for the configuration table with default values and the values changed during installation S RVS HOME system db init identity for the assingment of the rights to the user roles 19 6 Databas
226. rameter f File Description Path and name of the license file Optional Parameters Parameter Description help Displays a description of the current command Displays a description of the current command verbose Verbose message output 19 6 16 exportObservers Export of the Configured Observers Use this tool to export the Observer data from the database into a file and replace a file with the same name if necessary Syntax exportObserver f File r help verbose v Required Parameter Parameter Description f lt File gt Path and name of the file in which the Observer file File data are to be imported 250 rvsEVO Database Optional Parameters Parameter r replace Description To replace a file with the same name if neces sary If a file with the same name is present and this parameter was not set the process is failed with an error message h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 17 importObservers Import Observer Data Use this tool for importing Observer data into the database and deleting the present Observers Syntax importObserver f File c help verbose v Required Parameter Parameter f lt File gt file lt File gt
227. rameter CertificateExpirationEr ror Description If certificate expiration is reached in less days than defined in this parameter an error message will be issued in Monitor Log and if indicated will be sent see also parameter CertificateExpira tionMail Default 7 CertificateExpirationMail With this parameter you define whether an email is sent in case of certificate expiration Possible values Yes v email is to be sent No N email is not to be sent CertificateExpiration Warning If certificate expiration is reached in less days than defined in this parameter a warning will be issued in Monitor Log and if indicated an email will be sent see also parameter Mail Default 30 CriticalDiskSpace Number of kilobytes that has to be free in every checking rvsEVO directory With this parameter the critical limit for the resource deficit should be configured If the number of free kilobytes is less than a value of this parameter all rvsEVO proces ses and the rvsEVO server will be stopped You have a possibility to start a script see parameter System in this table Default 100 000 DiskSpace Number of kilobytes that has to be free in every checking rvsEVO directory before a warning in Monitor Log will be issued Default 150 000 kB DiskSpaceCheckEnab With this parameter you define whether the disk led space is to be checked or not Possible values Y disk space check should be d
228. raphic conventions Instructions begin with a bullet Other lists begin with the en dash Character styles y Courier Commands menu commands file names path names programs examples scripts options qua lifiers data sets fields modes window names dialog boxes and statuses BOLD and UPPER Parameters environment variables variables CASE Inverted comma Links to other manuals sections and chapters literature Bold Important terms names of operating systems pro per names buttons function keys Directories RVS HOME As user directories are found on different locations for the different operating systems we use the variable RVS_HOME in this manual Default values are C Programs rvsEVO for Windows Substitute the variable with your correct path 1 7 Target group This manual is meant for regular users of rvsEVO as well as administra tors It provides an overview of the basic rvsEVO functions Skills The following skills are required to be able to use rvs EVO good knowledge of the current operating system knowledge of the communication techniques in use TCP IP TLS ISDN XOT Proxy TCP IP oder Proxy TLS Introduction Before starting to work with rvsEVO it is advisable to have read this book rvsEVO User Manual Version 6 01 Rev 28 10 15 15 T Systems rvs Systems rvsEVO User Manual Installation 2 Installation This chapter describes the syst
229. rd of the key management file and in input field Label an identifier for functional assignment of the certifi cate usage Press the Import button to import the key rvsEVO User Manual Version 6 01 Rev 28 10 15 113 Q T Systems rvs Systems rvsEVO User Manual Export Import Export Hint The first key pair is saved as default key as standard This setting can be configured in parameter group Keys of the local station See chapter 5 2 2 Parameter Groups of Local Station for more information Right click the key to be exported in the list view and select Export Private Key from the drop down menu A dialog box opens and the directory and the name of the file is requested Press the Export button to export the key into the specified directory and file 8 4 9 Import and Export of ComSecure Public Keys rvsEVO supports an appropriate format for the encryption so it is necessary to convert a ComSecure public key into from a X 509 certifi cate before importing exporting it into the key management X 509 is a standard format for digital certificates certificate files end normally with cer This functionalities can be executed via the functions Import ComSecure Public Key and Export Certificate to ComSe Cure Right click the Partner Certificates entry in the navigation tree and select Import ComSecure Public Key for importing a ComSecure public key as X 509 certificate into the rvsEVO key manage ment
230. re verbose Verbose message output rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 175 rvsEVO User Manual Optional Parameters Parameter Description help Displays a description of the current command Requests help information Optional Remote Parameters Parameter Description su lt user gt Client user for remote login Sp lt password gt Password of the client sh lt host port gt Host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server 12 3 6 deleteJobsOlder Delete Old Jobs Use this tool to delete jobs depending on age and state All parameters are optional By default send jobs in WF_EERP state are deleted Syntax deleteJobsOlder m lt month gt d lt days gt h lt hours gt i lt minutes gt s lt state gt ds dr verbose Optional Parameters Parameter Description m Jobs older than given number of months are deleted d Jobs older than given number of days are dele ted h Jobs older than given number of hours are dele ted i Jobs older than given number of minutes are deleted S State of jobs to be deleted Default WF EERP ds Send jobs are deleted default dr Receive jobs are deleted verbose Verbose message output help Displays a description of the current command 176 Command Li
231. ries Australia Brazil Canada New Zealand Portugal South Africa USA EBCDIC 273 supports characters especially umlauts which are used in the following countries Germany Austria and Switzerland How to add your own conversion table In order to use your own conversion table please follow the procedure given below create a new conversion table The content of this file is described in the following XML schema lt conversiontable codein Original Characterset codeout Ziel Characterset gt lt description gt Table to converts signs from to lt description gt lt char value 0 gt 0 lt char gt lt char value 1 gt 1 lt char gt lt conversiontable gt Note char value is equivalent to the source code and the value in angle brackets is equivalent to the target code Store the XML file in the directory SRVS_HOME conf conversiontables rvsEVO User Manual Version 6 01 Rev 28 10 15 133 T Systems rvs Systems rvsEVO User Manual Jobstart lists Detailed view To add your table to the list of conversion tables edit the XML file SRVS HOME conf conversiontables characterSetConver ters xml Next you find an abridged version of the file characterSetConverters xml characterSetConverters coding gt 1 converter cid ANSIIBMO37 conversion ANSI IBMO37 xml converter converter cid IBM273 ASCII conversion IBM273 AS
232. rnal Job ID f lt filename gt su user sp password sh lt host port gt rvsEVO User Manual Version 6 01 Rev 28 10 15 181 Q T Systems rvs Systems rvsEVO User Manual Required Parameter Parameter xid lt external Job ID gt Description ID of the external job The ID can be stated with creating a transmission See chapter 6 File Transmission with rvsEVO Optional Parameter Parameter f lt filename gt Description Filename Optional Remote Parameters Parameter SU lt user gt Description Client user for remote login Sp lt password gt Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server The XML schema JobI n foList xsdis stored in the directory SRVS HOME system data xsd JobinfoList De De The root element is Job nfoList The XML element JobExtended tail contains all job information The XML element JobExtended tails contains JobDetails and JobError The XML element JobError is optional It contains ErrorIdentifier ErrorText and ErrorType JobInfoList Explanation of the job attributes Explanation of the job attributes Parameter compression Description Compressing possible values true yes or false no Default false con
233. rts can be opened The view in foreground is to be selected via tab The illustration below shows the default view on the right hand side and the list view at the bottom of the window 134 Automation with rvsEVO W e mg l Key Manage u i Parameter Stations ip Transfer Tl Automation 5 p i S5 Automation Jobstart After Receive 1402071018010000 E3 Jobstarts kgl After Receive lg After Send Attempts ID 1402071018010000 After Fail S Observer w Mandatory Parameters Direction RCV Comment Test Enabled Vv SID Of Originator RVS54 SID Of Destination LOC VDSN TESTFILE v Process Call Process C resentr bat Parameter Handling ARGS Shell Cancel 5 Live Monitor Log g Jobstarts After Receive 23 SBpa G Jobstarts After Receive ID x Direction VDSN SID Originator SID Destination Enabled 1312131300010000 1402071018010000 RCV TIT EVO6 EVO54 true ul RCV TESTFILE RVS54 LOC Active RDDE9D84 3755 6 00 03 SNAPSHOT 03 06 00 45 06 SE 9 2 4 Edit a Jobstart The parameters of a jobstart can be edited in the detailed view Save your changes via a mouse click on the Save button After changing the para meters you cannot open the detailed view of another jobstart without saving or canceling the changings 9 2 5 Delete a Jobstart There are two wa
234. rvsEVO Node NET LISTENER START SUCCESS anananann ansann mir rns 200 cm ermin eranten m J Station Count 2 vs Adm tor 7 4 44 Define Filter Criteria To define the filter criteria proceed as follows Feed the filter criteria in the input filed in column Preset Filter Activate the radio button in Order By column next to that parameter you want to sort on the output Execute the query via a single click on Execute button Please see table Monitor Log parameters on page 98 to get information about the parameters rvsEVO User Manual Version 6 01 Rev 28 10 15 101 Q T Systems rvs Systems rvsEVO User Manual 7 5 Monitor Log Files The current and the old messages are saved in the log files and can be displayed via a single click on Monitor Log Files entry in the Monitor Tree View A mouse click on a log file displays the detailed information of the log file in a new view Via Text View and List View symbols at the top of the view the output format can be selected List view The list view provides a filter function Insert the string you want to filter on into the correspondent column E g if you insert w in column Level only the warnings are displayed You can use the wildcard E g if you insert r in column Level the warnings WRN and Errors ERR are displayed Click the Reset Filter symbol for resetting the filter coc a c File View Windo
235. s is to right click the Observer and thereafter select Open in New View In the second case the detailed view of several jobstarts can be opened The view in foreground is to be selected via tab 9 3 3 Edit an Observer The parameters of an Observer can be edited in the detailed view Save your changes via a mouse click on the Save button After changing the parameters you cannot open the detailed view of another jobstart without saving or canceling the changings 9 3 4 Delete an Observer 140 Automation with rvsEVO There are two ways to delete an Observer Either by opening the detailed view of the jobstart and thereafter clicking on Delete button or by right clicking the Observer in the list and thereafter selecting Delete Observer or pressing the delete icon at the top right edge To delete several Observers select the Observer to be deleted while keeping the ctrl button pressed and select the Observer to be deleted with a left mouse click Thereafter you can delete the Observer via a right click or via the icon at the top right edge rvsEVO User Manual Version 6 01 Rev 28 10 15 141 T Systems rvs Systems rvsEVO User Manual 142 Customizing the Global rvsEVO Parameters 10 Customizing the Global rvsEVO Parameters The present chapter describes how to customize rvsEVO 10 1 The User Interface of Parameter Perspective The parameter management is reachable via menu item View gt Parameter Th
236. s not answers Default 30 0 menas that default value is used Router IP Address lt RouterlPAddress gt IP address of an XOT router This parameter is optional for the local station and mandatory for the partner station Router Port lt Port gt X 25 PacketSize lt PacketSize gt Port of the XOT router Default 1998 for XOT communication Size of data packets during data transmission Default 128 52 Management of Stations XOT Parameters Local Parameter X 25 WindowSize lt WindowSize gt Description Window size in X 25 ISDN communication is the number of packets that can be outstanding wit hout acknowledgment The window size will be negotiated during connection setup but we recommend you to use the correct window size depending on the partner network Possible values 1 7 default 7 We recommend 7 for ISDN and 2 for X 25 native X 25 Facilities lt X25Facilities gt Special information or facilities of the ISDN trans mission X 25 User Data User data for the ISDN transmission lt X25Modulo gt lt X25UserData gt X 25 Dbit D bit Delivery Confirmation an X 25 data packet lt DBit gt flag used to request end to end acknowledgment for the packet X 25 Modulo In X 25 data transmission exist two modulo ope rating standards Modulo 8 and Modulo 128 Modulo 128 means that you must select bigger window size via parameter X 25 Facilities
237. s po l AdAminictratar Active RDDE9D84 3755 6 00 03 SNAPSHO 06 00 45 06 SE After making the necessary changes press the Save button to confirm the modifications If you try to open the detailed view of another user without saving the modifications you were asked whether you want to save or discard the changes 11 5 Delete a User Open the detailed view of the user and press the Delete button or right click the user and select Delete User from the drop down menu Confirm your input by pressing the Yes button in the next dialog box to remove the user Hint You can delete several users at once by highlighting the users to be deleted holding down the control key Thereafter right click one of the highlighted users and select Delete User or select the Delete icon in the tool bar of the list view 166 Command Line Tools 12 Command Line Tools In this chapter you get an overview and the description of the command tools in RVS_HOME bin directory 12 1 getStationList Use this tool to export the stationlist from the database into an XML file Syntax getStationlist f File help verbose v Required Parameter Parameter Description f lt File gt Path and name of the file in which the stationlist file lt File gt is to be imported Optional Parameters Parameter Description h Displays a description of the current command help 2
238. se this tool for importing Proxy Bastion Instances into the database and deleting the present key data Syntax importOftpProxies f lt File gt c help verbose v Required Parameter Parameter Description f lt File gt Path and name of the file from which the data are file File to be imported into the database 252 rvsEVO Database Optional Parameters Parameter C clean Description To delete the old Proxy Bastions before new data are imported h help Displays a description of the current command Displays a description of the current command V verbose Verbose message output 19 6 20 exportQueries Export of Queries Use this tool to export the queries from the database into a file and replace a file with the same name if necessary Syntax exportQueries f lt File gt r help verbose v Required Parameter Parameter f lt File gt file lt File gt Description Path and name of the file in which the queries are to be imported Optional Parameters Parameter r replace Description To replace a file with the same name if neces sary If a file with the same name is present and this parameter was not set the process is failed with an error message h help Displays a description of the current command Displays a description of the current co
239. se user jdbcfile If the parameters are imported via imputfile path and name of the file skiptest Skip test connection to database switchonly Switch database without export and import of data testonly Make only test connection to database by using new parameters h Displays a description of the current command help Displays a description of the current command V Verbose message output verbose 19 6 28 Command Line Tools for Backup and Recovery The description of the following programs you can find in chapter 21 Backing Up and Recovering rvsEVO Data backup Export of the whole database restore Import of the whole database 258 rvsEVO Database 19 6 29 Command line tools for internal use The following programs are only for internal use importCRLs rvsEVO User Manual Version 6 01 Rev 28 10 15 259 T Systems rvs Systems rvsEVO User Manual 260 Archiving the rvsEVO Data Deletion of job data from database 20 Archiving the rvsEVO Data The archiving process takes place automatically after transmission jobs are terminated or failed During the process the job data are written into the RevisionLog file in the RVS_HOME archive directory by default Name and path of this file can be set up in PersistenceArchive para meter Please see chapter 10 5 MAINTENANCE The specified name is extended by a timestamp and a sequential counter initiating with 000
240. sed If an other certificate is assigned the default label the settings can be changed in Stations perspective via parameter group Keys of local station neighbour station Replace Certificate Use this feature to send a certificate to a partner station and replace an already existing certificate in this station Open the wizard for ACX Replace certificate via a single click on the following icon in the tool bar x5 r T ACX Replace certificate jel meom ACX Replace certificate m 3 This dialog is used to replace certificate SID originator lee E Select certificate 1 X LOC2 E Select all RVS54 SID destinations Replace certificate Cancel Select the station ID of the certificate s originator via selection box SID Originator Select the certificate to be replaced via Select certificate selection box Hint Selection of the certificate is done via certificate index You find the index in the list view and detailed view of a certificate Insert the station ID of the neighbours whose certificate is to be replaced via input box SID destination lfthe check box select all is activated the specified certificate is replaced at all neighbours Right click the Replace certificate button to execute the process rvsEVO User Manual Version 6 01 Rev 28 10 15 117 Q T Systems rvs Systems rvsEVO User Manual 118 Automation with rvsEVO 9 Automation with rvsEVO
241. sible values Y the log messages are displayed N the log messages are not displayed default MonlogInDatabase Cleanup Only relevant if MonlogInDatabase x In this parameter you define whether the log messages should be deleted automatically from database or not Possible values NONE Default log messages are not deleted automatically AUTO All log messages older than 7 days will be deleted every 24 hours by default This configu ration can be set up via the parameters Cleanup Days CleanuplInterval and CleanupTime Z 148 Customizing the Global rvsEVO Parameters Parameters for Operation and Maintenance Parameter PermissionTempScript Description File permission of the temporary script file which is copied into temp directory after a jobstart pro cess was started Only if Jobstart parameter Parameter bergabe REPLACE 770 read write execute for owner and group 777 read write execute for all users PersistenceArchive Name of the file with the transfer data statistic file Default SRVS_HOME archive Revision Log xml RedoLog no function 10 6 NOTIFICATION The parameters in this group refer to the feature rvs SNMP Agent rvs SNMP Agent is an application that can respond to Network management systems NMS queries and send rvsEVO status informa tion to NMS e rvsEVO LOC ch J File View
242. sing Mode input of SID Originator or OID Originator is required OID Destination Odette ID of Destination Hint Depending on parameter Adressing Mode input of SID Destination or OID Destination is required File Name of the file to be send VDSN Virtual file name the length of the file name used for ODETTE transfer must not exceed 26 charac ters Default Name of the File to be transmitted Hint Via defintion rvs_evo control ler underscore in vdsn allowed true in RVS HOME conf rvs system properties file you can configure that underscores are allowed in VDSN Format Format of the file to be sent T text file a stream of ASCII characters U unstructured binary byte stream V variable variable record length F fixed fixed record length Please see also the parameter Record Mode Determine Record Length automatically Only for files in format v and if parameter Secu rity Feature Set is 4 If the checkbox is activated the parameter Max Recorod Length is not to be set up and the record length is determined automatically Max Record Length Maximal record length for the files in format F or V please see also the parameter Record Mode 82 File Transmission with rvsEVO Required send parameters Parameter Record Mode Description In this parameter you indicate the mode of files in format F or v Possible values TXT
243. stallation iein 2x err en nha RE ERI are Wee ou meets e cite 17 21 System Requirements nr renes er que v ee We eq oY 17 2 2 Obtaining a License 95 cube a Ra a RE 19 2 3 New Installation of WsSEVO sse Barwon eee ee an kd wee Peed I Haee 19 2 3 1 Installation on Windows Systems iliis tee 20 2 3 2 Installation on Linux and UNIX Systems 0 000 c eee eee 27 244 rvsEVO update installation ole RR PR ea eee the er 28 2 5 Migration from rvs portable to WSEVO ur ese a Flee ee wa rx eng 29 26 IwsEVO MVelrsi IT sse Ia vr EE Gan pale chy Bee wade Se Se sa Res wedges 31 2 7 Wninstalli VSEV Ors ooo Sa fuse se eke Br SS ee MES xs ke in 31 3 Start and Stop of rvsEVO 6 oie eis cies Rer x bd a a uk Ri 33 3 Starting of WVSEVO Server ve zw dx a eu eb 33 32 Same ee ae wed ots elias Dh Di eee QE Ve Eig ke ER un ed 33 3 3 IVSEVO as Windows serwiee re back rs tede ed in ee adt e E d 34 3 4 Automatic Start on UNIX Systems 20 0000 0c eee 35 3 5 Stopping of rvsEV O server 5 lt 2 cant coo y aes er Nein Rs ete x wd ese ates lem a areata dec 35 4 Graphical User Interface sllees eee 37 41 Introduction sse nitet nr DP SE nna BRS oO iore PERVENIT acoge Feu 37 A2 boca BU owns ee de REO Ee ERI FECE aa abate ws huey bg uie 37 43 v Hemole uoi m Toa rte e n COE ERU E Oe ERG ore estt 39 4 3 1 Starting the GUI from remote computer 222 neuen nennen nenn 39 4 3 2 Features of Remote GUI u esa ie eek dee
244. station SID of Originator Station Id of source station local or virtual Sta tion Synchronized With this parameter you decide whether the OFTP session between sender station and recei ver station will be kept alive waiting until the pro cess is finished or not If the checkbox is activated the session will be kept alive Default not activated Timeout Sync If parameter Synchronized is activated Time Out in milliseconds after which the communica tion program the connection closes if the partner station does not answer Default 60 000 TimeStamp With this parameter you define rules for timestamp creation If the parameter is activated timestamp is to be generated gene rally hot activated timestamp is to be added only if necessary default rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 129 rvsEVO User Manual Jobfilter elements Parameter Description TimeStamp Format Format of the timestamp Possible values TIME creation time of the job and counter for mat hhmmssccc default DATETIME creation date and time of the job and counter format YYMMDDhhmmssccc SFID_DATETIME Odette timestamp of SFID date time and counter in format YYMMDDhhmms SCCCC COUNTER 000000 999999 If the counter is not sequential the gap is filled first before the counter is counted up VDSN Virtual f
245. stem The rvs computer communication system is a well established base service for electronic data interchange EDI rvs serves to ensure transmission of electronic data between heteroge neous computer platforms using different network protocols To do so rvs implements a universal network model which you can configure in each network node rvs provides an efficient and reliable transport service for both standar dized EDI message types and files of any format or contents You can receive only such files that are explicitly destined for rvs This means that rvs does not allow any unauthorized access to remote or to own data files The system was originally developed by Volkswagen AG and has been used in the German and European automobile industries for a number of years and by banks insurances and industries worldwide rvs uses the OFTP protocol What rvs is not rvs is not an online system It neither supports direct terminal like access to other sites nor provides a communication pipe from application to application on a data record level You cannot directly execute transfers in your own application You rather can place send orders from within your application to rvs which will be handled asynchronously rvs is not a job scheduling system rvs does not care about the contents of the files it transfers It only acts as a transparent transport medium and performs no semantic interpreta tion of
246. t Security features Possible values 1 none 2 ComSecure V1 3 ComSecure V2 4 OFTP 2 0 sendAttemps Number of faulty dispatch attempts If there is a 0 it means that this is a successful file dispatch serialization This option means that your files are there in a serial order All the files which should be sent in the same group should have the same ID Label Possible values true yes false no Standard value false SFIDTIME Counter sequential counter from SFID if several send jobs were created at the same time SID SID depending on the direction While sending SID of the recipient While receiving SID of the Originator station sidDestination SID of the target station sidOriginator SID of source station sign Signature possible values true yes false no Default false signCertificatelssuer Name Publisher name of the signature A value is displayed if a certificate is indicated for use explicit It is not displayed which certificate is used in fact rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 185 rvsEVO User Manual Explanation of the job attributes Parameter signCertificateSerialN umber Description Serial number of the signature A value is displayed if a certificate is indicated for use explicit It is not displayed which certificate is used in fact
247. t 30 000 no maximum SessionAliveTimeout Time in milliseconds to consider a connection active Default 600 000 no maximum SessionWaitTime SessionWaitTime is the time in milliseconds the OFTP session between the sender and the recei ver station will be kept alive after an ended trans mission for waiting for another send job Default 0 Timestamp Defines whether or not a time stamp is added to a file name name when it is received Possible values N default Time stamp is added by default only if the file name already exists Y File name always receives the time stamp Traceltem Parameter that enables tracing The following values are possible O for Odette level N not active default See chapter 13 5 Trace Files for further infor mation TransmissionFailWait Time Time in milliseconds for a transmission restart after a failure Default 30 000 10 8 RESOURCES_CHECK This parameter group refers to resource check of rvsEVO directories and checking the expiration dates of certificates This functionality allows the operator to react early enough to lack of free disk space and expiring certificates 152 Customizing the Global rvsEVO Parameters File View Window Help E amp 3 Automation E Key Manage Monitoring ES Parameter amp Stations y Transfer User M E Parameter 53 Parameter Parameter RESOURCES CHECK
248. t entry gt lt locality gt entry key subject 1 gt Berlin lt entry gt lt l State gt lt entry key subject st gt Berlin lt entry gt lt country code gt lt entry key subject c gt de lt entry gt email gt entry key 2 subject email rvs supportGt systems com lt entry gt The following values are set in above example common name rvsEVO comsecure organisation unit Ivs organisation T Systems International GmbH locality Berlin state Berlin 30 Installation contry code de email rvs support r systems com The other elements of certificate properties xml must not be edited Only with encrypted transmission import the public keys of your partners Create the users which were defined in rvs portable They will not be created automatically Note Use the following command tools for importing the settings into an existing rvsEVO SRVS HOME bin portable2codetable bat SRVS HOME bin portable2jobstart bat and SRVS HOME bin portable2stationlist bat portable2codetable Use this tool for converting a codetable from rvs portable rtc format to xml format Syntax portable2codetable lt rtc file gt lt xml file gt rtc file is the name of the codetable in rvs portable xml fileis the name of the codetable in rvsEVO portable2jobstart Use this t
249. t have the same label see parameter Label Label Group name of serialized send jobs User speci fied descriptive label for this job See parame ter Serialization Disposition Disposition of local file after successful send attempt Possible values K Keep file will not be deleted after sending D Delete file will be deleted after sending No Copy With this parameter you can decide whether the file which should be transmitted is to copy to Out box directory or not Attention If you have installed a serverfarm this parameter must not be activated The transmitted files need to be copied to outbox directory on the NFS drive so that each node is able to access the file see also chapter 15 Multi Instance Functionality of rvsEVO Hint no effect if files in U format are sent with code conversion rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 85 rvsEVO User Manual Edit template Delete template 6 3 Create Send and Remove Templates for Send Jobs Right click Manage Template entry in the navigation tree and thereafter Create New Template to create a template or press Create New Template icon in the function bar In the dialog below you can configure the mandatory parameters r Create Template for Send os EM Sendjob Template Parameters E Parameters required for create new template for send jobs Template Name
250. t of data and jobs than a single instance Adding or removing nodes at runtime allows the processing capacity to be dynamically adapted without having to stop rvsEVO 15 2 System Requirements Architecture of a Serverfarm To successfully operate the serverfarm you need the following compon ents Operating systems UNIX currently only Linux Database Oracle 11 IP load balancer network file System network drive e g NFS Hint The system clock of all nodes of the serverfarm is to be synchro nized via NTP Each rvsEVO node is equipped with all functions and needs access to all resources in the cluster systems resource sharing An rvsEVO cluster comprises the following components several rvsEVO nodes rvsEVO server with rvsEVO client and Oracle client Network file system The illustration below shows the system architecture of the operation with multi instance functionality 224 Multi Instance Functionality of rvsEVO tony rvs P Praxy I Load Balancer rvsEVO Node Oracle Database NFS Ss e d rvsEVO Node 15 3 Installation of a rvsEVO Serverfarm Installation of a server node runs nearly analog to an installation of a single instance see chapter 2 3 New Installation of rvsEVO Please notice the following points Install the Enterprise Edition of rvsEVO Use the Oracle database Insert in IP address or hostname parameter of server settings window the
251. tem A failure of the entire system causes a restart of jobs combined with the restart of the rvsEVO systems Failure of the A temporary failure the connection is set up automatically such as confi database gured in the Connection Pool see Chapter 19 3 Oracle section Connection Pooling If all connection attempts failed an error message is output all activities are terminated in a controlled manner and the node or the rvsEVO system is stopped The activites can be restarted Failure ofthe If the read or write access failed the procedure is equivalent to the failure network file systems ofthe database All activities are terminated in a controlled manner and the node or the rvsEVO system is stopped The activities can be restarted rvsEVO User Manual Version 6 01 Rev 28 10 15 223 Q T Systems rvs Systems rvsEVO User Manual System require ments System architecture 15 1 2 Load Balancing As every node in rvsEVO can assume all tasks it is possible to evenly distribute the load among all nodes A server with low load will start processing a new job earlier than a server with a high load because it will access the list with upcoming tasks earlier to check for new jobs which are to be processed first come first serve 15 1 3 Scalability You can use the serverfarm to add new rvsEVO nodes or to remove old ones This quantitative node scalability allows the serverfarm to process a significantly greater amoun
252. ter Description restart With this parameter all listeners are restarted default Hint Do not use parameters restart start and stop together start With this parameter all listeners are started Hint Do not use parameters restart start and stop together stop With this parameter all listeners are stopped Hint Do not use parameters restart start and stop together 190 r Command Line Tools Optional Parameters Parameter n number Description Listener number for starting or stopping the indi cated listener see network parameters of local station line Network type for starting or stopping the listeners of the indicated type Possible values TCPIP XOT TLS ISDN REMOTE TCP REMOTE TLS verbose Verbose message output help Displays a description of the current command 2 Requests help information 12 7 cleanup Deletion of Jobs and Monlog Data from the Databa se Use this program to delete ended and failed transmission jobs or and monlog data which are older than the defined date Syntax cleanup d lt date gt verbose v Erforderlicher Parameter r t type heip Parameter d lt date gt Beschreibung This option needs a date in the following format yyMMddHHmmss or yyMMdd The jobs or monlog data which are older than the entered date will be deleted from the datab
253. ters Security Parameters Parameter CRLAutoDownload Description Only available if parameter Certificate Valida tion Type CRL see table Parameters for PKI Binding on page 265 Possible values Y Yes N No default If CRLAutoDownload y an automatic download of CRL and import into the database takes place first import into the database CRLAutoUpdate Only available if parameter Certificate Valida tion Type CRL see table Parameters for PKI Binding on page 265 Possible values Y Yes N No default If CRLAutoUpdate y an automatic update of CRL takes place in regular time intervals See also parameter CRLAutoUpdatelnterval CRLAutoUpdatelnterval Time interval for automatic CRL update A des cription of the format you can find under nttp quartzscheduler org The whole URL you can find below the table Exmples 000 The update is executed daily at 12 00 am default 015 10 The update is executed daily at 10 15 am 0 0 0 6 12 18 The update is executed daily at 12 00 am 6 00 am 12 00 pm and 6 00 pm See also parameter CRLAutoUpdate CRLHttpProxyHost http Proxy server to be used for the connection to the external CRL URIs CRLHttpProxyPassword Password for http Proxy in case of user pass word access for CRL download CRLHttpProxyPort Port for the connection to the Http Proxy Server for CRL download CRLHttpProxyUser
254. tes tracing help h Displays a description of the current command Optional Remote Parameters Parameter SU lt user gt Description Client user for remote login sp lt password gt Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server rvscli Use the help command for listing all rvsc1i commands Commands C rvsEVo5416 2 bin gt rvscli No 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 222222222 RVS Command Line Interface n eee Version 6 01 00 rvscli gt help Command to Execute Operating System 05 Commands activatestation Command to Activate Station acxDelivercertificate Command to Deliver ACX Certificate acxReplacecertificate Command to Replace ACX Certificate acxRequestcertificate Command to Request ACX Certificate cleanup3obs Command to Cleanup Jobs cleanupMonitorLogInDB Command to Cleanup Monitor Log from Database cls Command to Clear Console createcsR Command to Create Certificate Request createJobQuery Command to Create Job Query createJobstart Command to Create New Jobstart createobserver Command to Create Observer createproxy Command to Create Proxy Bastion createReceiver Command to Create Receiver createsendJob Command to Create New Job in Local Mode Command to Create New Job in Remote Mode
255. the User management perspective The illustration below shows the default view of Standard Edition File View Window Help amp amp v XP Automation E Key Manage Monitoring Ij Parameter 8E Stations E User Management 53 El amp Users amp Operators amp Administrators 23 Sea User Management Administrator amp All Users amp Administrator amp Operator amp User User Login First Name vs Live Monitor Log Date Time 70 403003 4900 20140307 1255 20140307 1305 Level Module Message Session Station INF CTRL CLEANUP COMPLETED INF CTRL CLEANUP STARTED em CIrARHIN ni ra RDDE9D84 3755 6 00 03 SNAPSHO 06 00 45 06 SE The symbols in the function bar on the left side of the window provides the following functionalities Show Live Monitor Log Reset Perspective Create New User Below the navigation tree provides the following entries All Users Administrator Operator rvsEVO User Manual Version 6 01 Rev 28 10 15 163 Q T Systems rvs Systems rvsEVO User Management User At the bottom of the GUI the Live Monitor Log View is positioned 11 2 Display Users List view Listings of the users can be displayed via a single click of the user group in the navigation tree The list will be output in a new view A right click on an user in the list opens a
256. the data it carries rvs is not an EDI converter Please contact your sales partner if you need to convert among specific message formats e g VDA ODETTE EDIFACT XML Phone 49 375 606 19 902 E Mail rvs service t systems com rvs is not a network control or monitoring tool rvsEVO User Manual Version 6 01 Rev 28 10 15 9 T Systems rvs Systems rvsEVO User Manual What is rvsEVO rvsEVO is a communication software with a graphical user interface based like rvs on the OFTP protocol Available features The following features are available in rvsEVO 6 00 graphical user interface sending files to neighbour or to routed stations receiving files from neighbour or from routed stations receiving files on virtual stations sending files from virtual stations activating neighbour stations support of the OFTP version 1 3 1 4 and 2 0 viewing information about receive send failed and ended jobs displaying monitor messages log files for tracing the monitor activities and for troubleshooting deleting or releasing EERPs End to End Response if necessary archiving information about the send or receive jobs in the revision log code conversion with various code conversion tables format conversion defining job filters and actions when sending or receiving files compression and encryption backup and recovery No limit for size of transmitted files
257. ther the file which should be transmitted is to copy to Out box directory or not Attention If you have installed a serverfarm this parameter must not be activated The transmitted files need to be copied to out box directory on the NFS drive so that each node is able to access the file see also chapter 15 Multi Instance Functionality of rvsEVO SFS Security Feature Set this parameter applies to the format of encryption Possible values 1 no encryption default 2 ComSecure V1 3 ComSecure V2 4 OFTP 2 0 CMS GUI name Security Feature Set 212 rvsbat Batch Interface Optional Send Create Parameters enclosed in parentheses Parameter Description SIGN File signature is activated Active only in connec tion with sfs 4 OFTP 2 0 Possible values Y File Siganture is active N None file signature default GUI name File Signature SIGNCERTSN Serial number of the certificate for file signature active only in connction with sfs 4 and SIGN v GUI name Encryption Cert Serial Number SIGNCERTIN Issuer name of the certificate for file signature active only in connction with sfs 4 and SIGN v GUI name Encryption Cert Issuer Name SIGNRESP Request signed EERP NERP Active only in con nection with sfs 4 OFTP 2 0 Possible values Y signed EERP NERP is requested N signed EERP NERP is not requested default GUI name Request Signed
258. tic Start on UNIX Systems By default the shell script RvS HOME bin startServer sh is used for starting the rvsEVO server The RVS_HOME tools scripts Linux and RVS_HOME tools scripts Solaris directories contain scripts that enable the automatic start and stop of rvsEVO together with the operation system In the same directories you can find text files in which the installation steps are described 3 5 Stopping of rvsEVO server Windows Stop rvsEVO by choosing File stop Server inthe menu bar of rvsEVO GUI As an alternative you can also stop rvsEVO at the command prompt by the RVS_HOME bin stopServer bat program Unix Stop rvsEVO by starting the shell script S RVS_HOME bin stop Server sh rvsEVO User Manual Version 6 01 Rev 28 10 15 35 Q T Systems rvs Systems rvsEVO User Manual 36 Graphical User Interface 4 Graphical User Interface 4 1 Introduction By using the GUI Graphical User Interface you don t need a lot of practise for working with rvsEVO The most important functionalities can be executed via the GUI From Version 6 00 upwards rvsEVO provides an upgraded user interface which can be adjusted to your requirements Perspective A Perspective is the active workspace in rvsEVO The following perspec tives are available Transfer Stations Key Management Automation Parameter User Management and Monitoring View Each workspace can be represented in differe
259. tificates SECURITY Via a single click on a parameter group the datailed view of this group is shown on the right side of the window The parameters can be set up in this view 10 2 BASIC parameters In this group the basic setting of rvsEVO can be carried out Parameter for Basic Settings Parameter Description FirstLanguage Language of the Server Possible values de German en English HostAllowFile Configuration file containing DNS names or IP addresses of hosts that may send rvsEVO com mands to the rvsEVO server HostDenyFile Configuration file containing DNS names or IP addresses of hosts that may not send rvsEVO commands to the rvsEVO server RMIServiceHost Host Name in the RMI registry Default 1ocalhost RMI Remote Method Invocation is a protocol for the internal process communication in Java RMIServiceName Name of the rvsEVO service in the RMI registry Default rvsEVO RMiServicePort Port number for the communication in the RMI registry Default 3755 10 3 CENTRAL JOURNAL This group contains the parameters for the feature Central Journal The Central Journal functionality enables the central output of all data of transmitted files 144 Customizing the Global rvsEVO Parameters r A rvsEVO LOC bala File View Window Help E amp 3 Automation E Key Manage
260. tion with OFTP version 2 If your partner does not support OFTP version 2 this field will be ignored rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 83 rvsEVO User Manual Security parameters Parameter Description Security Feature Set This parameter applies to the format of encryp tion According to the selected kind of the encryp tion the groups of available parameters will be activated Following values are possible 1 None no encryption 2 ComSecure V1 3 ComSecure V2 4 OFTP 2 0 CMS rvsEVO supports two formats of encryption ComSecure an appropriate format und CMS based on X 509 certificates CMS format is only in with OFTP version 2 possi ble your partner has to support OFTP version 2 0 too ComSecure V1 means version 1 supported by the ComSecure product versions 1 1 and 1 2 ComSecure V2 means version 2 supported by the ComSecure product version 1 3 V2 is nee ded for the encryption of the files bigger than 4 Gbyte Your partner must support this ComSe cure version too Offline Compression Compression active only in connection with parameter Security Feature Set 2 3 oder 4 If the checkbox is activated Odette compression takes place Encryption File encryption active only in connection with Security Feature Set 2 3 oder 4 If the check box is activated encryption takes place Encryption Algorithm
261. tion ID for which the certificate should be imported the certificate to be imported and a label Press the Import button for importing the certificate Hint The first certificate of a partner station is saved as default certificate by standard This setting can be configured in parameter group Keys of the partner station See chapter 5 3 3 Parameter Groups of the Partner Station for more information Export Right click the certificate in the list view and select Export Certifi cate from the drop down menu for exporting a partner certificate into a file A dialog box opens and you can input the name of the file in which the certificate should be saved Finish the export via a single click on the Save button 8 4 8 Import and Export of a Private Key Pair Import Right click the entry Private Keys in the navigation tree and select Import Private Key from the drop down menu for importing a private key or single click the Import Private Key icon atthe upper right border The following dialog box opens p E Import private key P 3 This dialog is used to import private key Private key e Browse Password J stationID o Label Select the key and the station ID for which the key should be imported The private key can be imported for a local station a virtual station or an internal partner station if using OFTP File Service Module Insert in input field Password the passwo
262. tion estab lishs the connection automatically or not When activating the checkbox the connection to the station is set up automatically if a sendjob is started On the contrary the partner station is to establish the connection and fetch the available files when required The partner bears the costs for the connection rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 65 rvsEVO User Manual The selected network TCP IP TLS ISDN XOT Proxy TCP IP or Proxy TLS In the following tables you can find the explanation of the network parameters TCP IP TSL Proxy TCP IP and Proxy TLS Parameters Partner Parameter IP Address Description IP address or DNS name of the neighbour sta tion Number of Associated Receiver Not active Number for differentiating the various receiving channels through which the local sta tion can be reached Each number has a tab with a set of ISDN parameters rvsEVO automatically assigns and manages this number Default 1 Port Port of neighbour station default 6619 Proxy Bastion for rvs OFTP Proxy only select the Bastion Instance which should be used for communica tion ISDN ters ISDN Parameters Partner In the following table you can find the explanation of the ISDN parame Parameter ISDN Address Description An ISDN number of the partner station ReceiverNumber Not active Number for differe
263. tner stations a I TCP Bp Remark ien TCP 1 mF Stations Recently X 5 TCP 2 v Contact Details Name Stations Recently aca Accessed Enterprise SID Odette ID LOC MOID a sd Tm Save Cancel E Live Monitor Log 23 eu Live Monitor Log 20 Job Date Time Text 2015 07 02 09 34 12 696 L schen von ENDEND FAILED Jobs lter als 150625093412 gestartet 2015 07 02 09 34 17 771 lahliste wird reinitialisiert a r m RDDE9D84 3755 6 01 02 SNAPSHOT 6 30 00 20 01 SE The name of the program is shown on the left hand side in the title bar and on the right hand side you see the minimize maximize and close symbols Thereunder you can find the menu bar which offers the following functionalities File Exit Remote GUI Logout Exit View Selection of perspective Transfer Stations Key Management Automation Parameter User Management Monitoring Window Reset Perspective Close Perspective Open Perspective Show View Help rvsEVO help With a click on one of the right hand buttons in the function bar you can select the perspective The symbols on the left side are described elsewhere 38 Graphical User Interface The middle part is represented in different views In default view on left hand the navigation area is arranged and on right hand you can find the the work area At the bottom of the GUI the log messages are displayed Please see chapter 7 2 Live Monitor L
264. ual OFTP partner station 1 OFTP partner station 2 TLS DMZ Interna OFTP Station A OFTP Paket OFTP Proxy rvsEVO 4 Bastion instance Internal OFTP Station B Firewall Firewall OFTP2 file encryption Proxy listener The connections are received from the external network using Bastion Instance These external connections are forwarded to rvsEVO The other way round rvsEVO uses the bastion instance for establishing a connection to the OFTP station in the external network Communication between rvsEVO and bastion instance is executed exclu sively through the connections built by rvsEVO Communication is rest ricted to one port the configurable RMI port of the bastion instance For being accessible for the external stations one or more Proxy listener are launched by rvsEVO rvsEVO uses this Proxy listener to establish a connection to the partner station Altogether all functional configurations keys and certificates required for TLS communication are stored exclusively in rvsEVO The Bastion Instance is installed with the program rvs OFTP Proxy You can download rvs OFTP Proxy using the following website https servicenet t systems de tsi de 267072 Startseite Business Integration rvs If you cannot download the software please contact your sales partner phone from Germany 0800 664 77 45 phone from other countries 375 606 19 902 E email rvs
265. umentation quartz 2 1 x tutorials crontrigger 10 10 Customizing via rvs system properties File Below you can find the description of the of defintions of rvs system properties file rvs evo jobstarter keep temp files true This definition refers to the jobstarts If the value of Parameter Handling parameter is REPLACE the jobstarter creates temporary files including the job data which substitutes the placeholders of the script You can define whether the temporary files are to be deleted or not Possible values true the files are kept false the files are deleted default rvs evo serviceprovider keep temp files true Via this definition you can define whether temporary files created by the service provider are to be deleted or not Possible values true the files are kept false the files are deleted default 160 Customizing the Global rvsEVO Parameters rvs_evo servicepro vider receive_job process_comsecure false Via this definition you can define whether files encrypted with ComSecure are to be received decrypted and decompressed or encrypted and compressed Possible values true decryption decompression default false no decryption no decompression rvs evo protocol restart fals Via this definition you can define whether a restart flag is to be set up in SSID and the job is restarted true restart flag is set up default false no restart flag rvs evo routed jo
266. umns to be displayed and to minimize or maximize the window The following information are displayed Monitor Log parameters Parameter Description Date Time Date and time of the entry format yyyyMMdd HHmms s 98 Monitoring Monitor Log parameters Parameter Level Description Kind of message Possible values INF Information WRN Warning wichtiger Hinweis ERR ERROR Instance Node Name only important for Muli Instance Functionality Module rvsEVO Modul sender of the message Possible values SRV rvsEVO server CTRL controller NET network OF TP Odette protocol CONF configration P A S ERS persistence CX automatic exchange of certificates P Service Provider OBSR Observer Message Message key Session ID of OFTP session Station SID of neighbour station Job rvsEVO JobID Text Text message from message key GUI or parameter for text message Log file 7 3 Deletion of MonLog Entries from Database If adjustment of MAINTENANCE Parameter MonloglInDatabase v the database table must be cleaned up regularly because otherwise it would fill up Single click the Cleanup Monlog icon in the toolbar to open the dialog window for deletion of MonLog data All entries are deleted wich are older than defined date rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 99
267. up to defined value Text File in format V longer records will be cut up to defined value Binary files The length of all records is the max record size except the length of the last one Binary files in format F If the size of the last record is shorter than the specified one the line will be filled to the defined value rsr Active only in connection with OFTP 2 0 CMS see parameter sfs in this table In OFTP 2 0 there is a possibility to request the signature of the EERP or of the NERP Your partner must support OFTP 2 0 in this case S lt serialize gt The files will be sent in the same order as the send jobs were created The next job will only be sent if the previous is completely finished All send jobs for the serialization must have the same label see parameter l Sd init date gt With this parameter you can define what date the send job should be launched Format lt yyyy mm dd gt sfs lt set id gt Please see parameter Security Feature Set in table Security parameters Possible values 1 None 2 ComSecure V1 3 ComSecure V2 4 OFTP 2 0 CMS With this parameter the send job is created in HOLD status Release please see chapter 12 3 7 releaseJob sif sifcsn serial no File signature only for sfsz4 OFTP 2 0 Certificate serial number for file signature only for sfs 4 sifcin issuer name Certificate issuer
268. use EERP destination and EERP originator in a different way This causes problems with the identification of EERPs Set the parameter rvs evo job additional erp reverse search true in SRVS_HOME conf rvs system properties file to resolve this pro blem Default NORMAL 62 Management of Stations Optional OFTP Parameters Partner Parameter EERP Out lt EERPOut gt Description Procedure for sending receipts EERPs NERPs NORMAL Generation of a receipt after successful file reception and immediate active transmission NEVER no Generation of a receipt The job is changed to ENDED status HOLD Generation of a receipt after successful file reception The receipt however is only sent after having been released with the handleEERP pro gram SYNC The OFTP session between sender sta tion and receiver station will be kept alive waiting for an EERP that should come from the receiver station ROUTING SYNC Hint This parameter is important only for a routing station The OFTP session between the router station and the sen der station will be kept alive waiting for an EERP that should come from the receiver station When the EERP is arrived it will be sent in the same session to the sender Default NORMAL see also parameter End to End Response in Exchange Buffer Credit Credit Maximal number of sent blocks Exchange Buf fer without an acknowled
269. vailable if parameter File Service Proxy EXTERNAL Please see table Security parameters on page 84 for detailed explanation Compression lt Compression gt Encryption lt Encryption gt Send parameter on station level Only available if parameter File Service Proxy EXTERNAL Please see table Security parameters on page 84 for detailed explanation Send parameter on station level Only available if parameter File Service Proxy EXTERNAL Please see table Security parameters on page 84 for detailed explanation File Signature Send parameter on station level Only available if lt Sign gt parameter File Service Proxy EXTERNAL Please see table Security parameters on page 84 for detailed explanation ERP Signature Send parameter on station level Only available if lt SignERP gt parameter File Service Proxy EXTERNAL Please see table Security parameters on page 84 for detailed explanation Encryption Algorithm lt EncryptionAlgorithm gt Send parameter on station level Only available if parameter File Service Proxy EXTERNAL Please see table Security parameters on page 84 for detailed explanation Line Type The only parameters in this group are Parallel Session and Active Connection In Parallel Session you indicate the max Number of Sessions to this station at the same time In Active Connection parameter you define if your local sta
270. ve the received file in another directory than Inbox directory New Filename With this parameter you can save the received file with another name VDSN is used by deault Timestamp is added like defined in TimeStamp parameter rvsEVO User Manual Version 6 01 Rev 28 10 15 Q T Systems rvs Systems 127 rvsEVO User Manual Jobfilter elements Parameter Parameter Handling Description With this parameter you can decide how to trans mit the job data to the process Possible values ARGS job data are passed as arguments default ENV job data are set as environment variables REPLACE for compatibility with rvs portable For further information see chapter Parameter Handling on page 130 Process Program to be started when all filter conditions apply Parameters seperated by spaces can be passed to the program The following must be noted Terms with blanc should be placed in quotation marks By using cmd indicate cmd exe only with the script name If Parameter Handling is ARGs indicate the user parameters first and thereafter the system parameters With Linux shells the parameters are passed without quotation marks with Windows the para meters are passed with quoations marks A defined set of the following job parameters is passed to the programs 1 Jobld 2 Station ID of sender or recipient 3 File name of the file sent or receiv
271. verNumber gt Description Number for differentiating the various receiving channels through which the local station can be reached Each number has a tab with a set of TCP IP parameters rvsEVO automatically assigns and manages this number Default 1 Enabled This parameter defines whether or not the TLS lt enabled gt listener is enabled or disabled Default disabled IP Address IP address or DNS name of the own station If lt IPAddress gt you own station has only one IP address you can left this field empty Proxy Bastion Port lt Port gt Only for Proxy TCP IP you can select the Bastion from a list of the Bastion instances crea ted in rvsEVO in which the receiver listener should be started Port on which a TCP IP listener is to be started 3305 by default Max Incomming Sessi ons Maximal number of simultaneously active receipt processes on the same channel Sessions Maximum 100 Time Out Time Out in miliseconds after which the commu lt TimeOut gt nication program the connection closes if the partner station does not answer Default 30 0 means that the default value is used Client Authentication lt ClientAuthentication gt Sometimes is for the TLS connection necessary that a client in this case a partner from whom you receive data should be authenticated With this parameter you can choose if this is NEEDED NONE no authentication or WANTED
272. versionTable path to conversion table creationDate Date and time from SFID of creating a dispatch order in the form DD MM YY HH MM SS deleteAllowed If deleteAllowed t rue deleting a job is allowed dependent on its status Possible values true Yes or false No Default false 182 Command Line Tools Explanation of the job attributes Parameter Description direction Direction possible values SND sending or RCV receiving dispositiion Whereabouts This parameter decides whether the file to be sent remains as it is or is deleted locally after sending Possible values K Keep File remains as it is after sending encryption Encoding possible values true yes or false no Default false encryptionAlgorithm Encoding algorithm possible values blank no algorithm DES EDES3 CBC 3DES or AES256_CBC encryptionCertificatels suerName Publisher name of the certificate A value is displayed if a certificate is indicated for use explicit It is not displayed which certificate is used in fact encryptionCertificateSe rialNumber Serial number of the certificate A value is displayed if a certificate is indicated for use explicit It is not displayed which certificate is used in fact errorlD If the error type is transmission these error codes are identical with the ones from ESID EFNA SFNA of the Odette log errorText If th
273. vidual sta tion in case of the partner are replaced and can celled S lt stationID gt StationID of the own station whose certificate should be sent and replaced Optional Parameters Parameter i lt keyIndex gt Description Index of the certificate which should be sent and replaced If this parameter is not sent all the available certificates are sent Finally in case of the partner allthe old certificates are replaced by new ones You find the index in the list view and detailed view of a certificate verbose Verbose message output help Displays a description of the current command Requests help information rvsEVO User Manual Version 6 01 Rev 28 10 15 T Systems rvs Systems 195 rvsEVO User Manual Optional Remote Parameters Parameter Description su lt user gt Client user for remote login Sp lt password gt Password of the client sh lt host port gt host is the IP address or hostname of rvsEVO Server port is the port of rvsEVO Server 12 10 4 exportCertificate2ComSecure Use this tool to export a public key from rvsEVO database to ComSecure Syntax exportCertificate2ComSecure sid StationID ki lt keyIndex gt cf lt certificateFilename gt help Required Parameter Parameter Description sid lt StationID gt ID of the station whose certificate is to be expor
274. w Help i Automation i Key Manage E Monitorin Parameter mfl Stations Transfer User M i ey g g m Monitor Tree View 23 amp Gi E Monitor Log Fi Monitor Tree View Monitor Log File monitor log Z5 Live Monitor Log Z Monitor Log Files monitor log monitor log 2013 12 monitor log 2013 12 1 monitor log 2013 12 1 monitor log 2013 12 1 monitor log 2014 01 monitor log 2014 01 monitor log 2014 02 C monitor log 2014 02 Instance Date Time Level Module Message rvsEVO 20140219 1111 WRN CTRL SENDJOURNALINTER AT D Active RDDE9D84 3755 6 00 02 SNAPSH 17 00 43 52 SE Text View The text view provides the text retrieval You can open the search assistent via the Find symbol loupe at the top of the view or via hot key Ctrl F Via hot key Ctrl A the whole list can be selected and via hot key Ctrl C you can copy the selected section into the clipboard This functions are also executable via a right click in the view and subsequent selection of Select All respectively Copy from the drop down menu Hint Please see chapter 12 12 Display Monitor Messages in order to find out how to display log messages via commad line tool 7 6 Active Panel This tool gives you the additional details of the status of an active transfer 102 Monitoring A mouse click on the Active Panel entryinthe Monitor Tree View op
275. ys to delete a jobstart Either by opening the detailed view of the jobstart and thereafter clicking on Delete button or by right clicking the jobstart in the list and thereafter selecting Delete Jobstart or pressing the delete icon at the top right edge To delete several jobstart select the jobstarts to be deleted while keeping the ctrl button pressed and select the jobstarts to be deleted with a left mouse click Thereafter rvsEVO User Manual Version 6 01 Rev 28 10 15 135 Q T Systems rvs Systems rvsEVO User Manual you can delete the jobstarts via a right click or via the icon at the top right edge 9 3 Observer The feature Observer generates send entries for files which are in a configurated directory The observer checks in regular time intervals a directory for the specified file names mask If such files are found the send entry will be created The options for send entry can be configu rated too It is similar to the feature vs js in rvs portable 9 3 1 Create an Observer Instruction for entering the parameter values If the input field includes a drop down arrow you must select one of the specified values from the combobox In input fields without a drop down arrow you must directly write the value into the input field Exeption Station IDs can be written into the input feld or selected from the combobox A checkbox is to be enabled or disabled by single click in the checkbox To create an Observer

rvsEVO - ServiceNet - T

Contents

Download Pdf Manuals

Related Search

Related Contents