Downloading & Installing a Satellite on Linux

You are here
Downloading & 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.

linux satellite install options
Example script for installing the Linux Satellite

1. Satellite or Agent

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

2. The MCS host

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

3. The MCS port

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

4. Web port

To enable access to the web interface for the Satellite then choose a port here. If left blank the default will be 8080. To disable the web interface type 0.

5. Friendly Name

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

6. Virtual Machine

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

7. 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. Satellite or Agent

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

2. The MCS host

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

3. The MCS port

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

4. 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.

5. 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.

6. Results Tag

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

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