progress-4gl Getting started with progress-4gl Installation or Setup
Example
Installing Progress
Download your distribution from Progress. If you want a demo license you need to contact them. Make sure you download a 64-bit and not a 32-bit tar file (unless you happen to run a 32-bit machine).
Windows
The download will be a zip archive. Unpack it and simply run setup.exe. The installation will be graphical but otherwise exactly like the one described below.
Linux/Unix/HP-UX etc
Put the tar file on your Progress system. Let's say you have it in your home directory:
/home/user/PROGRESSFILENAME.tar
Extract it:
cd /home/user
tar xvf PROGRESSFILENAME.tar
It will create a directory named
proinst
Change directory to another destination and create a temporary directory there. For example:
cd /tmp
mkdir proinst116
cd proinst116
Once the installation is complete this directory will contain information about the installation as well as files you can save and used for future automatic repetitions of the same installation.
Now run the installationscript (named "proinst" in the directory "proinst"):
/home/user/proinst/proinst
This will start the installation:
+-------------------------------------------------------------------+
| Welcome |
+-------------------------------------------------------------------+
| |
| WELCOME TO THE OPENEDGE INSTALLATION UTILITY |
| |
| Ensure that you have your completed "Preinstallation Checklist |
| for Unix" handy to consult. This information will facilitate your |
| installation and ensure your choices are accurately recorded. |
| |
| Copyright (c) 1984-2015 Progress Software Corporation |
| and/or one of its subsidiaries or affiliates. |
| All Rights Reserved. |
| |
| |
| [Enter=OK] |
+-------------------------------------------------------------------+
Now you will need to insert license keys, company name etc. It's recommended to download an "addendum file" then you can simply press Ctrl+A and use it.
+----------------------------------------------------------------------+
| Product Configuration Data |
+----------------------------------------------------------------------+
| [Enter=Additional] |
| Company Name: ______________________________ [Ctrl-E=Done] |
| Serial Number: _________ [CTRL-T=Quit] |
| Control Number: _____ _____ _____ [CTRL-N=Release Notes]|
| [CTRL-V=View] |
| [TAB=Next Field] |
| [CTRL-P=Help] |
| [CTRL-A=Addendum File]|
| |
+----------------------------------------------------------------------+
Adding an addendum-file:
+---------------------------------------------------------------------------+
| License Addendum File |
+---------------------------------------------------------------------------+
| |
| Enter Path: /home/myuser/myfile.txt______________________________________ |
| |
| |
| |
| [Enter=OK] [CTRL-N=Cancel] |
+---------------------------------------------------------------------------+
| [TAB=Next Field] |
| [CTRL-P=Help] |
| [CTRL-A=Addendum File]|
| |
+----------------------------------------------------------------------+
After you've added licenses manually or loaded them via a file you can press Ctrl+V to view products to be installed:
+------------------------+
|Entered Product List |
+------------------------+
| 4GL Development System |
| OE Application Svr Ent |
+-----| OE Enterprise RDBMS |---------------------------------------+
| | OpenEdge Replication |nfiguration Data |
+-----+------------------------+---------------------------------------+
| [Enter=Additional] |
| Company Name: ______________________________ [Ctrl-E=Done] |
| Serial Number: _________ [CTRL-T=Quit] |
| Control Number: _____ _____ _____ [CTRL-N=Release Notes]|
| [CTRL-V=View] |
| [TAB=Next Field] |
| [CTRL-P=Help] |
| [CTRL-A=Addendum File]|
| |
+----------------------------------------------------------------------+
Once you're satisfied, press Ctrl+E to continue the installation or Ctrl+Q to quit.
If you move on you will have to OK just one more thing:
+-----------------------------------------------------------------------+
| Done Configuration Data Confirmation |
+-----------------------------------------------------------------------+
| |
|Are you sure that you are done entering all the control numbers for the|
|OpenEdge products that will be installed? |
| |
| [Y=YES] [N=NO] |
+-----------------------------------------------------------------------+
| [CTRL-P=Help] |
| [CTRL-A=Addendum File]|
| |
+----------------------------------------------------------------------+
Press Y to continue or N to go back.
Depending on what you're installing you might need to set up different products during the installation.
Next step is to decide if you want to enable the "OpenEdge Explorer". Y or N. This can be changed later on.
+-------------------------------+
| Install Type and Destination |
+-------------------------------+
| Select Type of Installation |
| Select Destination Pathname |
| Select Management Pathname |
| Continue with Installation |
| View Release Notes |
| Cancel |
| Quit Installation |
| Help |
+-------------------------------+
+-----------------------------------------------------------------------------+
|Type: Complete Install |
|Destination pathname: /usr/dlc |
|Working Dir pathname: /usr/wrk |
|Management pathname: /usr/oemgmt |
|Management Working Dir pathname: /usr/wrk_oemgmt |
| |
+-----------------------------------------------------------------------------+
Now you have to decide directories where you want to install Progress as well as primary working directory (basically where you want to store your code). Change these or move on with the defaults. Historically /usr/dlc has always been the default so you might want to change this to something thats unique for this specific version of Progress - that might help when upgrading. Choose a Complete Install (the default).
Once done: choose Continue with Installation using arrow keys and press enter to continue.
+---------------------------------------------------+
| Select Server Engine |
+---------------------------------------------------+
|*SQL -Provides SQL access to OpenEdge data files |
| Continue with Install |
| Cancel |
| Help |
+---------------------------------------------------+
If you're not planning any SQL access you can press enter once and remove the * before SQL, otherwise just Continue with Install.
+---------------------------------------------------------------------------+
| ATTENTION |
+---------------------------------------------------------------------------+
| |
|The OpenEdge Adapter for Sonic ESB is a recommended component of this |
|installation and requires a Sonic ESB installation somewhere on your |
|network. |
| |
|Choose YES if you plan on using OpenEdge Adapter for Sonic ESB, else choose|
|NO. |
| |
| [Y=YES] [N=NO] [H=Help] |
+---------------------------------------------------------------------------+
Most likely you do not need the OpenEdge Adapter for Sonic ESB so press N - otherwise you know what to do.
+-----------------------------------------------------------------+
| ATTENTION |
+-----------------------------------------------------------------+
| |
|WebSpeed is a recommended component of this installation and |
|requires a Web Server installed somewhere on your network. |
| |
|Choose YES if you plan on using WebSpeed and you are installing |
|on the system where your Web Server is installed, else choose NO.|
| |
| [Y=YES] [N=NO] [H=Help] |
+-----------------------------------------------------------------+
If you plan on using WebSpeed for producing dynamic HTML press Y, otherwise N.
+------------------------------------+
| Web Server Type |
+------------------------------------+
| Select Web Server Type |
| Select Web Server Script directory |
| Copy the static HTML to docroot |
| Continue with Installation |
| Cancel |
| Quit Installation |
| Help |
+------------------------------------+
Setting up WebSpeed: Choose Select Web Server Type and set it to cgi (most likely anyway). Web server script directory can be set to your servers cgi-bin directory or something like /tmp. Don't copy the static HTML - it's really outdated. Continue!
+----------------------------+
|Language Selection |
+----------------------------+
| Chinese (Simplified) |
| Czech |
| Dutch |
| English - American |
| English - International |
| French |
| German |
| Italian |
| Polish |
| Portuguese - Brazilian |
| Spanish |
| Portuguese |
| Swedish |
| Spanish - Latin |
| Make Default |
| Continue with Installation |
| Cancel |
| Help |
+----------------------------+
Choose English unless you really need something else, you can actually select more than one - make one default in that case. Continue!
+------------------------------------+
| International Settings |
+------------------------------------+
| Select CharacterSet,Collation,Case |
| Select a Date Format |
| Select a Number Format |
| Continue with Installation |
| Cancel |
| Quit Installation |
| Help |
+------------------------------------+
| Polish |
| Portuguese - Brazilian |
| Spanish |
| Portuguese |
| Swedish |
| Spanish - Latin |
| Make Default |
+-----------------------------------------------------------------------------+
| |
| CharacterSet,Collation,Case: ISO8859-1, Swedish, Basic |
| Date Format: ymd |
| Number Format: 1.234,56 (period, comma) |
+-----------------------------------------------------------------------------+
For the Itnernational Settings you should try and match any previous installations to help yourself in the future. Otherwise you can set it to something that fits your own needs. This can be changed in the future. Use UTF-8 if you want.
+---------------------------------------------------------------------------+
| Web Services Adapter URL |
+---------------------------------------------------------------------------+
| Please enter the URL of where you will configure the sample |
| Web Services Adapter's Java Servlet. |
| |
| URL: http://fedora-1gb-ams3-01.localdomain:80/wsa/wsa1___________________ |
| |
| [Enter=OK] [CTRL-N=Cancel] [CTRL-P=Help] |
+---------------------------------------------------------------------------+
Leave the defaults for the Web Services adapter URL unless you have a good reason.
+-------------------------------------------------------------------------+
| WSA Authentication |
+-------------------------------------------------------------------------+
| |
|Would you like to Disable the Web Services Adapter's administration user |
|authentication? |
| |
| [Y=YES] [N=NO] [H=Help] |
+-------------------------------------------------------------------------+
Disable user authentication? Most likely N is what you want.
+-------------------------------------------------------------------------+
| Complete Installation |
+-------------------------------------------------------------------------+
| |
|The following products will be installed: |
|'4GL Development System (x USERS)', 'OE Application Svr Ent (y USERS)', |
|'OE Enterprise RDBMS (z USERS)', 'OpenEdge Replication (u USERS)' |
| |
|Disk Space Required for Products: 1,138,163,712 bytes |
|Disk Space Required for Installation: 1,139,343,360 bytes |
|Disk Space Remaining After Installation: 26,534,129,664 bytes |
| |
|Selected Destination Path: /usr/dlc |
| |
|Do you want to install the above listed product(s)? |
| |
| [Y=YES] [N=NO] [H=Help] |
+-------------------------------------------------------------------------+
This is the final (but one) screen before installation begins.
+-----------------------------+
| Copy Scripts? |
+-----------------------------+
| |
|Copy the scripts to /usr/bin?|
| |
| [Y=YES] [N=NO] [H=Help] |
+-----------------------------+
If you choose to do this you might want to make sure there isn't a previous install being overwritten.
+----------------------------------------------------------------------------+
| Installing Files |
+----------------------------------------------------------------------------+
| |
| Installing subcomponent: Common Files (m) |
| Installing file: libjvm.so |
| 17% |
| +------------------------------------------------------------------------+ |
| | | |
| +------------------------------------------------------------------------+ |
| |
| [CTRL-T=Quit] |
+----------------------------------------------------------------------------+
Installation in process. Takes a minute or two.
+-------------------------------------------------------------------------+
| Configuring WebSpeed |
+-------------------------------------------------------------------------+
| |
| a. Set up and start your Web server |
| - If you did not select to "Copy static HTML files to |
| Document Root directory", then manually copy the files |
| or set a link. |
| - For NSAPI Messenger, edit the "obj.conf" and "start" files |
| on the Web server. |
| b. Set up the Broker machine. |
| - Set environment variables if necessary. |
| - Edit the properties file (ubroker.properties), then start Broker. |
| c. To validate your configuration through the Messenger |
| Administration Page, enter ?WSMAdmin after the Messenger name |
| in a URL. |
| (For example, for CGI, http://hostname/cgi-bin/wspd_cgi.sh?WSMAdmin) |
| (For example, for NSAPI, http://hostname/wsnsa.dll?WSMADmin) |
| |
|See the "OpenEdge Application Server: Administration" guide for details. |
| |
| [Enter=OK] [H=Help] |
+-------------------------------------------------------------------------+
Some information about WebSpeed.
+---------------------------------------------------------+
|Installation of selected OpenEdge products is complete. |
|Refer to the installation notes for more information. |
+---------------------------------------------------------+
| End the OpenEdge Installation |
| View Release Notes |
| Help |
+---------------------------------------------------------+
Final screen - End the Installation or View the Release Notes.
You are done!
Silent installation
The installation has stored a file named /usr/dlc/install/response.ini (or your installation directory). This file can be used to repeat the exact same installation again in a "silent" install that can be scriptet and run without any interaction.
To run a silent install simply do:
/path-to-proinst/proinst -b /path-to-response-file/response.ini -l /path-to-store-log/silent.log
