The TED subscriber is responsible for receiving and extracting distributions, and validating that they come from an acceptable distributor and that the distribution file is accurate. The subscriber, when the extraction schedule starts, activates TED agents to unpack the distribution and handle the placement of the data in the distribution. If the subscriber should receive, with the distribution, a route that specifies that it send a distribution to other subscribers, the subscriber forwards the distribution to the next level of specified subscribers. The subscriber system on a server never accesses NDS. The distributor that is sending a distribution to this subscriber is responsible for communicating any information from the subscriber object to the subscriber software. The distributor sends configuration information to the subscriber only if the distributor has a newer revision of the subscriber object or the effective policy. The subscriber stores any changes in a configuration file so that the next time that it is started it loads the configuration information. All subscribers must have a copy of the digital certificate of the distributor to receive distributions from the distributor. If there is a distribution in the channel that is coming from a distributor for which the subscriber does not hold a copy of the distributor's digital certificate, the subscriber rejects the distribution. You can transmit the digital certificate manually, or ConsoleOne will attempt to contact the subscribers with a UNC path when a distribution is placed in a channel from a new distributor or when a subscriber is added to the channel. Over this connection, the digital certificates of all distributors (that currently have distributions in the channel) are sent and placed on the subscriber's file system. Perform the following steps to secure a copy of the digital certificates of the distributors that may be sent to the subscriber:
NOTE You can also use ConsoleOne to automatically resolve certificates for a specific subscriber, rather than a distributor. By right-clicking the subscriber object and choosing the Resolve Certificate option, the subscriber receives all certificates for all distributors that have distributions associated with the channels to which the subscriber is subscribed. The NDS Rights and Other pages are described in the sections of this chapter that discuss distributors. About the Settings Property PageThis page is found under the General tab and represents some general configuration settings that are effective for this subscriber. Figure 6.16 displays a capture of this screen. Figure 6.16. Settings property page of a subscriber object.On this property page, you can choose the following settings:
Focusing on the Messaging Property PageThe Messaging property page is under the General tab and can be configured by clicking the active tab and selecting the messaging value under the drop-down on the tab (which you find by pressing the small triangle in the tab). Figure 6.17 provides a sample Messaging page. Figure 6.17. Messaging property page of a subscriber object.For each of the appropriate fields, you may enter one of the message levels described in the section on distributors. You can administer the following configuration parameters on the Message property page:
Thinking About the Channels Property PageThis page of the subscriber object identifies the channels that this subscriber is going to receive distributions from. A subscriber may subscribe to many channels. To add a channel to the list, click the Add button and browse in NDS to the channel. Once this channel is added, it appears on the list. To delete a channel from the list, you must first select the channel and then click the Delete button. The subscriber will no longer accept distributions from this channel. You can view/edit the property pages of the channel by selecting the channel and clicking the Details button. The same distribution may be placed in more than one channel. It is possible that the same subscriber may be subscribed to multiple channels, and that more than one channel may want to distribute the same distribution. The distributor and subscriber keep a version number on each distribution and do not send the same distribution more than once to the same subscriber, no matter in how many channels the distribution is. About the Extract Schedule Property PageThe Schedule property page enables you to specify when and how often the extraction agents are called to dissect the distribution file and extract the files within, placing them in the file system of the server as specified in the distribution. Figure 6.18 shows a sample of this page. Figure 6.18. Extract Schedule property page of a subscriber object.If there is a Tiered Electronic Distribution policy in a Service Location policy package effective for the subscriber object, the check box for using the policy appears on this page. If there is no effective policy, the check box is not displayed. When this check box is activated, the schedule described in the policy is used for this subscriber. When unchecked, this subscriber has its own schedule and the Schedule Type field is available for administration. The check box is checked by default if there is an effective TED policy. This page enables you to select when the extraction agents should do their work on the subscriber server: Never, Daily, Monthly, Yearly, Interval, Time, or Run Immediately. After you have selected when you want the configuration applied, you have additional fields to select in the lower portion of the screen. The following sections discuss the various options you have. NOTE The default is Never. Therefore, the subscriber never extracts the files until you change the schedule. Remember, the configuration of the subscriber does not change until the next distribution, when the distributor sends the new configuration. NeverThis option loads the distributor with the configuration information only when it is first loaded on the server, after each reboot or restart. DailyWhen you choose to have the configuration applied to the system daily, you have the additional need to select when the changes will be made. This schedule requires that you select the days when you want the configuration applied. You select the days by clicking the days you want. The selected days appear as depressed buttons. In addition to the days, you can select the times the configuration is applied. These times the start and stop times provide a range of time when the configuration will be applied. You can have the configuration also reapplied within the time frame every specified hour/minute/second by clicking the Repeat the Action Every field and specifying the time delay. To keep all the distributors from simultaneously accessing NDS, you can select the Randomly Dispatch Policy During Time Period option. This causes each server to choose a random time within the time period when it will retrieve and apply the configuration. MonthlyUnder the monthly schedule, you can select which day of the month the configuration should be applied or you can select Last Day of the Month to handle the last day, because all months obviously do not end on the same calendar date. After you have selected the day, you can also select the time range when the configuration will be reread and applied. To keep all the distributors from simultaneously accessing NDS, you can select the Randomly Dispatch Policy During Time Period option. This causes each server to choose a random time within the time period when it will retrieve and apply the configuration. YearlyYou select a yearly schedule if you want to apply the configuration only once a year. On this screen, you must choose the day that you want the configuration to be applied. This is done by selecting the Calendar button to the right of the Date field. This brings up a Monthly dialog box, where you can browse through the calendar to select the date you want. This calendar does not correspond to any particular year and may not take into account leap years in its display because you are choosing a date for each year that will come along in the present and future years. After you have selected the date, you can also select the time range when the configuration should be read and applied. To keep all the distributors from simultaneously accessing NDS, you can select the Randomly Dispatch Policy During Time Period option. This causes each server to choose a random time within the time period when it will retrieve and apply the configuration. IntervalThis schedule type enables you to specify how often to repeatedly read and apply the configuration. You can specify the interval with a combination of days, hours, minutes, and seconds. This type waits for the interval to pass first before applying the configuration for the first time and then for each sequence after that. TimeThis allows you to specify a specific calendar date and time when the configuration will be applied. When the current date on the server is beyond the identified date, the configuration will be applied. Run ImmediatelyThe distributor does not use this scheduled type, but it is used by other components. It is described here for completeness in describing all the possible schedulers. With the Run Immediately schedule type, the schedule causes the activity to occur the first time that the associated object is activated. You may also specify a repeat interval in days, hours, minutes, and seconds. If no repeat interval is specified, the action runs only once, until the object is restarted or refreshed. Variables Property PagesVariables enable you to substitute a variable name in the distribution with the value specified in the subscriber. When you create a distribution, you may use variables in the volumes and directory names, for example. When the distribution is sent to the subscriber and the extraction agent is called, the agent replaces these variables with their defined value in the subscriber object. If no value is given, the variable name (including the % percent sign) is used for that value. If a Tiered Electronic Distribution policy in a Service Location Policy package is in effect for the subscriber, the check box for using the policy appears on this page. If there is no policy, the check box is not displayed. When this check box is activated, the variables described in the policy are used for this subscriber, in addition to the variables that you define in the subscriber. When unchecked, this subscriber has its own independent variables. If there is a duplicate, the subscriber's definition is used. This enables you to override a specific variable from the policy, while still accepting the other variables from the policy. Unlike ZENworks for Servers policies and software distribution packages, the TED software performs only basic substitution of variable to value and does not enable you to reference an NDS object or its attribute. This eliminates the requirement that the subscriber have access to NDS and all the objects in the tree. This would be especially difficult if the subscriber were an external subscriber not even in the same tree as the distributor! For example, if you create a distribution and specify %DEST_VOLUME% as the volume name, when the subscriber extracts the files, the agent substitutes the variable DEST_VOLUME defined in this property page with the value. If DEST_VOLUE is not defined, then a directory called %DEST_VOLUME% is created in the SYS volume. Remember to be consistent in your conventions and your variable names. You should probably come up with a set of common variables that you define with each subscriber that you set up. Then when you create a distribution, you can use these variables in defining the directories where the distribution will be placed. Remember, the subscribers that receive the distribution are based purely on who subscribes to the channels where you place the distribution. If you are not consistent in your variable names across all subscribers, you may inadvertently send a distribution to a subscriber that does not have the variable defined; this results in the distribution being extracted in a place you do not expect (probably on the SYS volume). Some variables that you should consider defining in each of your subscribers include the following:
|