24-Sep-2018 ======================== WPS Installation on UNIX ======================== WPS for UNIX version 4.0.2.0 (4.0.2.0.6753) ----------------------------------------------------------------------- ======================================================================= 1. Prerequisites 2. Installation 2.1 Environment variables 3. wpsenv.sh shell script 4. Upgrading ======================================================================= 1. Prerequisites ================ Solaris ------- WPS is supported on Solaris 10 and above running on SPARC, x86 and x86_64 hardware. 2. Installation =============== WPS for Solaris is currently available as a compressed tar archive file only. A native packageadd-based installer will be made available in the future. The WPS tar archive for Solaris can be downloaded from the World Programming website. You will require a username and password to access the download section of the site. The archive is supplied in compressed tar (.tar.Z) format. To install WPS, first decompress the archive using the command: uncompress .tar.Z 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 /usr/local if installing for all users, or it can be in your home directory. On Solaris it is necessary to use the Gnu version of tar rather than the native Solaris tar due to limitations in Solaris tar. Please ensure that the Gnu tar comes before Solaris tar on you PATH environment variable otherwise the package will not unpack correctly. Unpack the tar file using the command: tar -xof .tar Note that the -o option is recommended when unpacking as root to ensure that the files have the correct uid and guid. When the tar file is unpacked, files are created in the subdirectory wps_4.0.2.0 of the current directory. You will need a license key in order to run WPS. It can be applied by calling the main executable for WPS as follows: /bin/wps -stdio -setinit < For information on using WPS, see the 'WPS Workbench User Guide'. A pdf version of this guide can be found in the doc directory in the 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. Copyright World Programming Ltd 2002, 2018