This is the documentation for SuperSTAR 9.8

SuperSTAR 9.9 is now available.
View this page in the SuperSTAR 9.9 documentation or visit the SuperSTAR 9.9 documentation home.

Skip to end of metadata
Go to start of metadata

These instructions explain how to set up SuperSTAR when you want to install SuperSERVER and SuperADMIN on different machines.

Step 1 - Install SuperSERVER

The first step is to run the SuperSERVER installation process:

  1. Go to the machine where you want to install SuperSERVER and launch the SuperSERVER installer.
  2. Click through the options as if you were doing a standard installation until you get to the option to choose a Complete or Custom install.

    Choose the Custom installation:

  3. When you are prompted to select the components to install, deselect SuperADMIN and the SuperSTAR Service:

  4. Complete the rest of the installation process.

Step 2 - Install SuperADMIN

  1. Go to the machine where you want to install SuperADMIN and launch the SuperSERVER installer.
  2. Click through the options as if you were doing a standard installation until you get to the option to choose a Complete or Custom install.

    Choose the Custom installation:

  3. When you are prompted to select the components to install, select everything except SuperSERVER SA:

  4. Complete the rest of the installation process.

Step 3 - Configure SuperSERVER to Connect to SuperADMIN

The final step is to configure SuperSERVER so that it connects to the SuperADMIN server running on the other machine (by default, SuperSERVER will attempt to connect a SuperADMIN server running on the same machine as SuperSERVER).

  1. Go to the machine where you installed SuperSERVER.
  2. Start SuperSERVICE Manager.
  3. Click Install SuperSERVICE.
  4. In the Service Name and Service Display Name fields, enter SuperSTAR.

  5. In the Applications to Run section, click Add. The Add Application window displays.
  6. In the Application Path, click the browse button and select the SuperSERVER executable. If you kept the default installation location, this will be located at C:\Program Files\STR\SuperSERVER SA\scsa.exe
  7. In the Application Parameter field, enter -a <host> (replace <host> with the hostname or IP address of the server where you installed SuperADMIN).

    If your SuperADMIN server is running on a non-standard port, you must specify that here too, e.g. -a mysuperadminhost:9000

  8. Click OK on the Add Application window.
  9. Leave all the other options set to the defaults.
  10. Click Install.

  11. Go to the Windows Services console and start the SuperSTAR service.

Step 4 - Verify the Installation

You can verify that SuperSERVER and SuperADMIN are set up correctly and communicating with each other by doing the following.

Check the SuperSERVER Log File

On the machine where you installed SuperSERVER, check the SuperSERVER log file. If you kept the default installation locations, the log file will be stored at C:\ProgramData\STR\SuperSERVER SA\logs\scsa.logs.txt

If SuperSERVER has successfully connected to SuperADMIN, the log file will contain lines similar to the following:

10:04:20 2013/08/21, INFO, AUDIT_DataServer, "Attempting to register with Administration Server [mysuperadminhost:9230]" 
10:04:20 2013/08/21, INFO, AUDIT_DataServer, "Connected!" 

Check SuperADMIN

On the machine where you installed SuperADMIN, login to the SuperADMIN Console and use the command server to check that your SuperSERVER has connected to SuperADMIN and registered itself.

You should see output similar to the following, confirming that SuperADMIN is connected to your server and it is running:

> login user1 user1
User 'user1' logged in
> server

[ Default Metadata Configuration       (id:defaultmd)              (uri:\\localhost:8005)  ]
[ SuperSERVER mySERVER                 (id:mySERVER)               (RUNNING)     (uri:\\mySERVER:9232)  ]
[ Default Configuration                (id:default)                (uri:\\localhost:9232)  ]