Installing a Satellite on Mac

You are here
Installing a Satellite on Mac

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 Mac download link. This will download a file named nqcsatellite.tar

download mac satellite

Untar & Run the Installer

Open the Terminal utility (like Command Prompt in Windows).

Browse to the Download folder (this is normally where a download on Mac will go) using the command:

cd downloads

Untar the Satellite using the command below:

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

mac satellite install options
Example script for installing the Mac 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.

After the friendly name 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.

mac satellite install options
Example script for installing the Mac 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.