These instructions are for new installs of Presto 3.8x only. If you are upgrading Presto from an earlier releaselog into myBCDSoftware.com to view the Upgrader's Guide. For additional product information, go to the Presto home page at this site.
Step 1. Download Presto and Transfer the IBM i Install Files.
Follow these steps to download the installation files and transfer the server component to your IBM i.
1, Download Presto
Before you can install Presto you need to contact our Sales office or fill out the Presto Trial Request form at our website. We will then send you download links and instructions, and a trial period license key.
Download the server and PC installation files and save them to your PC.
2. Upload the Installation Files to your IBM i
When the downloads finish double-click the IBM i install executable file prestoserver-3.8.exe [the version may vary] to unpack the files and begin transferring them to your IBM i.
When the window below appears, enter your IBM i IP address or domain and user profile/password:
Click the Upload button. When the upload finishes the activity log displays the message ‘File upload complete’. You can then close the BCD Upload Express window and continue with the next step.
Step 2. Install the Presto IBM i Components.
Follow the instructions below to install the Presto IBM i components.
1. Log on to an IBM i session as QSECOFR and execute the command XL_PRESTOI/BCDINSTALL.
zzz
The default product library (or environment) name is XL_PRESTO. If for some reason this library already exists, the install will prompt you for a library name.
2. When prompted, enter the license key provided to you.
Note: If you are installing Presto for the first time you can enter the license key during the install (the recommended option) or afterwards using the UNLOCK command. The UNLOCK command is in library XL_PRESTO (or your own environment name).
3. When you press Enter the install will continue restoring the rest of the required objects.
When the IBM i installation finishes continue with the next step.
Step 3. Set your CCSID in the HTTP Server Configuration
This step is only relevant if your system has a CCSID other than 37. For a CCSID of 37 (United States/North America) the default configuration will work for you.
Verify your system CCSID by running the command DSPSYSVAL SYSVAL(QCHRID). If the value displayed for the Code Page is 37, you can continue with the next step. Otherwise this will be the value you will use in your Exodus51 configuration for the DefaultFSCCSID, as described below.
If you aren’t sure where or how to make the changes below, review the User Guide section “More About the Presto IBM HTTP Server (Powered by Apache) Instance”
.
1. Change the DefaultFSCCSID value.
Go to your configuration and find this line:
DefaultFsCCSID 00037
Change it to:
DefaultFsCCSID 00xxx
Replace xxx with your system’s CCSID.
2. Restart the Apache instance.
3. After making the change above, end and restart the Apache HTTP server instance (see the next step for details).
Step 4. Start the Presto HTTP Server.
The server side installation created a new Apache HTTP server instance with the same name as your library. The last screen of the server install confirms these details for you and provides instructions for starting that HTTP server instance.
All new instances are set to run on port 8022 by default. If you are installing multiple versions of Presto you need to make sure each HTTP server instance is referencing a unique port number before starting it.
To start your Presto server instance (XL_PRESTO, for example) run this command:
STRTCPSVR SERVER(*HTTP) HTTPSVR(XL_PRESTO)
After a few seconds, you can confirm that the HTTP server was started by running this command:
WRKSBSJOB SBS(QHTTPSVR)
You should see several jobs named XL_PRESTO (or your selected environment name) in the QHTTPSVR subsystem.
Starting the XL_PRESTO Apache HTTP Server Instance After an IPL
If you IPL your IBM i nightly or on the weekends you need to restart your XL_PRESTO Apache HTTP server instance afterward.
During your evaluation period you may elect to do this manually before you start working with the tool. If you purchase the software you should add this step to your startup procedures. You can find further information on this in KB Article 8816 .
Step 5. Start the EXODUS51 Subsystem.
Presto uses the EXODUS51 subsystem to manage transferring data between the PC designer and the IBM i.
When the server side installation finishes use the WRKACTJOB command to check if the EXODUS51 subsystem has been started. If this is a new install, it should be started automatically.
If this is a second install, or you already have another BCD tool installed on your system that uses EXODUS51, the install will not start the subsystem automatically. In this case you can start the subsystem at this point using this command:
STRSBS XL_EX51/EXODUS51
Once the subsystem has been started continue to the next step.
Starting the Exodus51 Subsystem After an IPL
If you IPL your IBM i nightly or on the weekends, you need to also restart TCP/IP services and the EXODUS51 subsystem. While you probably already have processes in place to restart TCP/IP, you can add the command STRSBS XL_EX51/EXODUS51 as part of that process. The EXODUS51 subsystem contains an auto-start job that runs constantly to monitor and dispatch Exodus51 conversations to the appropriate server programs.
While you are evaluating the software you may elect to start it manually. But if Presto doesn’t work for you on a Monday morning, this is probably the reason!
Step 6. Confirm your Server Installation.
Once you complete your IBM i installation you should be able to connect to your IBM i through Presto and begin running your IBM i applications.
To test whether your server components have been installed and configured correctly, type your IBM i IP address below and click the button to the right:
When you click this button, your browser will attempt to launch this URL: http://xxx.xxx.xxx.xxx:8022/presto/presto (replacing the x's with your IP address). 8022 is the port number on which the XL_PRESTO HTTP server instance will be listening.
If the server side of Presto was successfully installed, you should see your IBM i Sign On screen rendered using the default Presto skin:
If you don’t immediately get a succesful connection, check the troubleshooting suggestions at right. If you can't resolve the problem, finish the installation process and then contact Technical Support.
Step 7. Install the Presto Designer.
Follow the steps below to install Presto Designer (the PC design tool):
1. Download the latest version of the Presto client to your PC. When the download finishes execute the downloaded file (PrestoClient-3.5.exe) to unpack the install files and initiate the install.
2. This window appears (the exact release level shown may vary):
3. Follow the instructions to install Presto on your PC. When the installation is complete, click Finish.
The install will prompt you to automatically run the software (you can also run Presto from your Start menu, at Start/Programs/Presto/Presto).
When you first launch the software Presto will check whether you have defined a connection to your IBM i, and if not, will prompt you to create one:
Continue with the next step to define your IBM i connection for the Designer.
Step 8. Configure the Presto Designer to Connect to the IBM i.
To work with your applications using the Presto Designer you must create a connection to the IBM i so the Designer can communicate with the server. Follow these steps to set up your server connection.
1. On startup the Presto Designer checks whether you have configured a server connection. If not, it prompts you to add one:
Complete the values as described below:
Field
Value
Name
Enter a descriptive value for this connection.
Server Address
Type your IBM i IP address.
Port
The default value of 4015 should usually work for you. See the sidenote for details.
Library
The default install library is XL_PRESTO. Use this value unless you specified something different during the install.
URL
http://yoursite:8022/prestoadmin/presto is the default value for this field, but the correct URL should be defaulted in after you move away from the Server Address field.
2. After entering your settings use the Test button to verify your configuration. Presto prompt you to sign on to your IBM i. When you click OK at the Login window, Presto should confirm that you have connected.
3. After Presto verifies that your connection is working, click OK to save the connection. You’ll then see it listed here:
4. Click OK again at the list of Environments shown above. When you do this, Presto will finish launching the Designer. If prompted, log in to your IBM i again.
After logging in, the Presto IDE will launch, displaying a web version of your IBM i login screen, similar to this:
Now continue with the next step.
Step 9. Set Your Server Connection Defaults.
Every environment you create has its own server and auto-detection settings. Select Presto’s Tools/Server Connection menu option to work with these:
The default values for these settings should work well enough for you to get started with Presto.
Note: The critical options to take note of above are ‘Include fields in screen identifier’ and the Auto Detection settings. Before you get too far with adding customizations to your site be sure to read Chapter 7 of the User Guide, Assess Your Auto Detection Settings, to understand how Presto uses these settings.
From here you can also turn on the option to use a WebFacing connection, as described above and explained further in Appendix A at the end of the Presto User Guide.
Step 10. Moving On.
At this point you should be ready to try running the software and start learning how to use it.
If at any point in this process you would like to have an informal chat with someone to get some suggestions on how to address your particular needs, then by all means get in touch with our Sales or Technical Support teams.
Installation Instructions
