Installation

The installation program covers the entire Vistasource RTW product suite including the RTW engines and RTSHARE.

For product installation details, scroll to the appropriate product section or click the following links:

• Install RTW Engines
• Install the FLEXlm License Server
• Install RTSHARE

After downloading RTW, run the executable and select Yes to continue.

1. A prerequisites window may display if you don’t have the required prerequisites on your machine. Click Install.
2. The InstallShield Wizard dialog will appear with a Welcome screen, click Next to continue.
3. Read the License Agreement, select YES to continue.
4. Select a destination location for the software. The default destination folder in Windows 7 is C:\Program Files (x86)\Vistasource\RTW\4.5 and in Windows XP C:\Program Files\Vistasource\RTW\4.5.
5. Click Next to continue.
6. On the Select Features screen, choose to install Vistasource RTW and the desired RTW engine(s) for your installation. Click Next to continue.
7. The installer will install the necessary files according to your choices in step 5 and then display a final screen. This screen will provide the option to review the product release notes and license the product.
8. Click Finish to complete the installation.

In Windows XP, administrator privileges are required to run the installer. If you are logged on as a standard user, you have the following options:

1. The system administrator can give administrator privileges to the user. In this case, you can proceed with the installation as described under Installing the RTW Engines.
2. If step 1 is not possible, you need to run the installer executable 'as administrator.' This process requires the following steps:
   1. Right-click on the installation executable and select Run as. The Run As dialog displays.
   2. Select The following User, and enter Administrator as username and then the Administrator password.
   3. Continue with the installation as described under Installing the RTW Engines.

Files that are not installed by the RTW installer, but are in the RTW installation directory, will not be removed by it. If such files exist, they will require manual removal from the application directory. For instance, you may have copied the mktdemo files into the application directory.

1. Select Start → Control Panel from the Windows taskbar.
2. Select Programs and Features.
3. The Programs and Features dialog box appears.
4. Select RTW.
5. Click Uninstall.
6. The RTW InstallShield Wizard opens.
7. Select Remove and click Yes. A dialog box displays requiring the confirmation of the uninstall process. After confirming the option, the uninstall process continues until the program is uninstalled

1. Select Start → Run from the Windows taskbar.
2. The Run dialog box appears.
3. Browse to the directory where the file was saved and double-click on the file “Vistasource RTW 4.5”.
4. The User Account Control Window displays. Click Yes
5. The RTW InstallShield Wizard opens.
6. Select Remove and click Next. A dialog box displays requiring the confirmation of the uninstall process. After confirming the option, the uninstall process continues until the program is uninstalled

The installation of RTSHARE requires a client/server setup. The server hosts the RTSHARE server product and communicates the data between the different client machines via the network. The clients share and receive cell data.

A typical setup includes an RTSHARE Server machine and one or more RTSHARE Client machines. Click on the links below for information on how to install RTSHARE on server and client machines:

• Install the Client
• Install the Server
• Install both Client and Server on the same machine

After downloading RTW, run the executable. A security warning may appear, select Yes to continue.

1. A prerequisites window may display if you don’t have the required prerequisites on your machine. Click Install.
2. The InstallShield Wizard dialog displays with a Welcome screen, click Next to continue.
3. Read the License Agreement, select Yes to continue.
4. Select a destination location for the software. By default the destination folder will be:
   In Windows 7: C:\Program Files (x86)\Vistasource\RTW\4.5 and in Windows XP: C:\Program Files\Vistasource\RTW\4.5
5. Click Next to continue.
6. On the Select Features screen, select Vistasource RTSHARE - Client.
7. Click Next to continue.
8. The RTSHARE File Modifications screen displays. Leave the default setting “Let Setup modify the Services file.” In both Windows 7 and Windows XP, the file is located in C:\Windows\System32\drivers\etc. The installer will add the following line to the services file: rtshare 5494/tcp. If you decide not to keep the default selections, see Manual Installation Steps for the RTSHARE Client below.
9. Click Next. The installer installs the necessary files and then displays a final screen.
10. This final screen includes options to review the product release notes and to license the product with either a permanent or evaluation license. These options are checked by default to allow instant access of the latest product information and to license the product. For more information about how to obtain a product key and the Vistasource Online Licensing Tool, see Obtain a Product Key. The release notes can also be accessed at any time from the install directory or via the About dialog in the product.
11. Click Finish to complete the installation.
12. When you start MS Excel, the RTW and RTSHARE User Interface is added to Excel accessible via the Vistasource Menu/Ribbon.

If you decide not to keep the default setting “Let Setup modify the services file” on the RTSHARE File Modifications Screen (Step 6 above), the required change to the Services file must be done manually for the program to work. In both Windows 7 and Windows XP, the Services file is located in C:\Windows\System32\drivers\etc. The required steps are dependent on your selections in this dialog. If you choose:

• Save the required changes to Services. NEW file - After the installation completes, you will need to navigate to the C:\Windows\System32\drivers\etc directory, back up your original Services file and rename Services.New to Services.
• Do not make any changes - After the installation completes, you will need to navigate to the C:\Windows\System32\drivers\etc directory, edit the Services file using any text editor, and add the following line to the bottom of the file:
  rtshare 5494/tcp
  NOTE: A blank line must follow this entry, otherwise the connection will fail.

After downloading RTW, run the executable. A security warning may appear, select Yes to continue.

1. A prerequisites window may display if you don’t have the required prerequisites on your machine. Click Install.
2. The InstallShield Wizard dialog displays with a Welcome screen, click Next to continue.
3. Read the License Agreement, select YES to continue.
4. Select a destination location for the software. By default the destination folder will be:
   In Windows 7: C:\Program Files (x86)\Vistasource\RTW\4.5 and in Windows XP: C:\Program Files\Vistasource\RTW\4.5
5. Click Next to continue.
6. On the Select Features screen, select Vistasource RTSHARE - Server.
7. Click Next to continue.
8. The RTSHARE File Modifications screen displays. Leave the default setting “Let Setup modify the services file.” In both Windows 7 and Windows XP, the file is located in C:\Windows\System32\drivers\etc. The installer will add the following line to the services file: rtshare 5494/tcp. If you decide not to keep the default selections, see Manual Installation Steps for the RTSHARE Server below.
9. Click Next to continue.
10. The next window contains two options which are checked by default. We recommend keeping the default settings.
    • Add an exception for rtshare to the firewall -These firewall exceptions are needed for rts_share and rtshare. To view these settings, choose Control Panel →System and Security →Windows Firewall → Exceptions. If a Virus Protection Software is running, firewall settings may be managed by that program. In case you decide not to keep the default selections, see Manual Installation Steps for the RTSHARE Server below.
      
      
    • Start rtshare when Windows starts up - The default setting is for the installer to configure the RTSHARE Server to automatically start when Windows starts and a user logs in the computer. When RTSHARE is started, the RTSHARE icon is added to the taskbar area together with a brief window about the licensing status. By right-clicking on the icon, you can access the RTSHARE Admin Window, view logs, server_stop_start, access the online help and view the RTSHARE About dialog box. If you decide not to keep the default selections, see Manual Installation Steps for the RTSHARE Server below.
11. Click Next to continue.
12. If installing on Windows 7, the RTSHARE User Information window displays. Enter the user account. In the field User name, enter the DOMAIN\username or browse to select the correct combination. Then enter your Windows password. Click Next to continue. If you need to create a new user, click New User Information and complete the subsequent window. Click OK to return to the RTSHARE User Information window and then click Next to continue.
13. The final screen includes options to review the product release notes and to license the product with either a permanent or evaluation license. These options are checked by default to allow instant access of the latest product information and to license the product. For more information about how to obtain a product key and the Vistasource Online Licensing Tool, see Obtain a Product Key. The release notes can also be accessed at any time from the install directory or via the About dialog in the product.
14. Click Finish to complete the installation.
15. To start the server, reboot. Alternately, for instant access, click Start→All Programs→Vistasource→RTSHARE. The Vistasource RTSHARE icon is added to the taskbar.

During the RTSHARE Server installation, the following takes place if you decide to leave all default options selected:

1. Vistasource–>RTSHARE is added to the Windows Start menu.
2. Two firewall exceptions are set:
   • Vistasource RTSHARE (corresponds to rts_share)
   • Vistasource RTSHARE service (corresponds to rtshare)
3. rtshare gets installed as a service in Windows and automatically started when Windows starts .

If you decide not to keep some or all of the default options during the installation, the following manual actions may be required, depending which option is changed:

Let Setup modify the services file
If you uncheck this default setting on the RTSHARE File Modifications Screen, the required change to the Services file must be done manually for the program to work. In both Windows 7 and Windows XP, the Services file is located in C:\Windows\System32\drivers\etc. The required steps are dependent on your selections in this dialog. If you choose:

• Save the required changes to Services. NEW file - After the installation completes, you will need to navigate to the C:\Windows\System32\drivers\etc directory, back up your original Services file and rename Services.New to Services.
• Do not make any changes - After the installation completes, you will need to navigate to the C:\Windows\System32\drivers\etc directory, edit the Services file using any text editor, and add the following line to the bottom of the file:
  rtshare 5494/tcp
  NOTE: A blank line must follow this entry, otherwise the connection will fail.

Add an exception for rtshare to the Windows Firewall
If you uncheck this default option on the RTSHARE Server options screen, the exceptions must be manually added to the Windows Firewall. If a virus protection Software is running, consult your virus protection program on how to manage exceptions to the firewall. The firewall exceptions are:

• Vistasource RTSHARE (corresponds to rts_share)
• Vistasource RTSHARE service (corresponds to rtshare)

Start rtshare when Windows starts up
If you uncheck this default option on the RTSHARE Server options screen, you need to manually start RTSHARE after logging into the computer. To manually start RTSHARE, click Start →All Programs →Vistasource→RTSHARE. The RTSHARE icon will appear in the taskbar area together with a brief window about the licensing status. By right-clicking on the icon, you can access the RTSHARE Admin window, view logs, stop/start RTSHARE, access the online help and view the RTSHARE About dialog box. If you decide at a later point to have RTSHARE automatically start up when Windows starts up, the easiest way to add RTSHARE to the startup is by re-runnnig the installer:

• Start the installer. The installer detects that you already have RTW components installed. On the RTW and RTSHARE installation screen, click on Modify. On the Select Features screen, leave the selections the same, click Next and on the RTSHARE Server options screen leave the default 'Start rtshare when Windows starts up' toggled on. Click Next and finish the installation. Next time you reboot, RTSHARE will start when Windows starts and the user logs in.

To manually install or remove the RTSHARE service:

1. Click on All Programs→Accessories
2. In Windows 7, right-click on Command Prompt and select Run as administrator. In Windows XP, right-click on Command Window.
3. A command window opens.
4. Navigate to the install directory for RTSHARE. The default directory is:
   In Windows 7: C:\Program Files (x86)\Vistasource\RTW\4.5 and in Windows XP: C:\Program Files\Vistasource\RTW\4.5
5. Enter the executable rtshare followed by the relevant arguments. rtshare supports these three arguments:
   • -install (install the service)
   • -remove (remove the service)
   • -removeq (remove the service, quietly (no info/error messages))
6. To verify:
   • If installed, the RTSHARE Service should be listed in Services (Windows Task Manager)
   • If removed with -remove, a confirmation window is displayed.
   • If removed with -removeq, no confirmation window is displayed.

For a Client/Server installation on the same machine, follow the steps as outlined in Installing the RTSHARE Server, but select both RTSHARE Server and RTSHARE Client in the Select Features screen.

After finishing the installation and licensing the product, start Excel. The RTW and RTSHARE User Interface is added to Excel as part of RTSHARE Client and accessible via the Vistasource Menu/Ribbon.

In Windows XP, administrator privileges are required to run the installer. If you are logged on as a standard user, you have the following options:

1. The system administrator can give administrator privileges to the user. In this case, you can proceed with the installation as described under Installing RTSHARE.
2. If step 1 is not possible, you need to run the installer executable 'as administrator.' This process requires the following steps:
   1. Right-click on the installation executable and select Run as. The Run As dialog displays.
   2. Select The following User, and enter Administrator as username and then the Administrator password.
   3. Continue with the installation as described under Installing RTSHARE. If you are installing the RTSHARE Client, upon completion of the installation, the client add-ins require a manual installation.
   4. Start Excel and select Files → Options → Add-Ins. The Excel Add-in Manager dialog box opens.
   5. At the bottom, select Manage Excel Add-Ins and click Go.
   6. The Add-Ins dialog box comes up, click Browse.
   7. Navigate to the RTSHARE installation directory, which by default is C;/Program Files/Vistasource/RTW/4.5
   8. Select rts.xlam and click OK. Vistasource RTW should appear in the Add-in window.
   9. Repeat steps f and g.
   10. Select rtshare.xlam and click OK. The Vistasource RTSHARE Client should appear in the Add-in window.
   11. Click OK in the Add-in window and the Vistasource Ribbon will be added to Excel.

1. Select Start → Control Panel from the Windows taskbar.
2. Select Programs and Features.
3. The Programs and Features dialog box appears.
4. Select RTW.
5. Click Uninstall.
6. The RTW InstallShield Wizard opens.
7. Select Remove and click Yes. A dialog box displays requiring the confirmation of the uninstall process. After confirming the option, the uninstall process continues until the program is uninstalled

1. Select Start → Run from the Windows taskbar.
2. The Run dialog box appears.
3. Browse to the directory where the package file was saved and double-click on “Vistasource RTW 4.5”.
4. The User Account Control Window displays. Click Yes
5. The RTW InstallShield Wizard opens.
6. Select Remove and click Next. A dialog box displays requiring the confirmation of the uninstall process. After confirming the option, the uninstall process continues until the program is uninstalled

The FLEXlm license server allows running a license server on a dedicated machine that is independent of any other machine that may have RTW, RTSHARE Client or RTSHARE Server installed. To run the license server instead of using the integrated Vistasource Online Licensing Tool, the License Server Only component must be installed.

1. After downloading RTW, run the executable. Select Yes to continue.
2. A prerequisites window may display if you don’t have the required prerequisites on your machine. Click Install.
3. The InstallShield Wizard dialog will appear with a Welcome screen, click Next to continue.
4. Read the License Agreement, select YES to continue.
5. Select a destination location for the software. The default destination folder in Windows 7 is C:\Program Files (x86)\Vistasource\RTW\4.5 and in Windows XP C:\Program Files\Vistasource\RTW\4.5.
6. Click Next to continue.
7. On the Select Features screen, choose to install License Server Only. Click Next to continue.
8. The installer will install the necessary files and then display a final screen. This screen will provide the option to review the product release notes and license the product.
9. Click Finish to complete the installation.

For more information on how to set up the license server after installation, see FLEXlm License Server.