You may also install all BRU Server component packages under OS X using Apple Remote Desktop.

 

 

 

This update for BRU Server will properly update a 1.1.5 server version.  All settings, jobs, schedules, and users are retained during the update.

 

 

If you do wish to make copies of the BRU Server server environment, please refer to Appendix C in the BRU Server 1.2.0 Admin Guide.

 

You may configure the BRU Server components graphically or via command line.  In either case, you must configure the server component prior to configuring any agent components.

 

Authenticate as your system administrator (not the same as the BRU Server "admin" account)

 

 

 

Once the password is assigned, the server daemon will be started.

If you wish to have the BRU Server server daemon started at boot, simply click the  "Auto" button to remove the daemon from the Startup Items and set server startup to manual.

 

 

 

 

Click the Additional Clients checkbox and the license panel will change as shown above.  Be careful to enter the appropriate serial number into the appropriate field before you save the entries.

Once the Password and License information have been properly added, you are now ready to configure any client systems.

 

 

Connect to your server system via ssh or open the Terminal.

Execute the following commands and respond to the prompts:

 

 

        (Enter your new BRU Server "admin" Password – will not be echoed)

 

The BRU Server server daemon will start as a background process.  To check the status, you may monitor the server log file using the "tail" command:

 

 

Your output should look something like:

 

 

To exit the tail function, type CTRL-C.

 

 

Authenticate as your system administrator

 

 

For any BRU Server server to provide backup services for a client system, that client system must contact and authenticate with the appropriate server system.  To authorize and authenticate a server, click the "New" button.

 

 

You will then be prompted to enter the server name and admin password information (shown above).  The password is the BRU Server admin password that you assigned when you configured the server system.  The Server name or IPv4 address may be an internal short hostname, a fully qualified domain name, or a standard dot-notation IPv4 address.  You may authorize multiple servers to provide backup services for a single client system.  Once the server is authorized, the Agent Config Tool display will appear as below.

 

Additionally, the Agent Config Tool allows you to control the Agent startup and manually start or stop the Agent daemon.  Use the two buttons in the lower right of the window to control boot-time starting of the Agent or to stop/start the Agent manually.

 

To de-authorize, or delete a server for a given client, select the appropriate server from the listbox and click the Delete button.  The deleted server will no longer be allowed to connect to this client system.  Please be sure to also remove the client system from the server’s database and any backup jobs to which it may have been assigned.  If you do not remove the client system from the server, no harm will be done, but you will receive an error in the job logs indicating that the system could not be contacted.

 

Connect to your server system via ssh or open a Terminal.

Execute the following commands and respond to the prompts:

 

 

The agent tool will allow you to authorize servers as above using a text-based menu system.

 

 

Type an "N" to add a new server to the list and respond when prompted:

 

 

You may continue to authorize additional servers, or simply hit RETURN to save the current settings and exit.

 

 

You may also send the agent configuration sequence to a group of managed OS X systems using ARD's "Send a Unix shell command to Target Computers".  Select the appropriate computers ARD console and select the Manage -> Send UNIX Command... menu option.  The command to send is a single line and consists of the command, the server that will be authorized to backup the systems followed by the BRU Server admin password:

 

 

Note that there is no space between the server name, the comma, and the password.

 

Once you’ve completed the server and agent setup, the next step is to create a backup job definition, define the data to be included, and set the job schedule.

 

You may use the graphical interface or either of the command line interfaces to perform these tasks.  For this simplified tutorial, we will utilize the BRU Server GUI Console.

 

Start the GUI Console and you will be greeted with the Login window.

 

To login to your BRU Server server:

 

 

Hit ENTER or click the "Login" button to connect to the BRU Server server and login.

 

 

 

Once the user and password are accepted, the BRU Server Configuration Assistant is displayed.  If you wish to continue with the assistant, step through each of the panels and respond as necessary.  However, for this tutorial click the "Skip Assistant and Configure Manually" checkbox since this tutorial does not require changes to the installation defaults.  

 

In either case, the main BRU Server console window is displayed next.  Please wait while the interface communicates with the server to load information about the server status.  This may take a minute, so please be patient.  Because BRU Server is a true client-server application, the console is simply a view into the state of the server system and must communicate with the server to update its displayed information from time to time.

 

The first step in creating a backup job is to name the job.  Click the "New" button or select New Job from the File menu.  You will see the New Job Name dialog.

 

For the tutorial, we will name the job "QuickStart Demo" and leave the destination set to the "Stage Disk".  Click "Ok" or hit the ENTER key to continue.

 

The next tip dialog informs you of the remaining steps required before you’ve actually created a job.

 

If you do not want the console to remind you of these steps each time you create a new job, click the "Do Not Show Again" checkbox.

 

Click the "Ok" button to continue.

 

Expand the client system entry for your client by clicking on the disclosure triangle to the left of the system name.  To match the steps in this tutorial, you should expand a Mac OS X client system.

 

Next, expand the root volume and scroll down to the "Applications" folder.  Expand the "Applications" folder and single click on the entries for "Address Book.app",  "Applescript", and a few other applications (we chose around 150MB for this tutorial).  Your selection list should look something like the figure below.

 

Check the Email checkbox and set the appropriate email address in the Email field. The next step is to save these settings.  While we could simply run this job now without saving it, we want to save in this case so we may reuse the job later in the tutorial.  Click the "Save" button to continue.

 

Next, we want to schedule the job, so answer Yes or hit the ENTER key to continue.

 

For our tutorial, select "Daily" from the How Often popup menu and set the "Every" value to "2".  This setting means that this job definition is to be run daily, every other day, at the time specified starting on the date specified.  The current values assigned to the date and time fields are the current day and time.  For now, accept the date and set the time 5 minutes into the future.  Click the "Save" button to continue.

 

To see that the job has been scheduled, click on the "Data Manager" tab and then select "Schedules" from the popup menu.

 

If you click on the "QuickStart Demo" entry, the Command field will list the actual command that the server daemon will execute to perform the specified job.  Wherever possible, the console will disclose the command line that will be executed.

 

If you wished to remove this job from the scheduler, click the "Delete" button.  To Change the schedule, click the "Change" button.  For now, leave the job as it is and click the "Tools" tab.

 

The default panel on the Tools tab is the "Job Monitor" panel.  This panel displays all active jobs and allows you to monitor them or stop/cancel them.  

 

If your scheduled job has not started, wait until the time that you specified and its entry will appear in the upper list box as shown above.  Once it appears, click on the entry and then click the "Monitor" button.  The Monitor window will open and you will be monitoring the operation of your scheduled backup.

 

The Monitor window allows you to view the operation, but does not allow you to physically interact with the running job.  In fact, you could be monitoring this job for a dozen or more locations within your network and none of the Monitor windows would interfere with the others.  The Monitor window displays the current job name, owner, current file being processed, a count of files processed, and the amount of BRU data that has been processed.

 

If you wish to see more of the behind-the-scenes info, you may check the "Detail Display" check box and the Monitor window will expand to show more information about the job.

 

The "Detail Display" provides additional information from the server concerning this job.  The values displayed in the bottom panel are instantaneous snapshot values and are really only useful for troubleshooting network problems.  Do not look at them as representing the actual final throughput of your backup as they are an average number of the past 30-seconds of the backup operation.

 

If the job has not finished, click the "Close" button and watch the Job Monitor panel in the main window.  When the job completes, it will be removed from the list.

 

Once the backup and verify is completed, you will find information about the job in the History database and the Archives database.  In this instance, there will be no entry in the Tapes database since the backup was written to the Stage folder.  Also, a summary email will be sent to the address that you entered in the Email field.

 

To see the history report for this operation, open the Data Manager panel and select the History option from the popup menu.

 

In this case, there is only one entry – the backup and verify that we just ran.  By selecting it in the top list, the actual history information will be displayed in the lower list.  All pertinent information about each system selected in this job will be listed.  At the end of the history report will be a summary for the entire job as shown below.

 

The final step in this tutorial is to restore an application.  We have chosen to restore the "Address Book" application.

 

Open a Finder window and go to the Applications folder.  Find the "Address Book" and rename it to "Address Book Original" as shown in the next figure.

 

Next, select the Restore tab to display the Restore panel.  Expand the client system that we just backed up and the expand the archive as shown.

 

Next, select the "Address Book.app" entry

 

Finally, click the "Restore" button.  BRU Server will verify that you wish to restore by displaying a verification dialog.  Click the "Yes" button to continue.

 

The Monitor window will be displayed and the progress of the restore will be shown.  This particular example will not take long.

 

To check the success of the restore, return to the Finder window and you will see your "Address Book Original" along with the restored "Address Book" app.

 

This concludes the QuickStart tutorial.  For more in-depth information on BRU Server management and operation, please refer to the BRU Server Admin Guide.