MOVEit Automation Web Admin Help

MOVEit Automation Web Admin Help

Copyright

?1991-2017 Ipswitch, Inc. All rights reserved.

This document, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by such license, no part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the express prior written consent of Ipswitch, Inc.

The content of this document is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Ipswitch, Inc. While every effort has been made to assure the accuracy of the information contained herein, Ipswitch, Inc. assumes no responsibility for errors or omissions. Ipswitch, Inc., also assumes no liability for damages resulting from the use of the information contained in this document.

WS_FTP, the WS_FTP logos, Ipswitch, and the Ipswitch logo, MOVEit and the MOVEit logo, MessageWay and the MessageWay logo are trademarks of Ipswitch, Inc. Other products and their brands or company names, are or may be trademarks or registered trademarks, and are the property of their respective companies.

This document was published on Friday, October 27, 2017 at 15:33.

i

Contents

Introduction

1

Overview......................................................................................................................................................................1 Key Features ................................................................................................................................................................3

Conventions used in this documentation ...................................................................................................................8 Cueing graphics...............................................................................................................................................8 Icon updates.....................................................................................................................................................8

Web Admin - Overview

8

Web Admin Tour.........................................................................................................................................................9 Individual Task - Quick Tour...................................................................................................................................11 Searching, Filtering, and Sorting..............................................................................................................................12

Searching........................................................................................................................................................12 Filtering ..........................................................................................................................................................13 Sorting ............................................................................................................................................................15 Common Activities....................................................................................................................................................17 Features Included in Web Admin.............................................................................................................................19

Edit User Preferences

19

Controlling Access to MOVEit Automation

20

HOSTS

20

Hosts key features......................................................................................................................................................21 Supported Host Types...............................................................................................................................................23

Configure a Proxy Server..........................................................................................................................................24 Tests Performed on Hosts.........................................................................................................................................24 Enabling File Notifications.......................................................................................................................................25

How File Notifications Work .......................................................................................................................26 File Notifications and Task Schedules.........................................................................................................27

TASKS

27

Task List.....................................................................................................................................................................29 Task Schedule Status.....................................................................................................................................30

Add Task....................................................................................................................................................................31 Add a New Task............................................................................................................................................31 Import Task....................................................................................................................................................50

Task Elements............................................................................................................................................................53 Add a Task Source.........................................................................................................................................53 Add a Task Process .......................................................................................................................................71 Add a Task Destination.................................................................................................................................72 Add a File Loop (FOR).................................................................................................................................80 Add Conditional Branch (IF block)..............................................................................................................81

ii

Contents

Add a Send Email Step (advanced task)......................................................................................................82 Add a Run Task Step.....................................................................................................................................83 Next Action - Send Email .............................................................................................................................83 Next Action - Run Task................................................................................................................................84 Add/Edit Task Schedule................................................................................................................................85 This Script Behaves As A Destination.........................................................................................................89 Add/Edit a Date List......................................................................................................................................89 Move a Task Element....................................................................................................................................90 Update Original (rename or delete)..............................................................................................................90 Multiple Sources, Destinations, Processes, and Schedules.........................................................................91 Task Settings and Parameters...................................................................................................................................91 Edit Task Info - General................................................................................................................................91 Task Settings - Advanced Info .....................................................................................................................92 Task Settings - Sync Info..............................................................................................................................93 Task Settings - Parameters Info....................................................................................................................94 Add Task Parameter......................................................................................................................................94 Task Actions ..............................................................................................................................................................95 Run Task........................................................................................................................................................96 Clone Task.....................................................................................................................................................96 Delete Task....................................................................................................................................................97 Export Task....................................................................................................................................................97 Edit Task Transfer Exceptions......................................................................................................................98 Create Advanced Task from a Traditional Task..........................................................................................99 Editing Source Timestamps..........................................................................................................................99 Bulk Actions ............................................................................................................................................................100 Create a Task Group....................................................................................................................................101 Edit a Task Group........................................................................................................................................101 Enable Tasks................................................................................................................................................102 Disable Tasks...............................................................................................................................................102 Export Tasks ................................................................................................................................................103 Delete Tasks.................................................................................................................................................103

SCRIPTS

103

Types of Built-in Scripts.........................................................................................................................................104 Process Scripts.............................................................................................................................................104 Process Scripts for PGP Files .....................................................................................................................106

Built-in Scripts by Script Name..............................................................................................................................106 Certs Backup................................................................................................................................................107 Certs Restore................................................................................................................................................107 Command Line App....................................................................................................................................108 Find Or Replace...........................................................................................................................................111 Header ID.....................................................................................................................................................113 HTTP Get.....................................................................................................................................................114 HTTP Post....................................................................................................................................................114 HTTP Put .....................................................................................................................................................115 HTTP SharePoint Get..................................................................................................................................116 HTTP SharePoint Put..................................................................................................................................116 Ignore All Files............................................................................................................................................117 Look Up .......................................................................................................................................................117 MessageWay Translation............................................................................................................................123 No Op...........................................................................................................................................................125 PGP Decrypt ................................................................................................................................................126 PGP Encrypt and Sign.................................................................................................................................126

Contents

iii

PGP Encrypt Only.......................................................................................................................................127 Prepend Lines ..............................................................................................................................................127 Report Long Running Tasks.......................................................................................................................128

Set Destination.............................................................................................................................................129 Sleep .............................................................................................................................................................130 SMIME Receive..........................................................................................................................................131

SMIME Send ...............................................................................................................................................132 Tamper Detect .............................................................................................................................................132

Trim Statistics DB.......................................................................................................................................133 Unzip Advanced ..........................................................................................................................................134 XSL Transform............................................................................................................................................135

Zip Advanced...............................................................................................................................................136 Cus tom Scripts.........................................................................................................................................................137

Add New Script ...........................................................................................................................................139

Syntax - Custom Scripts..............................................................................................................................140 Cus tom Script Samples ...............................................................................................................................147

REPORTS

149

Task Run ..................................................................................................................................................................149 File Activity.............................................................................................................................................................151

Cus tom Duration......................................................................................................................................................152 Audit.........................................................................................................................................................................152

SETTINGS

154

System Settings........................................................................................................................................................154 Task Groups.............................................................................................................................................................155

Add/Edit Task Group ..................................................................................................................................156 Date Lists .................................................................................................................................................................157 Keys and Certs.........................................................................................................................................................157

About SSL Client Certificates ....................................................................................................................158 About SSH Client Certificates....................................................................................................................160 About PGP Keys..........................................................................................................................................163 Global Parameters ...................................................................................................................................................172 Add/Edit Global Parameter.........................................................................................................................173 Global Parameters and Error Reporting using Next Action .....................................................................174

iv

Contents

COMMANDS

174

Macros

176

Macro Keywords .....................................................................................................................................................178 Macro Date and Time Syntax.................................................................................................................................182 Macro Functions......................................................................................................................................................184

Common Applications

184

Trigger Files.............................................................................................................................................................185 "Last Day Of Month" Schedules ............................................................................................................................189 Converting EBCDIC Te xt to ASCII Text..............................................................................................................191

HTTP Uploads and Downloads..............................................................................................................................193 MessageWay Translation........................................................................................................................................193

Task that Runs a Translation ......................................................................................................................194 Sample Task.................................................................................................................................................194

S/MIME Email

199

Overview..................................................................................................................................................................200 Configuring Certificates..........................................................................................................................................201 Sending and Receiving............................................................................................................................................201

AS1, AS2, AS3

202

Overview..................................................................................................................................................................203 AS1, AS2 and AS3......................................................................................................................................204 Identifying My Organization and a Partner...............................................................................................207 Optional Elements .......................................................................................................................................208 Limitations of the ASx Protocols ...............................................................................................................208

The AS1 Protocol....................................................................................................................................................209 How an AS1 File Transfer Works..............................................................................................................210 MOVEit Implementation of AS1...............................................................................................................212 Advantages/Disadvantages of AS1 (Compared to AS2 and AS3)...........................................................213

The AS2 Protocol....................................................................................................................................................215 How an AS2 File Transfer Works..............................................................................................................216 MOVEit Implementation of AS2...............................................................................................................220 Advantages/Disadvantages of AS2 (Compared to AS1 and AS3)...........................................................222

The AS3 Protocol....................................................................................................................................................223 How an AS3 File Transfer Works..............................................................................................................223 MOVEit Implementation of AS3...............................................................................................................225 Advantages/Disadvantages of AS3 (Compared to AS1 and AS2)...........................................................227

MOVEit Implementation ........................................................................................................................................228 Drummond "eBusinessReady" Certification .............................................................................................229 Why MOVEit Transfer is best choice for AS3..........................................................................................229 Advantages of a MOVEit Implementation ................................................................................................230 Limitations of the MOVEit Implementation .............................................................................................230

About Certificates....................................................................................................................................................231 Where to Configure Certificates.................................................................................................................232

Contents

v

Configuring AS1, AS2, and AS3 Hosts.................................................................................................................233 The Role of MOVEit Transfer in in AS2 File Transfers ......................................................................................233 AS2 Server URL and MOVEit Transfer File Specifics........................................................................................234 Troubleshooting.......................................................................................................................................................235 The Role of MOVEit Transfer in AS3 File Transfers...........................................................................................238 ASx Source and Desitnation Options.....................................................................................................................238

AS1 - Source and Destination.....................................................................................................................239 AS2 - Source and Destination.....................................................................................................................240 AS3 - Source and Destination.....................................................................................................................242

Advanced Topics

243

FTP Source Integrity...............................................................................................................................................244 Cus tom Directory Parsing.......................................................................................................................................245

Column-based Custom Parsing ..................................................................................................................246 Directory Parsing Script..............................................................................................................................247 SysLog and SNMP..................................................................................................................................................251 Syslog Utilities.............................................................................................................................................252 SNMP...........................................................................................................................................................253 Antivirus...................................................................................................................................................................254 POP3 Sources ..........................................................................................................................................................255 GetMICConfig Utility.............................................................................................................................................256 Port Numbers...........................................................................................................................................................257 System Internals ......................................................................................................................................................260 MOVEit Automation Error Codes..........................................................................................................................265 Local Mail Relay .....................................................................................................................................................270 Ins tru ctions...................................................................................................................................................271 Troubleshooting...........................................................................................................................................278 MessageWay CLI ....................................................................................................................................................278 Program Arguments ....................................................................................................................................279 Input File......................................................................................................................................................280 Output File...................................................................................................................................................283 Return Code.................................................................................................................................................285 Databas e...................................................................................................................................................................285 Schema .........................................................................................................................................................286 MySQL.........................................................................................................................................................291 MSSQL ........................................................................................................................................................294 Converter......................................................................................................................................................299 Tamper Detection........................................................................................................................................301 Trimming .....................................................................................................................................................301 Troubleshooting...........................................................................................................................................302

Reference

304

Supported Host Types.............................................................................................................................................304 Local File System Hos t Field Descriptions ...............................................................................................305 Windows UNC Share Field Descriptions ..................................................................................................309

MOVEit Transfer Host................................................................................................................................313 FTP Host Field Descriptions.......................................................................................................................316 SSH/SFTP Host Field Descriptions ...........................................................................................................325

POP3 (Incoming Email) Host Field Descriptions.....................................................................................331 SMTP (Outgoing Email) Host Field Descriptions ....................................................................................333

AS1 Host Field Descriptions ......................................................................................................................335 AS2 Host Field Descriptions ......................................................................................................................338

vi

Contents

AS3 Host Field Descriptions ......................................................................................................................341 System Settings........................................................................................................................................................345

Debug Log Settings.....................................................................................................................................345

Audit Log Settings.......................................................................................................................................346 Windows Event Log Settings .....................................................................................................................346 ASx Log Settings.........................................................................................................................................347

System-Wide Task Settings........................................................................................................................347 State File Settings........................................................................................................................................348

Tamper Detection Settings..........................................................................................................................349 Tamper Detection Settings..........................................................................................................................349

MOVEit Automation Service

349

Overview..................................................................................................................................................................349 Starting and Stopping..................................................................................................................................350 Firewall Considerations ..............................................................................................................................351

Running As..............................................................................................................................................................351 Recommended Configuration: Running As a Service Under a Specific Windows Administrator........352 Converting From MOVEit Automation as a Local System Service........................................................352 Running MOVEit Automation in the Foreground, Not As a Service......................................................353 Additional Considerations ..........................................................................................................................354

MOVEit Automation Config Utility ......................................................................................................................354 General Tab..................................................................................................................................................355 License Tab..................................................................................................................................................356 Database Tab................................................................................................................................................357 Errors Tab ....................................................................................................................................................358 Failover Tab (Enterprise Only)...................................................................................................................358 Virus Tab......................................................................................................................................................361 Tamper Tab..................................................................................................................................................362 SSL Tab........................................................................................................................................................363 Selecting SSL Encryption Methods ...........................................................................................................364 Selecting SSL Versions...............................................................................................................................364 How to Test SSL Changes..........................................................................................................................364 About Tab ....................................................................................................................................................366

Proxy Servers...........................................................................................................................................................367 No Proxy Server..........................................................................................................................................367 Proxy Server, No Authentication Required ...............................................................................................367 Proxy Server with "Windows Integrated" NTLM Authentication...........................................................367 Proxy Server Settings on Non-MOVEit Hosts..........................................................................................368

Backup......................................................................................................................................................................368 Disaster Recovery........................................................................................................................................369 Automated Configuration Replication.......................................................................................................370

Failover (Enterprise Only)......................................................................................................................................372 Overview......................................................................................................................................................373 Ins tallation....................................................................................................................................................377 Admin Failover Tab ....................................................................................................................................381 Common Procedures ...................................................................................................................................382 FTP Failover................................................................................................................................................384

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download