S-PLUS 6.2 Windows Network Installation

 

These are the instructions for installing the network version of S-PLUS 6.2.  There are three main steps to this process:

 

1.  Installing the product from the CD

2.  Downloading and applying a patch

3.  Configuring your system for the UVA network.

You must complete all three steps in order to use S-PLUS 6.2 on your UVA networked machine.

Installing the Product from the CD

The CD contains S-PLUS, Revision Date: 2 Dec 2003  Build: 6713.  At the end of the installation process, you will download and apply a patch, upgrading to Revision Date: 12 Jan 2004 Build: 6713.

If your system has CD-ROM AutoPlay enabled, the S-PLUS Setup program starts automatically. Otherwise, click the Start button, then Run, then type x:\setup (where x is the drive letter of the CD-ROM). Alternatively, double-click the setup.exe file in the CD-ROM drive of Windows Explorer.

 

 

Click next on the Welcome Screen:

 

Next enter the user information: and click on next

Accept the terms of the license agreement, and click on next

 

Click on Step 1: Install network server edition.  You do NOT complete Steps 2 and 3.

 

Wait for the initialization process to complete and click next:

 

The complete setup option installs  all of the S-PLUS files in the selected directory, including the release notes, program files, online help, sample files, development support files, and supported libraries.

The complete setup is recommended for most users.

 

If possible choose the default destination folders for S_HOME, S_PROJ and start menu program folder name:

 

 

 

 

 

You can select the windows you wish to have presented at S-PLUS startup:

 

Before clicking on finish, you may want to review your setup summary.  If you have modified it by choosing a custom setup or alternate folders, you may copy the details to a text file for your future reference.

 

 

 

 

 

 

Downloading and Applying the Patch

You should be connected to the internet and be sure to have the last box, “Check for program updates online (recommended)” checked before clicking on Finish.  This will take you to a web site that allows you to download the necessary patch for version 6.2.

 

You will be taken to the download center for S-PLUS.  If you experience a problem  in downloading the patch, you may return to the licensing database to obtain the necessary patch.  Changes between S-PLUS 6.1 and the initial release of S-PLUS 6.2 (Rev Date: 2 Dec 2003) caused file import and export to take longer, particularly when the data contains a large number of rows. The slowdown is present using either the dialogs or the importData() and exportData() functions. The cause of the slowdown was identified and remedied, and the slowdown is resolved by this patch.

This update will change S-PLUS 6.2 (Rev Date: 2 Dec 2003) to S-PLUS 6.2 (Rev Date: 12 Jan 2004). Insightful recommends that all users running the affected editions install the update. This issue affects all editions of S-PLUS 6.2 for Windows. Earlier releases are not affected.

Important:

·         Completely shut down S-PLUS before applying the update.

·         To apply the update, you must have the appropriate version of
S-PLUS.  To determine which version you have, launch S-PLUS and from the main S-PLUS menu, select Help > About S-PLUS. You should see “S-PLUS 6.2 for Windows Rev: 2 Dec 2003 Build: 6713”

Updating S-PLUS 6.2 for Windows:

·         Download the update and save it in a directory on your hard drive.

·         Double click on the downloaded file to apply the update.

·         To determine the update was successful, launch
S-PLUS and from the main S-PLUS menu, select Help > About
S-PLUS.  You should see “S-PLUS 6.2 for Windows Rev: 12 Jan 2004 Build: 6713”.

Click on  Download now to get  the patch.  Exit S-PLUS and double click on the file, splus62r1_20031202_to_20040112.exe.

If you did not install S-PLUS in the default directory, be sure to browse to the correct directory, then click on update.

Click on Exit. 

Configuring your System

After installing the software, you next need to configure your local workstation to communicate with the license manager.

• For Windows NT or Windows 2000 machines, you can modify your environment variables by clicking on Start | Settings | Control Panel, and selecting System or double clicking on the System icon.

For NT 4 users, select the Environment tab. At the bottom of the window, you will see a Variable and a Value box. Type "S_ELMHOST" in the Variable box and the S_ELMHOST value from the licensing database in the Value box. Click "Apply" and then "OK".

For Windows 2000 or XP users, you should see an Advanced tab with an Environment Variables button. Click on it. Under "User variables", click on New. For Variable Name, type "S_ELMHOST" (without the quotes) and for Variable Value, type the S_ELMHOST value from the licensing webpage, and click on the "OK" button. Repeat this for the "System variables." Lastly click on "Apply" back in the main Environment Variables box, and "OK" until you exit out of the panel.

S-PLUS is now ready for use.

The process is illustrated for Windows 2000 in the next three images.

 

 

 

 

COMPILERS/LINKERS – only for users who have built any C/C++ or Fortran applications using CONNECT/C++ or who have modified one of the sample applications

S-PLUS 6.2 is built with Microsoft VC++6.0 and Compaq/DEC FORTRAN 6.0. All samples shipped with S-PLUS 6.2 have been tested with VC++6.0 and Compaq/DEC FORTRAN 6.0. If you use Microsoft VC++6.0 and Compaq/DEC Fortran 6.0 in your projects that link to S-PLUS, use the import libraries in SHOME\lib. For example, sqpe.lib is the import library for sqpe.dll containing the core S-PLUS interpreter, and sconnect.lib is the import library for sconnect.dll containing the CONNECT/C++ class library.

Previous builds of S-PLUS 6 for Win32 used Visual Studio 6.0 Service Pack 3 to build the engine, GUI, and all samples and utilities shipped with the program. To fix some issues in MFC (the Microsoft Foundation Classes) that S-PLUS is based on, we updated the compiler to Service Pack 5. If you have built any C/C++ or Fortran applications using CONNECT/C++ or have modified one of the sample applications for your own purposes, you should install the Visual Studio 6.0 Service Pack 5 update, and recompile and relink these applications to ensure there are no runtime problems related to changes that may have occurred in Microsoft shared *.dll files.

File input and output is fully supported in C code called from S-PLUS, but input and output directed to the standard streams STDIN, STDOUT, and STDERR requires special handling. This special handling is provided by the header file newredef.h, which is included in S.h and sconnect.h. If you need to disable this behavior, define NO_NEWIO before S.h or sconnect.h. For example:

#define NO_NEWIO

#include "S.h"