14-Mar-2022 ======================== WPS Installation on UNIX ======================== WPS for UNIX version 4.1.10-GA-release (4.1.10.0.18452-GA-release) ----------------------------------------------------------------------- ======================================================================= 1. Prerequisites 2. Installation 2.1 Environment variables 3. wpsenv.sh shell script 4. Upgrading ======================================================================= 1. Prerequisites ================ Linux ----- WPS is supported on any distribution of Linux that is compliant with Linux Standard Base (LSB) 3.0 or above. WPS is supported on Linux running on x86, x86_64 and IBM System z including Integrated Facility for Linux (IFL). If you have a 64-bit Linux distribution installed, you have the choice of using 32- or 64-bit WPS. It should be noted that some 64-bit Linux distributions only install 64-bit system libraries by default. Using 64-bit WPS on these distributions will work out of the box, however if you chose to use 32-bit WPS, you will first need to install the 32-bit system libraries first. Please consult your Linux distribution documentation for directions on how to accomplish this. There are no other prerequisites for installing and running WPS. 2. Installation =============== WPS for Linux is currently available as an RPM package, a debian-based package, or compressed tar archive. All versions can be downloaded from the World Programming website. You will require a username and password to access the download section of the site. We recommend that you use the package appropriate for your distribution. RPM package ----------- To install the package requires the ability to use the sudo command to gain administrator privilege. The default installation location is /opt/worldprogramming/wps-. After downloading the package, install using the following command: sudo rpm --install //.rpm Debian-based package -------------------- To install the package requires the ability to use the sudo command to gain administrator privilege. The default installation location is /opt/worldprogramming/wps-. After downloading the package, install using the following command: sudo apt install .deb Compressed tar -------------- To install WPS, extract the files from the archive using gunzip and tar as follows. Choose a suitable installation location to which you have write-access and change (cd) to that directory. The archive is completely self-contained and can be unpacked anywhere. The installation location can be somewhere that requires root access such as /opt if installing for all users, or it can be in your home directory. Unzip and untar the installation file by typing: tar -xzof .tar.gz or: gzip -cd .tar.gz | tar xvf - Apply a licence key ------------------- You will need a license key in order to run WPS, which can be applied from the command line. To apply a licence key use the following command: /bin/wps -stdio -setinit < A message will confirm the license had been applied successfully. Launching workbench ------------------- To launch the WPS Workbench Graphical User Interface: /eclipse/workbench For information on using Workbench, see the 'WPS Workbench User Guide'. A pdf version of this guide can be found in the doc directory of your installation. A similar version of this guide can also be accessed directly from inside the WPS Workbench by selecting the menu item Help > Help Contents. 2.1 Environment variables ========================= Note: The following recommendation assumes that you use the Bash shell. Using WPS with third-party applications such as database servers, requires that the environment information needs to be available at WPS start up, such as: * LD_LIBRARY_PATH, for example pointing to client libraries for a database * PATH, for example pointing to the bin folder for unixODBC * ODBCSYSINI, pointing to the unixODBC client libraries If you have not set these environment variables in another way, we recommend creating a Bash shell script called wpsenv.sh that exports these variables, and can be sourced from system Bash shell scripts. If WPS is used by multiple users, you should consider setting global environment variables: 1. Create a folder called worldprogramming in /etc. and within this folder, create the worldprogramming.sh shell script. 2. This file should be sourced from both the /etc/profile and /etc/bashrc files to ensure that the variables are available to WPS. If WPS is to be used by individual users, you should set the variables through a Bash shell script in the user's home directory: 1. Create a folder called .worldprogramming in the home directory and within this folder, create the worldprogramming.sh shell script. 2. This file should be sourced from ~/.profile or ~/.bash_profile to ensure that the variables are available to WPS. 3. wpsenv.sh shell script ========================= You can create a shell script that enables you to configure environment variables or other system options before running WPS. The script can be called either wpsenv.sh, that can be executed by WPS version 3.2 or higher, or wpsenv-3.2.sh, which will only be executed by WPS version 3.2. The script you create can be located in either the root WPS installation directory or the user's home directory. Using a version-specific shell script allows different environments to be configured individually as new releases are deployed. 4. Upgrading ============ You will need a version 4 license key to use WPS version 4. WPS will always be able to read data created by prior versions of WPS. Older versions of WPS will not always be able to read data created by newer versions of WPS. Note that the location of the command line executable for WPS has been moved from the root of the WPS installation directory to the bin subdirectory. Existing shell scripts and other references to wps will need to be changed to bin/wps. (c) 2022 World Programming