mmflynn

Jaspersoft BI for Amazon Web Services requires very little systems management. Despite its greatly reduced need for administrative intervention, on occasion you may need to connect to the server's file system to retrieve log files, upload licenses, edit configuration files, or run commands from a console interface. There are a variety of utilities you can use to accomplish these tasks. This article demonstrates file transfer using a third-party utility for Microsoft Windows called WinSCP. Command line interactions are shown using the AWS console "Connect from your browser" feature. These two utilities were chosen because they are the easy to explain and use for their use cases. You may be familiar with and prefer other methods, such as PuTTY, ssh command line utilities, and so on. File TransferThis section demonstrates an easy way to move files back and forth between the Linux server running JasperReports Server on AWS and your local computer. (Note: The client computer for this example runs Microsoft Windows.) File transfer use cases include: Uploading a Jaspersoft license file from your local computer to JasperReports ServerDownloading log files for troubleshootingUploading database drivers, custom data source files, and so onRequirementsThe public IP address or hostname of the AWS server instance running JasperReports ServerThe Public key name associated with the server instanceThe path to the Private key file that works with the Public key mentioned aboveA file transfer utility such as WinSCPImportant: If using WinSCP, the Private key file must be converted to the .ppk file format. Use the Puttygen "import key" utility to convert from .pem to .ppk file formats. See Dealing with Private Keys in Other Formats for more information.Login username: ec2-userSteps to Transfer FilesRun the WinSCP application from the Windows Start menu.Click New. Use the following values:Host Name (or IP address)Port number: 22User name: ec2-userPassword: leave blankPrivate key file: navigate to the Private key fileProtocol: SFTPClick Save. The default session name will follow the standard user@host, e.g., ec2-user@bdsandbox7. You can change it if you want. Click OK.Click Login to connect. Your local file system appears in the left panel and the remote AWS computer appears in the right. You can now easily copy files back and forth between systems. WinSCP ExtrasEditing Files with WinSCPYou can double-click and edit text files directly from the WinSCP interface. A copy of the file will be downloaded and opened in a text editor. When you save the file, it will be copied back to the server. Command Line Interactions with WinSCPWinSCP includes a Commands menu. From it you can click Open Terminal, which allows you to run a single command at a time, or Open in PuTTY, which opens a full command line console if you have PuTTY installed. Command Line InteractionsThe AWS console provides a command line utility that runs in a Java-enabled Web browser window. It is documented on the AWS web site. Command line interactions use cases include: Starting, stopping, restarting or checking the status of JasperReports ServerRunning any Linux commandRequirementsAccess to the AWS ConsoleThe path to the Private key file that works with the Public key used by your server instanceSteps to Open a Command Line Window from the AWS ConsoleLogin to the AWS console, e.g.: https://<yourOrganization>.signin.aws.amazon.com/console From the AWS Console Home page, click EC2Click Instances from the side bar or Running Instances from the top level summaryLocate your instance and right-click itFrom the Instance Management pop-up menu, click ConnectThe Public DNS and Private Key name will be entered for you. Complete the following:User name: ec2-userPrivate key path: enter the path to the Private key file that works with the Public Key named on-screen.Click Launch SSH ClientWhen prompted to run the application named com.mindbright.application.MindTerm, click RunIf prompted to add the server's fingerprint to the cache, click YesYou can now run any Linux commandFor More InformationAWS Documentation: Getting a Key Pair AWS Documentation: Getting Started with Amazon EC2 Linux Instances, Step 3: Connect to Your InstanceJaspersoft Community Article: How to Produce Clean Log Files for TroubleshootingJaspersoft Community Article: Applying Your Jaspersoft Product License(s)