Installing a Satellite on Linux

You are here
Installing a Satellite on Linux

Download the Satellite

The direct link to the Satellite download page is http://your mcs url/myspeed/admin/deploysatellite

To reach this page via the menu system go to the Satellites tab

sat tab

Then click on Deploy Satellite

deploy satellite

Now click on the Linux download link. This will download a file named nqcsatellite.tar

download Linux satellite

Untar & Run the Installer

Untar the Satellite using the command below:

sudo tar -xvf nqcsatellite.tar

This will list the two files contained within. They should be nqc.tar and nqc_configure.sh

Run the configuration file using the command below. The password for the machine will be required.

sudo sh nqc_configure.sh
untar linux satellite

Configure the Satellite

There are two ways to configure a Satellite; as a Satellite or as an Agent.

A Satellite will connect to the MCS host and appear in the Satellites list to be permitted and assigned a work order

An Agent will not appear in MCS. During the install process a work order is assigned and when the install has finished it will go an run that work order without any further instruction.

Install as a Satellite

The installer goes through a few configuration options. These are explained below.

Installing as a Satellite means it will need to be permitted and assigned work via the MCS Satellites tab.

linux satellite install options
Example script for installing the Linux Satellite

1. Installation directory

If the assumed install directory is correct just hit the enter key to continue. Else enter the full path of the directory to install the Satellite to.

2. Would you like to configure NQC as a Satellite or as an agent?

Choose the type of installation required. Type S for Satellite.

3. Enter the MCS URL or IP

This is the IP or domain of the MCS host server. The Satellite has to connect to a host in order to be assigned work orders.

4. Enter the MCS port

If the MCS host uses a port other than 80 enter it here.

5. Enter Satellite Server IP

By default the Satellite will be auto assigned an available IP address. To bind the Satellite to a specific IP address enter it here.

6. Enter Satellite Server Port

By default the Satellite will attempt to bind to port 8080. This will allow access to the Satellite main menu via the browser. To disable the web interface enter 0 here. To use a port other than 8080 simply enter it here.

7. Friendly Name

Enter a unique name for the Satellite. This is used to identify the Satellite within MCS.

8. Virtual Machine

If the Satellite is being installed on Virtual Machine type Y for this question, otherwise N

9. Service

Type Y if the satellite should run every time the machine boots.

After the Service question the Satellite will be installed and running as a service. The Satellite will now appear in the MCS Satellites list and need to be permitted. Once permitted a work order can be assigned.

Install as an Agent

The installer goes through a few configuration options. These are explained below.

linux satellite install options
Example script for installing the Linux Satellite

1. Installation directory

If the assumed install directory is correct just hit the enter key to continue. Else enter the full path of the directory to install the Satellite to.

2. Would you like to configure NQC as a Satellite or as an agent?

Choose the type of installation required. Type A for Agent.

3. Enter the MCS URL or IP

This is the IP or domain of the MCS host server. The Satellite has to connect to a host in order to be assigned work orders.

4. Enter the MCS port

If the MCS host uses a port other than 80 enter it here.

5. Password

As an Agent doesn't need to be manually permitted it must pass a password check. The NQC Satellite password is set in the security settings in MCS. The default is hello. If the password hasn't been changed leave this section blank. If it has simply enter the new password.

6. Test to run

An Agent has to be assigned a work order. Work orders are created in MCS. Enter the name of the work order the Agent should run. When the installation process has finished the agent will run this work order.

7. Results Tag

Enter a tag name. This will appear in the results to help identify where the results came from.

8. Service

Type Y if the satellite should run every time the machine boots.

The Agent will now be installed and running as a service.