Collect Backup

Collect Backup is a Gateway Task that performs a Gateway backup on the selected Agent's machine.

1. On the Controller, navigate to Configure > Enterprise Administration > Agent Tasks, and click on Create new Gateway Task.

   

2. Collect Backup is one of the several Gateway tasks you can perform. Select Collect Backup, and press Next. The EAM task wizard will walk you through each step of the Collect Backup process.

   

3. There are several different task scheduling options available. For this Collect Backup example, choose to Execute Immediately, and press Next. If you need more information on other scheduling options, refer to Task Scheduling.

   

4. Select the Agent you want to perform the Collect Backup on, and press Next.
   
   
   
   

5. The EAM task wizard will prompt you if you want to do a Force Backup even if nothing changed since the last backup. This step is optional, but it is useful when your backups are performed on a regular schedule. It captures the changes between the time the last backup was performed and the unscheduled backup. To be safe, check the Force Backup box, and press Next.

   

6. Review the Collect Backup Task Summary information, and press Finish.

   

7. Once the Collect Backup task is complete, a successful message will be displayed. You can even check the history by opening the Task History tab.

   

   Your new Gateway backup will be stored wherever your Controller settings are pointing to when the Controller was initially created. To check, go to the Controller, and navigate to Configure > Enterprise Administration > Controller Settings. You can have your Archive Path set to Automatic or Manual. If you have it set to Automatic, you can find your backups inside the directory for Ignition, otherwise, it will be the folder location that is specified in the Controller Settings. To learn more about controller settings, refer to Creating a Controller.

   

Restore Backup

Now, let’s restore a Gateway backup on the selected Agent.

1. Go to the Controller, and navigate to Configure > Enterprise Administration > Agent Tasks. Click on the Create new Gateway Task link.
   Select the Restore Backup task, and press Next.
   
   

   Screenshots

   Some screenshots will not be duplicated. You can refer to the screenshots in Collect Backup as you work your way through each section.

2. Schedule the Restore Backup task to Execute Immediately, and press Next.

3. Select the Agent, and press Next.

4. If your Archive Path was set to Manual when you created your Controller, you will have to select the Choose File button, and navigate to the folder on your computer to locate the Gateway Backup file. If you are unsure about your Archive Path, refer to your Controller Settings.

   

   Navigate to the folder on your computer to locate the Gateway Backup file. Select the backup.gwbk, and click Open. Press Next on the Restore Backup task.

   

5. Review the Restore Backup Task Summary, and press Finish. Once the Restore Backup task completes, you will receive a successful message from the Gateway Task.

6. Now go to your Agent, and click Home. It takes a few moments to bring up the Gateway. You will see a progress bar while the Gateway is starting up. Once it’s complete, you will see all your projects uploaded and ready to go.

1.

Install Modules

As an example, suppose you accidentally uninstalled the Symbol Factory and Vision Modules from your Agent. Let's go ahead and reinstall them using the Install Modules task.

1. Go to the Controller, and navigate to Configure > Enterprise Administration > Agent Tasks. Click the Create new Gateway Task link.
   Select the Install Module task, and press Next.

   

2. Schedule the Install Module task to Execute Immediately, and press Next.

3. Select the Agent, and press Next.

4. From the list of Archived Modules, click the Add buttons for Symbol Factory and the Vision Module. You will notice, that once you click the Add button next to a module, it will show up in the Selected Modules box. You can choose as many modules as you need, and when you're finished, press Next.

   

5. Review the Install Modules Task Summary, and press Finish. Once the Install Module task completes, you will get a successful message from the Gateway Task.

6. Go back to your Agent, and navigate to Configure > Modules to verify that both the Symbol Factory and Vision Modules were successfully installed.

   

Restart Agent

Let’s go back to the Controller and create one more new Gateway Task called Restart Agent. This task will stop the Ignition service on the Agent and start it back up again.

1. Go to the Controller, and navigate to Configure > Enterprise Administration > Agent Tasks. Click on the Create new Gateway Task link.
   Select the Restart Agent, and press Next.

   

2. Schedule the Restart Agent task to Execute Immediately, and press Next.

3. Select the Agent, and press Next.

4. Review the Restart Agent Task Summary, and press Finish. Once the Restart Agent task completes, you will receive a successful message from the Gateway Task.

5. Go to your Agent and refresh your page. You will see a progress bar while the Gateway is starting up. This will take a few moments, and once this task completes, your Agent will be up and running.

Next...

• Agent Task - Send Project