Auto UploadToolV8 4 Inst
Auto UploadToolV8 4 Inst
Auto UploadToolV8 4 Inst
Installation Guide
Version Number: V8.4
November 2013
Copyright (c) 2009-2012 by Aspen Technology, Inc. All rights reserved.
Auto Upload Tool, aspenONE, SLM™, SLM Commute™, SLM Config Wizard™, the aspen leaf logo and Plantelligence
and Enterprise Optimization are trademarks or registered trademarks of Aspen Technology, Inc., Burlington, MA.
All other brand and product names are trademarks or registered trademarks of their respective companies.
This document is intended as a guide to using AspenTech's software. This documentation contains AspenTech
proprietary and confidential information and may not be disclosed, used, or copied without the prior consent of
AspenTech or as set forth in the applicable license agreement. Users are solely responsible for the proper use of
the software and the application of the results obtained.
Although AspenTech has tested the software and reviewed the documentation, the sole warranty for the software
may be found in the applicable license agreement between AspenTech and the user. ASPENTECH MAKES NO
WARRANTY OR REPRESENTATION, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO THIS DOCUMENTATION,
ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
Contents i
5 Troubleshooting .................................................................................................29
Purpose ........................................................................................................ 29
ii Contents
1 Introduction
Purpose
This document describes how to install and configure the Auto Upload Tool to
transmit usage log files to AspenTech.
Overview
The Auto Upload Tool, a feature offered through the Aspen Licensing Center,
lets you systematically transmit usage log files to AspenTech, either by secure
http, secure ftp transmission, or as an attachment to an email sent to the ALC
mailbox. You can select the secure method that best meets your needs.
The Auto Upload Tool can be easily scheduled to transmit usage logs to
AspenTech in intervals of either weekly or monthly. The Upload Tool can mask
user information to meet privacy regulations. Auto Upload Tool (AUT)
provides a mechanism to collect usage logs from SLM servers running behind
a firewall (such as a process control network) onto a central collection server
and eventually send them to AspenTech. This collection server approach lets
you auto upload usage log files to a Network Share, or HTTP Server, on
another server on your network. This is a useful alternative if your company
policy prohibits outgoing traffic from your SLM server or if your SLM server is
behind a firewall.
1 Introduction 1
Life Cycle of a Log File
Related Documentation
Refer to the following Knowledge Based Solutions found on AspenTech
Customer Support website:
ALC Overview
http://support.aspentech.com/webteamcgi/SolutionDisplay_view.cgi
?key=125809
Log File Upload Changes to the Aspen Licensing Center and the SLM
Reporter
http://support.aspentech.com/webteamcgi/SolutionDisplay_view.cgi
?key=126947
Auto Upload Tool Install Kit, Tutorial, and Install Guide
http://support.aspentech.com/webteamcgi/SolutionDisplay_view.cgi
?key=124560
What are the steps for extracting usage log files from the SLM server?
http://support.aspentech.com/webteamcgi/SolutionDisplay_view.cgi
?key=126066
What are the infrastructure requirements to transfer logs files to
AspenTech via SFTP?
http://support.aspentech.com/webteamcgi/SolutionDisplay_view.cgi
?key=126943
2 1 Introduction
Technical Support
AspenTech customers with a valid license and software maintenance
agreement can register to access the online AspenTech Support Center at:
http://support.aspentech.com.
This Web support site allows you to:
Access current product documentation
Search for tech tips, solutions and frequently asked questions (FAQs)
Search for and download application examples
Search for and download service packs and product updates
Submit and track technical issues
Send suggestions
Report product defects
Review lists of known deficiencies and defects
Registered users can also subscribe to our Technical Support e-Bulletins.
These e-Bulletins are used to alert users to important technical support
information such as:
Technical advisories
Product updates and releases
Customer support is also available by phone, fax, and email.
Note: The most up-to-date information on the Auto Upload Tool is available
from the AspenTech Customer Care Center at [email protected].
1 Introduction 3
4 1 Introduction
2 Installing the Auto Upload
Tool
Purpose
This chapter describes how to download and install the Auto Upload Tool.
Notes: The installer can optionally install HTTP Server. This option lets you
collect log files from other SLM Servers (with no access to Internet or email)
sitting behind a firewall. This option requires IIS to be available on this
computer. The Upload Tool will pick up files deposited on the collection server
and transmit them to AspenTech through HTTPS, SFTP, or email option. The
HTTP option collects logs internally within your network from other servers,
and the HTTPS option transmits them back to AspenTech.
Installing
1 Click Install Now.
The Installation Progress window appears.
2 Toward the end of the install, the installer will automatically launch the
AUT Configuration Tool. You can configure the settings now, or click
Cancel to configure it later after the install is complete. Refer to Chapter
3, “Post Installation Configuration,” on page 13 for additional details
on how to launch and configure the AUT Configuration Tool.
Purpose
This chapter describes the post-installation steps required to configure the
Auto Upload Tool to transmit usage log files to AspenTech.
Overview
You can configure the Auto Upload Tool to perform the following tasks:
Easily transmit usage logs to AspenTech via HTTP, SFTP, or Email
Auto-schedule usage log file transmissions either weekly or monthly
Mask user names, machine IDs, and IP addresses with mapping file
retained on your SLM server
Activate usage logging if not already enabled
Create an archive directory to store transmitted usage log files on your
SLM server
Note: Per Day and Immediately transmission intervals are included for
testing and/or troubleshooting.
Notes:
The log file transmitted to AspenTech will display user1, machine1 or IP1,
IP2, IP3, instead of the actual IDs.
The usermap file holds the actual user/machine and IP address to the
mapped name. The mapping file is never sent to AspenTech.
1 In the Import User Account section’s Account path dialog box, browse
to the location of the encryption keys obtained from AspenTech.
User name is automatically filled in by the Auto Upload Tool by reading
the .acc file.
2 The AspenTech SFTP field is preconfigured with AspenTech’s secure FTP
server. It should point to alcftp.aspentech.com.
3 Make sure that port 22 is open and AspenTech SFTP server is accessible.
Run the following command from a DOS window to verify this:
telnet alcftp.aspentech.com 22
If the port is accessible, you will see the following prompt in DOS window:
SSH-2.0-OpenSSH_3.8.1p1
If the above prompt does not appear, you may need to get your port 22
open to AspenTech server. Please work with your IS team to have port 22
open to alcftp.aspentech.com. This is an outbound connection.
4 Click the Test Connection button.
1 Type your email server and port in the Your Email Server section.
2 Type the SLM server admin’s email id (for example:
[email protected])
3 Type the User Name of the SLM Server Administrator. Make sure to type
valid information here.
4 Type the password.
5 The AspenTech email account information is preconfigured. It should point
to [email protected].
6 Be sure to test the connection by clicking Test Connection.
Client Mode
The Client mode is activated when you select “Collection Server” option in the
General tab. In this mode, AUT transfers the log files from this server to the
server specified in the “Collection Server” tab. AUT should be installed and
configured on the Collection Server (for example: MyCollectionServer or
MyHttpServerName). AUT uses HTTPS, SFTP or Email option to send the
collected log files to AspenTech.
Network Share
If you have selected the Network Share option, perform the following tasks:
1 Specify the Shared folder location, and a user name password with read-
write access privilege to the shared folder on the Collection Server.
2 Click the Test Connection button to validate the information you
provided.
Network Share
Select this option to share a folder on this machine, so that AUT on other SLM
Servers can deposit files into this shared folder.
Specify a local directory location and click Share. This will open up a regular
folder share dialog box. Share the folder and click permissions to grant the
required users read/write permissions to the required set of users.
HTTP Server
The HTTP Server option is enabled only if HTTP Server feature has been
installed from the AUT installer. The Server Mode is automatically activated if
you select either HTTPS, SFTP or Email option on the General tab.
Note: The “HTTP Server” feature requires IIS be installed on the Collection
Server. In addition, it also requires the HTTP Activation and Non-HTTP
Activation features of Microsoft .NET Framework 3.0. AUT installer will check
for these dependencies if you select HTTP Server feature.
Purpose
This chapter describes how to upgrade the Auto Upload Tool to transmit
usage log files to AspenTech.
Purpose
This chapter describes troubleshooting information for the Auto Upload Tool.
5 Troubleshooting 29
Is Active Directory required to use the Auto Upload Tool?
Windows Server Active Directory is not required.
Notes:
No messages will be displayed by the Auto Upload Tool. We suggest the
“Failed Upload” folder be checked periodically.
It is recommended that the EMail tab is configured correctly along with
the valid “Admin email address” on the General tab, irrespective of the
transfer method you select. This will enable the AUT to notify you in case
of a file transmission failure.
30 5 Troubleshooting