Syscm1 Agd en
Syscm1 Agd en
Administration Guide
SYSCM240400-AGD-EN-01
OpenText™ System Center Manager
Administration Guide
SYSCM240400-AGD-EN-01
Rev.: 2024-Sept-24
This documentation has been created for OpenText™ System Center Manager CE 24.4.
It is also valid for subsequent software releases unless OpenText has made newer documentation available with the product,
on an OpenText website, or by any other means.
Tel: +1-519-888-7111
Toll Free Canada/USA: 1-800-499-6544 International: +800-4996-5440
Fax: +1-519-888-0677
Support: https://support.opentext.com
For more information, visit https://www.opentext.com
Disclaimer
Every effort has been made to ensure the accuracy of the features and techniques presented in this publication. However,
Open Text Corporation and its affiliates accept no responsibility and offer no warranty whether expressed or implied, for the
accuracy of this publication.
Table of Contents
1 System Center Manager ............................................................ 9
1.1 Overview: The System Center Manager Lifecycle ................................ 9
1.1.1 Add Systems and Products .............................................................. 10
1.1.2 Download and Install OpenText Software Products ........................... 11
1.1.3 Patch and Update OpenText Software Products ................................ 11
4 Systems .................................................................................... 19
4.1 View Systems Information ............................................................... 19
4.1.1 The Systems Overview .................................................................... 20
4.1.2 The System Details View ................................................................. 20
4.2 Add and Remove Systems .............................................................. 22
4.3 Register and Unregister Systems ..................................................... 23
4.4 Enable and Disable Systems ........................................................... 24
4.5 Discover Product Component Instances ........................................... 24
4.6 Enable and Disable Product Component Instances ........................... 25
4.6.1 Enable Content Server Product Instances ......................................... 25
4.6.1.1 Enable a Content Server Master Server ............................................ 26
4.6.1.2 Enable Additional Content Server Instances ..................................... 27
4.6.2 Disable a Product Component Instance ............................................ 29
System Center Manager is used to manage remote computers, or Systems. You start
by installing the System Center Agent on a System, and then registering the System
in System Center Manager, making it a managed System. You can then use System
Center Manager Execution Plans to perform a variety of preset tasks on the System,
including installing supported OpenText software products on it.
You can also use System Center Manager to keep your supported OpenText
software products up to date, using its built-in patching and updating capabilities.
System Center Manager has a manifest that is updated daily, making it aware of
software patches and updates as soon as they become available. System Center
Manager handles the entire patching process. It downloads patches and updates and
applies them automatically and systematically.
Each of the main steps in the System Center Manager lifecycle is briefly described in
this section, and in greater detail later in this online help.
Tip: For more information, see “Install the System Center Agent on Windows”
on page 101 or “Install the System Center Agent on Linux” on page 104.
After you install the Agent software, the System becomes visible in System Center
Manager. Register the System on the Systems overview.
On a registered System, run Product discovery and enable any Product Component
Instances that you want to manage using System Center Manager.
After you have registered a System and discovered any software on it, the state of
the System determines your next step:
• If the registered System does not currently run supported OpenText software,
you can use System Center Manager to install a software product. See
“Download and Install OpenText Software Products” on page 11.
• If the registered System is already running supported OpenText software, you
can use System Center Manager to keep it up to date. See “Patch and Update
OpenText Software Products” on page 11.
Note: Software download and Execution Plans are not available in all versions
of System Center Manager.
Tip: For more information, see “The Product Catalog“ on page 59.
Tip: For more information, see “Execution Plans, Steps, and Variables“
on page 63.
Tip: For more information, see “The Products Page: Updates View”
on page 33
Download Updates
When System Center Manager informs you that a patch or update is available, you
can download it automatically if you operate in online mode. In offline mode, the
process is similar to updating the manifest: you download any updates to a
computer that can connect to the Internet and then upload them to System Center
Manager.
The System Center Manager Home page provides you with an at-a-glance view of
the state of your current Solution Environment. It informs you of operations that you
may need to perform and of messages that you may need to view.
You can access the Home page any time by clicking Home on the Navigation
The Systems by status tile has a pie chart with segments that show the proportion of
Systems in your Environment that are online, offline, unregistered, or disabled. To
view the absolute number of Systems in any category, hover over the relevant chart
section. You can include or exclude Systems from the pie chart by clicking Online,
Offline, Unregistered, or Disabled.
Notifications may be informational only, or they may indicate that you need to
perform an action. For example, a notification may inform you that a Component
Instance was recently enabled. In that case, it confirms the successful completion of
an action that you performed. Another notification could indicate that a new System
is available to be registered. In that case, action is probably required: you need to
register the System and enable its Component Instances.
To view a complete listing of available notifications, click the Notifications tile and
then click the Open notifications button to open the Activities page: Notifications
view.
Click any listed System to open its Details page. Click the Open Systems button
Click any Product to view its Overview page, where you can view information on
the Updates that are available.
Tip: If you have access to more than one Solution Environment, you can use
the Change Environment option on the User Menu to change the Environment
that you are working in. The User Menu appears in the top right corner of the
System Center Manager interface. Its appearance varies according to the
The terms Environment and Solution have special meanings within System Center
Manager.
Environment
An Environment is a group of Systems that run OpenText software Products and
third-party applications to deliver a software service. For example, a Content
Server Environment might consist of several Systems that run instances of
Content Server, with additional host computers providing the web server and
database management software that Content Server requires.
Organizations typically have multiple Environments that deliver the same
software service. For example, your organization might have QA, Dev, and UAT
Environments that support a Production Environment. In such a setup, each
Environment runs the same software, but not on similar computers or
configurations. For example, a Production Environment might run a software
service on numerous higher-powered machines, whereas a Dev Environment
might run every Product and supporting application in the software service on a
single host computer.
Environments are central to System Center Manager. Your view of System
Center Manager is determined by the Environment that you are working on.
When you are working on an Environment, you see only the Systems and
Products that belong to that Environment. Any Execution Plan that you create
applies to your current Environment. When you apply updates to Products, only
the Systems in your current Environment are updated.
Content Server : Production Environment. It does not apply patches to the Content
Server computers in any other Content Server Solution Environment.
Solution
A Solution is used to group Environments that provide a similar software
service. You can place Environments in Solutions according to the needs of your
organization.
Example: An organization could have a Content Server Solution that includes the
following Environments:
• Content Server : QA
• Content Server : Dev
• Content Server : UAT
• Content Server : Production
In System Center Manager, you can see any Execution Plans that are created
within your Solution. This means that you can create an Execution Plan in a
given Environment (Development, for example) and then copy that Execution
Plan into another Environment (Production, for example), where it can be re-
used. For more information, see “Execution Plans, Steps, and Variables“
on page 63.
Note: If, you attempt to log on and System Center Manager displays the
message Access denied; please contact administrator, it is possible that you
are not assigned to any Environment. If so, your administrator can correct the
problem by assigning you to an Environment.
Systems run the System Center Agent software. The System Center Agent connects
them to System Center Manager, and provides information on the OpenText
software that they run. System Center Manager can install software, apply Updates
and configuration changes, and perform other administrative tasks on registered
Systems.
After you install the Agent, a System appears in System Center Manager as a
pending unregistered System. To manage a System, you must first register it, and
then enable each Product Component Instance that you want to manage on the
System.
Unregistered Systems are visible in every Solution Environment until they are
registered. After a System is registered, it is visible only in the Environment that it is
registered in.
Managed Systems
Managed Systems are Systems that have been registered and that can be
configured and updated using System Center Manager. They can have an Agent
•
On the Systems Overview page, click the Details button in a System’s
Inline Action Bar.
• Click the System in the Systems Available area of the Systems page
• General
• Products
• Networking
• Operating System
The buttons and operations that are available on the System Details view depend on
whether the System is registered or not. For information on the various operations
enabled by the available buttons, see the following topics:
To check if new Products have been added to the System since the last discovery
date, you can click Discover Products to update the list.
For instructions on installing the System Center Agent, see “Settings: Agents”
on page 101.
Tip: If you need to re-add a System, restart the Agent on the System host
machine.
Remove a System
To remove a registered System, you must first unregister it. (See “Register and
Unregister Systems” on page 23.) A registered System cannot be removed.
• Open the System Details view of the System that you want to remove and then
click Remove.
•
On the System’s Inline Action Bar, click the Remove button .
Optionally, you can uninstall the System Center Agent from the System. If you do
not uninstall the Agent and the Agent software is restarted, the System will attempt
to register with System Center Manager again.
Tip: After you register a System, enable any Product Component Instances on
the System that you want to manage. See “Enable and Disable Product
Component Instances” on page 25.
Registering a System
You can register a System on the Systems Overview page or on the System Details
view. Before you register a System, ensure that you are logged on to the Solution
Environment that you want to add the System to.
To register a System:
• In the Pending tab of the Systems Overview, click the Register button
in the System’s Inline Action Bar.
2. Select the I agree to register this system in the current environment check box.
Unregistering a System
If you no longer want to use System Center Manager to manage a System, or if you
have assigned it to an incorrect Environment and want to assign it to the correct one,
you can unregister the System.
Tips
• To stop managing a System temporarily, disable it. See “Enable and Disable
Systems” on page 24.
To unregister a System, click the Unregister button on its Inline Action Bar or
open its System Details view, and then click Unregister system.
Tips
Enable a System
You can enable a System that has a status of Disabled by clicking the Enable
button on its Inline Action Bar, or by clicking Enable on its System Details
view.
Disabling a System
If a System appears on the Systems overview with a status of anything other than
Disabled, it is enabled. You can disable it on its System Details view.
You can disable it by clicking the Disable button on its Inline Action Bar, or by
clicking Disable on its System Details view.
Tip: You can discover products only on a System that is registered, enabled,
and available, and that has an status of Idle or Running. If a System is
unavailable, its Discover Products button is dimmed and cannot be used.
After you click Discover Products, information on the Product discovery operation
is available on the Activities Overview.
Product Component Instances are enabled on the Products tab of “The System
Details View” on page 20. To enable a Component Instance, click Enable in the
Inline Action Bar for the Component Instance, or select the check box beside the
Product Component Instance and click Enable at the top of the list of Product
Component Instances.
After you click Enable, you are prompted to analyze the Product Component
Instance. System Center Manager performs the Download, Validate, and Update
steps, and then enables the Product Component Instance. To view information on
the Enable Component Instance operation, you can look in the Other tab of the
Activities Overview.
After you enable the first Instance of a Product Component, information on that
Product and Component becomes available on the Products page. If you have not
enabled any Instances of a specific Product Component, no information about it
appears on the Products page.
When you enable an additional Content Server instance, System Center Manager
analyzes the new instance and compares it to the Master Server. If necessary, it
brings the new instance up to date with the Master System by adding any missing
patches, Updates, and language packs. After an instance is enabled and brought up
to date, its Windows service is shut down, with its Startup Type set to Manual. This
allows you to perform any necessary work on the instance after it is brought up to
date before it is started up again.
Tip: You can change the instance that is the Master Server on the Content
Server Product Component view of the Products page. Enable Master System
in the row of the Content Server Instance that you want to make the new
Master Server. You are prompted to provide the same information as you did
for the previous Master Server.
1. In the Products tab of the System Details view, do one of the following:
• Click Enable in the Inline Action Bar the Content Server instance that
you want to enable.
• Select the check box beside the Content Server instance that you want to
enable, and click Enable above the Product Component Instance listing.
3. On the Enable component instance ‘Content Server’ dialog box, enter the
following connection parameters for the Content Server Instance and then click
Validate.
Note: For an https:// connection, you must enter the name of the
host as it appears on the server certificate.
c. In the Port box, enter the IP port for connecting to Content Server. You
must enter a port number even if Content Server uses the default port for
http or https.
d. In the Path box, enter the remainder of the Content Server URL. Enter the
portion of the Content Server URL that follows the web server name and
port and precedes the question mark (?) For example, if the address of your
Content Server Administration page is http://example.corporate.com/
OTCS/cs.exe?func=admin.index, enter OTCS/cs.exe
e. Enter the name of a Content Server user that has the System
administration rights user privilege in the User name box.
After you click Next, System Center Manager enables the Product Component
Instance. You can view more information on the Enable Component Instance
operation on the Activities Overview page.
5. Click Finish to complete the operation and return to the Products tab of the
System Details view.
After the Master Instance is enabled, it appears in the Content Server Product
Component view on the Products page, with a check mark icon column.
When it attempts to enable the new instance, System Center Manager first analyzes
it and then attempts to bring it up to date (if necessary) by configuring it with the
patches, Updates, and language packs that are present on the Master Server. If it
finds potential problems during its analysis of the new Content Server instance,
System Center Manager pauses the enablement and displays a warning. Several
different types of warnings may appear.
1. In the Products tab of the System Details view, do one of the following:
• Click Enable in the Inline Action Bar of the Content Server instance
that you want to enable.
• Select the check box beside the Content Server Instance that you want to
enable, and click Enable above the Product Component Instance listing.
If there are no issues that require your attention, click Next to proceed to the
Download page, where you can see a list of the required packages and their
Status
3. If there are no problems with the downloaded packages, click Next to proceed
to the Validate page.
5. The Update page displays the Content Server instances that will be updated on
the Instance tab and the packages to be applied on the Packages tab. When you
are ready to apply the Updates, click Install.
Tip: Language Packs that are installed on the Master Server are added to
the new Content Server instance when it is enabled, if they are not already
present.
6. Perform any additional required work on the new Content Server instance.
When it is ready, start the Content Server service and (if applicable) the Content
Server Admin service. Change the Startup Type of these services to Automatic,
if desired.
Important
All Content Server Instances must be enabled. Do not disable an instance of
Content Server in a Content Server cluster. For System Center Manager to
update the Content Server instances in a cluster, each one must be enabled. If a
single Content Server instance is disabled, System Center Manager cannot
update any of the instances in a Content Server cluster.
1. Open the System Details page of the System that runs the Product Component
Instance that you want to disable.
2. On the Products tab, disable the Product Component Instance in one of the
following ways:
• click the Disable button on the Inline Action Bar of the Product
Component Instance.
• Select the check box beside the Product Component Instance and then click
Disable at the top of the Product Component Instance listing.
After you disable a Product Component Instance, it appears with a status of Not
In System Center Manager, the words Product, Component, and Instance have
precise meanings.
A Product and a Component may have the same name. For example, Content Server
is a Product, but it is also a Component of the Content Server Product.
• the Products and Components that System Center Manager can configure
• the Systems that run these Product Components
• the Updates and patches that System Center Manager can apply to the Product
Component Instances
Tip: The Products page does not display Product Installers that you have
downloaded from the Product Catalog. To view Product Installers that you
have downloaded and that you can use to install Products on Systems using an
Execution Plan, open the Product tab on the Downloads view of the Activities
page.
Each Product is listed on the left. If you expand a Product node, System Center
Manager displays the Product Components that belong to the Product. For example,
if you have enabled Archive Center on one of your registered Systems, Archive
Cache Server and Archive Monitoring Server appear when you expand Archive
Center.
For each Product, you can choose to view the Product Details view, Component
view, or Updates view. Each view presents different information.
The Content Server Product and its Product Components appear on the
Products page, but Document Pipeline does not.
Available Updates are listed by Product. The listing is refreshed daily. To perform
an immediate check for newly available Updates, click Check for Updates on the
Manifest view of the Settings page. (See “Update the System Center Manager
Manifest File” on page 47.)
To view additional information on any Update, open the Details view, using one of
the following methods:
•
Click the Details button on the Update’s Inline Action Bar.
• On the Patches or Languages tab, select the check box of the Update, and then
click Details at the top of the Updates list.
To download Updates, select them and click Download <#> item(s). For more
information, see “Obtain Updates in Online Mode” on page 49.
To export a list of download links for the Updates that you have selected, click
Export metadata. You can choose to obtain the list as a CSV comma-separated
values file or as a Web page. For more information, see “Obtain Updates in Offline
Mode” on page 49.
Tip: You can also perform the Export metadata operation on the Review step
of the <Product Component> Deployment page.
The Update Details page provides basic information on Updates that are handled by
System Center Manager. It includes some or all of the following information:
Name
The name of the Update.
Description
A brief description of the Update. The description may include the change made
by the Update, the issue resolved by the Update, and an issue number from the
OpenText issue tracking system.
File Name
The name of the Update file.
Size
The size of the Update.
Impacts
A description of the effect that the Update has on your Product Component
deployment
Requires
Prerequisites for the Update.
Deprecated update
If the listed Product version (or later) is running on the System, the Update is
deprecated. If None, the Update is suitable for use on any platform listed in the
Requires field.
Public
If Yes, the Update is publicly available.
Retired
If Yes, the Update has been retired.
Modules
The module that the Update applies to. If empty or None, the Update applies to
the base Product Component.
Supersedes
If an Update appears in this field, the current Update replaces it. If the
superseded Update is present on your System, it is automatically removed when
you install the current Update.
Superseded by
If an Update appears in this field, the current Update is replaced by it.
Normally, you should download and install the Update that appears in this field
instead of using the current Update.
To see the Product Details view, click a Product under Installed Products on the
left.
Pending
The Pending tab shows Updates that you have downloaded. Updates in this
view are ready to install. Several operations are possible on the Pending tab:
Install Updates
To install Updates, select one or more Updates, and then click Next. For
more information, see “Apply Updates” on page 50
Remove Updates
To remove an Update from System Center Manager (if you know that you
will never want to install it, for example), do one of the following:
•
Click the Delete button in the Update’s Inline Action Bar.
• Select the check box beside the Update and then click Delete at the top of
the Update list.
•
Click the Details button in the Update’s Inline Action Bar.
• Select the check box beside the Update and then click Details at the top
of the Update list.
Installed
The Installed tab shows Updates that you have downloaded and applied to one
or more Product instances, and the status of each Update.
To see the Component view, expand a Product under Installed Products on the left,
and then click one of its Components.
The Component view lists each System that runs the Component that you have
selected, and shows the Install path, Version, and Platform of each Instance of the
Component. It also shows the System’s Agent status and, if applicable, whether a
System is the Master System or not.
Click the Details button in the Inline Action Bar of any Component instance to
open its Component Instance Details page.
The Component Instance Details page has two tabs: Overview and Modules:
Update Analysis
Update analysis provides information on the changes that a Content Server
Update will make to your system. For information on running Update analysis,
see “Update Analysis (for Content Server Updates)” on page 57
Resynchronization
To ensure that the information that System Center Manager has about your
Content Server Product Component instances is up to date and accurate, click
Resynchronization. For information on resynchronizing your Content Server
instances, see “Resynchronize a Content Server Product Component instance”
on page 58
Administration Settings
Content Server allows you to export all or some of the existing Administration
Settings from one Content Server instance and apply them to a different Content
Server instance. You can use System Center Manager to apply an
Administration Settings file to the Content Server instances that it manages. See
“Apply an Administration Settings file to Content Server” on page 39.
On the Content Server Product Component View, you can apply an Administration
Settings file to the Content Server instances that are managed by System Center
Manager.
Caution
Content Server Administration Settings files can contain two types of
settings: settings that need only be applied once to affect every instance in
the cluster and settings that need to be applied to each instance separately.
System Center Manager does not distinguish between these two types of
setting. It is important that you understand which kind of settings you are
applying, so that you can apply them properly.
You can apply the Administrations Settings file to one or more instances of the
Content Server Product Component. When you select the instances, note whether a
web address appears in the URL column. If not, you will be prompted to provide the
URL. Normally, the URL appears only for the Content Server Primary system, and
you must provide it for any other instances in the cluster.
1. On the Product Component View of the Products page, select a Content Server
Product Component.
2. On the Content Server Product Component view, select one or more instances
of Content Server.
Note: If you select an instance that has no data in the URL column, the
Validate instance URL dialog box will appear and you will be prompted
to provide logon information for the instance. To provide this information
beforehand, click the Set instance URL button in the Inline Action
Bar of the instance.
3. Click Administration Settings on the Action Bar. (If you select a single
instance, you can click Administration Settings on the instance’s Inline Action
Bar.)
4. The Administration Settings for Content Server <##.#.#> view opens. Click
Browse on the Pre-defined administration settings file box. Browse to an
Administration Settings file and select it.
5. Click Upload. The Sign in dialog box appears. In the URL box, it displays the
address of your Content Server deployment. Enter the user name and password
of a Content Server administrator. Select I have read the statement above and
wish to proceed and then click Authenticate.
6. A message informs you that the Administration Settings activity was started.
Then a second message informs you: Administration Settings activity is
currently running, this page will be temporarily disabled until the activity is
complete. View details.
Click View details to open the Activities Overview page, where you can view
the Apply Administration Settings activity.
The information on the Search Patches page appears in a table. The Status of each
. For an explanation of the information in the other columns, see “The Update
Details page” on page 35.
To show or hide the columns on the page, click the Column Settings button.
To assist you in finding patches, you can order the Name column and filter all of the
columns except the Status column.
•
To order the Name column, click the Name - click to Sort ascending button.
Click again to sort the Names in descending order.
•
To search any column, click the Search <Column_Name> button.
To save information on any patch that you select, click the Export Metadata
button on the item’s Inline Action Bar to save the information. You can export the
information as a CSV or HTML file. To save information on multiple patches, select the
patches and click Export Metadata on the Action Bar.
Note: The Logs Package feature collects existing logs. It does not manage logs
or set log levels. If you have been advised by OpenText Customer Support to
set a specific log level or repeat a certain operation, do this within the managed
application before you use System Center Manager to generate a Logs Package.
System Center Manager keeps up to three Logs Packages for each Product Version.
If you attempt to generate a fourth Logs Package for a given Product Version,
System Center Manager will offer to delete the oldest existing Logs Package (unless
When a Logs Package creation request is submitted, the status of the job goes from
You can monitor the creation of a Logs Package on the Activities Overview. To view
details on a Package product logs job, click the Details button . General
information is available on the General and Summary tabs. Detailed information for
each selected System and Product Component Instance is available on the Systems
tab. Click View Details to see information for a specific Product Component
Instance. Events are also written to the Audit log for each Logs Package creation,
download, and deletion.
You can download and delete completed Logs Packages on the Download Logs
Packages page.
A Logs Package has a standard structure that helps anyone who examines the log
files to quickly understand what it contains:
• The name of the file is the name of the Logs Package plus the date and time that
it was generated plus logs.zip. For example, a Logs Package called Critical
Logs, generated on August 25, 2022 at 12:31:44, has the name Critical_Logs_
2022-08-25-12-31-44_logs.zip
• The Logs Package ZIP file contains a ZIP file for each System that provided logs.
• Each System ZIP file contains a ZIP file for each Component Instance that
provided logs.
• Each Component Instance ZIP file contains the logs that you requested when you
generated the Logs Package.
Two types of manifest file also aid in understanding the contents of the Logs
Package.
Package button .
• Select the Product Component, and click Create a Logs Package at the top of
the Component list.
2. The Create a Logs Package page opens. It displays the supported log file types
as options and lists the Instances of the Product Component. Configure your
Logs Package as follows:
3. Click Start to initiate the Logs Package creation, and click Yes on the
confirmation dialog box.
4. A dialog box requesting additional information may appear for some Products.
Log on as an administrative user, if you are prompted to. You may also need to
verify or correct the URL of the Product. Once you have entered the required
information, click Authenticate.
5. The Download Logs Packages page opens. When the status of the Logs Package
Packages button .
• Select the Product Component, and click Download Logs Packages at the
top of the Component list.
2. The Download Logs Packages page opens. It lists any existing Logs Packages
that have been previously generated for the selected Product Component. To
Packages button .
• Select the Product Component, and click Download Logs Packages at the
top of the Component list.
2. The Download Logs Packages page opens. It lists any existing Logs Packages
that have been previously generated for the selected Product Component. To
delete a Logs Package, do either of the following:
• On the Inline Actions Bar of the Logs Package that you want to delete, click
Delete .
• Select one or more Logs Packages and click Delete at the top of the Logs
Packages listing.
System Center Manager automates each step of the software patching process. Using
an up-to-date copy of its manifest file, it displays the Updates that are available on
the Updates view of the Products page. It automatically downloads any Updates
that you select. When you are ready to apply the downloaded Updates, System
Center Manager deploys them on every Product Component Instance in your
Solution Environment.
Tip: If the System Center Manager manifest becomes corrupt or unusable for
any reason, you can purge it and import a fresh copy. See “Manifest Repair”
on page 123.
are ready to download. If you operate in online mode, you can download Updates
directly from System Center Manager. In offline mode, you must download Updates
on an Internet-connected computer and then add them to System Center Manager.
To view the progress of active downloads, click the Download button that
appears at the top of any System Center Manager page, or open “The Activities
Page: Downloads View” on page 85.
1. Obtain the Updates that you need in one of the following manners:
the Products page. Click the Download button beside any Update that
you want to obtain. Log on to OpenText My Support if you are prompted to.
Your browser downloads the Update. Repeat this step for every Update that
you want to obtain.
2. After you have obtained the Updates, click the Upload button that appears
at the top of any of the Product page views.
3. Drag the Updates onto the Upload page or click Add files, browse to the
location of the Updates, and select them.
4. The Updates now appear on the Upload dialog box with a status of Pending. To
upload them to System Center Manager, click Continue.
5. After you have uploaded the files, click Close to exit the Upload page.
Patches
Content Server patches work with specific Content Server quarterly Updates.
On the Patches tab, you can select patches that apply to the Update that you are
downloading. The patches that you select are downloaded along with the
quarterly Update. You can install them when you install the quarterly Update,
or afterwards if you prefer.
Languages
The Languages tab allows you to select Language Packs for installation on your
Content Server deployment. If you operate a multilingual installation of Content
Server, System Center Manager automatically selects any languages that you
have already installed. You cannot disable these selections.
To install a new interface language for Content Server, select it so that it is
included with the download of the quarterly Update. Any Language Pack that
you download with a quarterly Update will be installed when System Center
Manager installs the Update.
Tip: The following instructions demonstrate how to apply Updates that you
select manually from the System Center Manager user interface.
You can also apply Updates by using the Synchronize button that is
available on the Solutions view of the Settings page. This function analyzes
the Updates that are present on a Product in a source Environment, compares
them to those that are present on the same Product in a target Environment,
and then applies any missing Updates to the Product in the target
Environment. The result is that the Product in the target Environment has the
same Updates as the Product in the source Environment.
1. On the Details view of any Product on the Products page, Updates that are
ready to be applied appear on the Pending tab. Select the Updates that you
wish to install, and then click Next.
2. For certain Product Updates, the Release Notes page appears. It displays any
critical issues that are documented in the product Release Notes, along with a
link to information on each issue and a link to the latest product Release Notes.
If there are no critical release notes to review, the page does not display any
issues, but it does provide a link to the product Release Notes.
Review each of the critical issues to ensure that you have addressed any
potential problems. To focus on issues of interest, click the Filter button and
enter text in the Filter By box. When you have finished reviewing the critical
release notes, select the I acknowledge that I have read the critical release
notes and have executed the required actions check box. Once you do this, the
Next button becomes available. Click Next to proceed to the Review page.
3. The Review page lists the Updates that System Center Manager will apply. You
can click Export metadata to obtain a copy of this list as a comma-separated
values (CSV) file or a webpage. Click Next to proceed with the installation.
5. The Validate page shows the results of any prerequisite checks that System
Center Manager performs to ensure that it can apply the Updates successfully.
To view information on the prerequisite checks, click View details.
6. Click Next to apply the Updates. On the Deploy Update dialog box, click
Continue to confirm that you want to proceed.
7. You are returned to the Product Details view. A message informs you that An
activity is currently running, this page will be temporarily disabled until the
activity is complete. This message remains in place until the Update has been
installed on all of the Product Component Instances. An Activity running icon
8. When the installation of the Update finishes, the Patch installation activity
appears in the Other tab of the Activities Overview. A status of Completed
Tip: System Center Manager can also install Content Server modules, using an
Execution Plan. See “Execution Plans, Steps, and Variables“ on page 63.
In most respects, the process of applying Updates to Content Server is similar to the
process of applying Updates to other Products, but there are a few differences.
Errors
If the Prerequisite checks dialog box displays a status of Error , correct the
underlying problem. If you correct the problem without closing the Validate
page of the Content Server Deployment, you can click Retry to have System
Center Manager run the prerequisite checks again.
For example, if the System Center Agent is unable to write to the Content Server
application folder on a Content Server instance, System Center Manager
displays an error for that instance. You will be unable to apply the Update until
you correct the underlying problem (for example, fix the permissions on the
Content Server application folder) so that the System Center Agent can write to
it.
Warnings
Prerequisite checks dialog box will show a status of Warning for the
Language Pack check. To proceed despite the warning, click Continue. It will be
your responsibility to ensure that your custom language pack is applied to the
Systems in your Content Server cluster after System Center Manager applies the
Update.
Checks performed by System Center Manager can result in the following messages:
An error has occurred while attempting to authenticate. Please check the logs for
more details.
This message indicates that System Center Manager was unable to log on to
Content Server using the credentials that you have provided. If you have
provided an incorrect password, this message appears.
This message also appears if Content Server is deployed on a Microsoft IIS site
that does not have Anonymous Authentication enabled. System Center Manager
requires Anonymous Authentication to connect to Content Server using the
REST API.
The following system(s) are not managed by System Center
This message indicates that the listed instance of Content Server has not been
enabled in System Center Manager. The nature of the listed instance dictates the
step you should take.
If the listed instance is an instance in your Content Server cluster, you should
register the System (if necessary) and enable the Content Server Component
Instance. After you have done that, System Center Manager should be able to
apply an Update to your Content Server Environment.
If it is not an actual instance in your Content Server cluster, System Center
Manager may be reporting obsolete information that remains in your Content
Server database from a previous installation. If so, click Unregister Systems, and
the information will be removed.
Caution
If you mistakenly unregister a real Content Server instance from your
cluster, System Center Manager will apply Updates to your cluster, but
not to the unregistered instance. This will result in your Content Server
cluster having instances with different patches on them. To correct this
situation:
1. Stop the Content Server service on the instance, ensure that the
instance is running the same quarterly Update and patches as the
rest of the cluster by manually applying the matching quarterly
Update, copying in any missing patches, and removing any patches
that no longer belong in place. Then restart the Content Server
service.
2. Restart the Content Server service to make the System and
Component Instance re-appear in System Center Manager. Re-
register the System and re-enable the instance.
• An Admin server is unavailable. If that is the case, ensure that the Admin
server is started and take any additional steps that are necessary to make it
available. Then restart the Install Update procedure.
• An Admin server in your Content Server Environment has a Host Name of
localhost or 127.0.0.1. If that is the case, ensure that the Host Name box on
the Admin server’s General properties page has a machine name or,
preferably, a fully qualified domain name in it.
The following system(s) are not registered in the same clustered environment
This message indicates one of the following:
• System Center Manager has discovered the Component Instance, but you
have not enabled it. If it is actually part of your Content Server cluster, you
should enable it and proceed normally.
• The Component Instance is not connected to the same Content Server
database as the other instances in the Content Server Environment that you
are updating. You may need to disable the Component Instance or assign it
to a different Content Server Solution Environment.
1. On the Deploy Updates view of the Content Server Products page, the Update
menu displays the current Update level of your Content Server Environment. If
you have downloaded other Updates, you can select a newer quarterly Update.
Select a quarterly Update that you wish to install from the Update menu, or
leave the Update unchanged to install patches for your current version of
Content Server.
Tip: When you select a different Current update, the list of Downloaded
patches refreshes to display the patches that are compatible with your
selected Update.
2. Select the patches that you want to install, and then click Next.
3. The Download page appears. If you are applying a quarterly Update, it lists any
patches that are currently installed and that you need to reapply when you
apply the new quarterly Update. (This may be necessary for certain patches that
are compatible with both your current Update and the Update that you are
applying.) You can skip the reapplication of the patches by selecting the I want
to skip reapplying patches check box, but OpenText recommends that you do
not do this.
To obtain the patches that need to be reapplied, click Download <#> items and
log on to OpenText My Support when you are prompted to. (If you do not
operate in online mode, click the patch’s URL on an internet-connected
computer, and then use the Upload button to add it to System Center Manager.)
Once the download completes, click Next.
4. If you are applying a quarterly Update to Content Server, the Release Notes
page appears. It displays any critical issues that are documented in the product
Release Notes, along with a link to information on each issue and a link to the
latest OpenText Content Management Release Notes. If there are no critical
release notes to review, the page does not display any issues, but it does
provide a link to the OpenText Content Management Release Notes.
Review each of the critical issues to ensure that you have addressed any
potential problems. To focus on issues of interest, click the Filter button and
enter text in the Filter By box. When you have finished reviewing the critical
release notes, select the I acknowledge that I have read the critical release
notes and have executed the required actions check box. Once you do this, the
Next button becomes available. Click Next to proceed to the Review page.
5. The Review page lists the Update, patches, and language packs that System
Center Manager will apply. You can click Export metadata to obtain a copy of
this list as a commas-separated values (CSV) file or a webpage. Click Next to
proceed with the installation.
Tip: Any compatible Language Packs that you have downloaded are
installed automatically when you install a quarterly Update. You cannot
select or omit specific Language Packs when you install a quarterly
Update.
6. On the Questions page, System Center Manager prompts you to log on to
Content Server as an administrator and to provide any other information that it
requires to apply the Update. Log on as an administrator that is capable of
applying the Update. (For a Content Server quarterly Update, log on as Admin or
sys_support.) Provide any required information, and then click Next.
7. The Validate page shows the results of any prerequisite checks that System
Center Manager performs to ensure that it can apply the Updates successfully.
If any of the checks are not successful, it cannot proceed. You must resolve the
underlying issue before you can use System Center Manager to apply Updates
to your Content Server environment. To view information on the prerequisite
checks, click View details.
8. If the prerequisite check finds no problems, click Next to apply the Updates. On
the Deploy Update dialog box, click Continue to confirm that you want to
proceed.
9. You are returned to the Details view of the Content Server Products page. A
message informs you that An activity is currently running, this page will be
Instances. An Activity running icon also appears at the top of the page.
Click View details or click the Activity running icon to display information on
the progress of the Update application.
10. When the installation of the Update finishes, the Patch installation activity
appears in the Other tab of the Activities Overview. A status of Completed
tab of the Activities Overview with a status of Complete with Errors . To learn
more about the nature of the error, click the Details button in the Inline Action
Bar of the Activity.
In certain cases, a Software rollback button appears beside the failed update
installation. For a Content Server quarterly Update, this may occur if System Center
Manager deploys the Update files successfully, but cannot complete the database
upgrade. (If System Center Manager cannot complete the file updates on one or
more instances of Content Server, it rolls those instances back automatically.)
1. In the Other tab of the Activities Overview, click the Software rollback button
beside the failed update installation.
2. The Performing Software Rollback dialog box appears and advises you that a
software rollback only restores changes made by the current deployment and
does not restore your database.
Important
If the deployment made changes to your database, file store, or search
index, you must roll back these changes by restoring a backup. System
Center Manager does not do this.
3. The Software rollback activity appears in the Running tab of the Activities
Overview. When rollback is complete, the Software rollback activity appears in
Important
If you need to restore a database, file store, or search index backup, do not
start the Content Server services until the backup has been restored.
2. Select a Target Update, and select one or more Content Server Instances.
3. Click Analyze, and in the Update analysis confirmation dialog box, click Yes to
proceed.
5. When the analysis is complete, click View report beside any Component
instance to see the Update analysis delta report.
The Summary section of the report provides general information on your Content
Server system. It also lists patches that you should remove before you apply the
Content Server Update.
Tip: You can run Update Analysis at any time to check whether you have
deprecated patches deployed on your Content Server system.
In the Update analysis delta report, each file is categorized as NEW, VERIFIED, or
DIFFERENT.
NEW
NEW files are files that the Update will add to Content Server. They do not
currently exist in your Content Server installation.
VERIFIED
VERIFIED files are files that the Update will replace. They have a hash value that
matches one in your Cluster Management manifest file, which indicates that the
file has not been modified since its installation.
DIFFERENT
DIFFERENT files are files that the Update will replace, but whose hash value does
not match the one in your Cluster Management manifest file. This indicates that
the file is not the same as when it was first installed. It may have been
customized by the System Administrator, by a third-party integration, or by
some other means. A DIFFERENT file is not the file that the Update expects to
replace, and may contain modifications that you wish to preserve. OpenText
recommends that you back up DIFFERENT files before you apply an Update.
Update Analysis also provides a list of patches that you should remove from
Content Server before you apply the Update.
Important
The list provided by Update Analysis is as complete as possible, but you
should also review the list of patches to be removed that appears in the
Content Server Release Notes. If additional removable patches are identified
after the release of the Update, the Release Notes will include patches that are
not listed in the Update Analysis Delta Report.
Updates, patches, and language packs that have been applied to your Content
Server instances by System Center Manager are accurately displayed in its interface,
but Updates and modules that you have installed manually are not tracked by
System Center Manager. To update the information that System Center Manager has
for a Content Server Product Component instance, select one or more Content Server
instances and then click Resynchronization. On the Product Component
Resysnchronization page, select one or more instances and then click
Resynchronize.
You may be prompted to obtain patches during the synchronization. If you are, click
Download and log on to OpenText My Support when you are prompted to. (If you
do not operate in online mode, click the patch’s URL on an internet-connected
computer, and then use the Upload button to add it to System Center Manager.) In
some cases, you may be prompted to obtain patches that are already installed, but
need to be reapplied during the synchronization. In such cases, you can select the I
want to skip reapplying patches check box if you do not want to reapply the
patches. In general, OpenText recommends that you do not do this.
The System Center Manager Product Catalog is your first stop for researching and
obtaining OpenText software. In the Product Catalog, you can view product
documentation, review software requirements and dependencies, and download
installers for OpenText software applications. You can use an Execution Plan to
install a Product Component once you have downloaded the installer.
Note: The Product Catalog is not available in all versions of System Center
Manager.
button . To filter the list of products in the tree view, click the Filter button
and enter text in the Filter by box.
To open the Catalog - Product details view for any product on the Catalog - Latest
releases view, click the Details button on its Inline Actions Bar or click anywhere
on the entry for that product.
The Catalog - Product details view has an Overview tab and, depending on the
release, additional tabs.
Overview
The Overview section shows the name, version, and release date for the Product
version and provides links to its documentation and release notes. It provides a
Download button that you can use to download the Product version’s installer to
System Center Manager. When you download a Product version, all of the OpenText
Components of that Product are also downloaded. (Third-party products are not
downloaded.)
Additional Tabs
applications that are compatible with the Product version. The tabs that appear in
the tabbed interface vary by Product version, but generally include the following
tabs:
Operating System
The Operating System tab lists the name, manufacturer and version of the
operating systems that the Product version supports.
Web Server
The Web Server tab lists the name, manufacturer, and version of the web
servers that the Product version supports.
Database
The Database tab lists the name, manufacturer and version of the database
servers that the Product version supports.
Required Products
The Required Products tab lists information on additional software products
that the Product version requires for normal operation.
Overview, you can find it in the tree view. Use the Filter button to limit the
number of Products that appear in the listing, and then expand a Product node to
display its available Product versions.
Example: To locate OpenText™ Document Pipeline 16, type pipe in the Filter by box, and
then expand the Document Pipelines node. Click Document Pipelines 21.2 to open the
Catalog - Product details page for that Product version.
Note: Not every available version is listed for each Product. If you require an
older version of a Product, you can download it directly from OpenText My
Support.
1. Open the Catalog - Product details page for the Product version that you
require, and then click Download.
2. On the Catalog - Product download page, select a server operating system. The
page refreshes to display the Product Components that will be downloaded.
Review the list. You can customize the download list by selecting or clearing the
check boxes for optional Product Components. When you have selected the
Product Components that you desire, click Download.
4. The Product download started dialog box informs you that the download of
your Product Components has started. To monitor the progress of the
download, click the Download icon , or open the Downloads view of the
Activities page, and then click the Products tab.
1. Open the Catalog - Product details for the Product version that you require,
and then click Download.
3. For each Product Component that you desire, click the Download button .
4. You are prompted to enter your OpenText My Support credentials. Enter your
user name and password, and then click Sign in.
5. System Center Manager logs onto OpenText My Support using your credentials
and starts the product download. Your browser downloads the Product to your
computer.
6. Click the Upload button that is available on any Catalog view to load the
Product installer into System Center Manager. Drag and drop the installer onto
the Upload page, or click Add files and browse to the installer’s file location.
When you are ready to start the upload, click Continue.
Tip: The Product upload area serves only to upload OpenText software
products. If you want to upload a third-party product to System Center
Manager, use the external vendor file upload area instead. See “Settings:
External Vendor Files” on page 120.
7. After the upload completes, click Close to exit the Upload page. The product
that you downloaded is now visible on the Products tab of the Downloads view
of the Activities page
Execution plans are repeatable sets of instructions that System Center Manager can
execute to perform operations of varying complexity. An Execution Plan can do
something simple, like creating a directory and moving a file into it, or complex, like
installing and configuring multiple instances of Content Server and a deployment of
OpenText Directory Services in a single operation. Execution Plans can be
customized to suit your Environment and your requirements.
To simplify the task of adapting Execution Plans for use in different Environments,
and on new host Systems that may use differing file paths or other configuration
settings, Execution Plans use System Variables and Step Variables.
System Variables represent registered Systems in an Execution Plan. They allow you
to assign descriptive names to the Systems that Execution Plans modify. For
example, you could have an Execution Plan that makes changes to Archive_Center_
host. You can assign a different System to the Archive_Center_host System
Variable whenever you run the Execution Plan. In this way, System Variables
facilitate re-use of Execution Plans.
Step Variables are used to refer to values in a Step’s configuration. If your Execution
Plan requires you to specify the same configuration directory numerous times, for
example, you could create a configDir Variable and assign it to each of the directory
configurations. If you need to specify a different configuration directory when you
re-use the Execution Plan, you can update the value of the configDir Variable and
the change automatically propagates throughout the Execution Plan. Using
Variables allows you to easily tailor an Execution Plan for use in differing
Environments.
Execution Plans are created for a specific Solution Environment, but they are visible
to anyone who is logged on to the same Solution. This means that it’s easy to re-use
an Execution Plan in a different Environment in the same Solution. You can create
an Execution Plan in your Development Environment, for example, and easily re-use
it in your Quality Assurance, User Acceptance Testing, and Production
Environments. You can also use an Execution Plan outside of the Solution that it was
created for, by exporting it and then importing it into an Environment from a
different Solution.
You can create, view, and edit Execution Plans on the Plans Overview. To view
Execution Plans that are queued to execute, that are currently in progress, or that
have completed, open the Execution Plans view of the Activities page.
Execution Plans are managed on the Plans Overview. To access the Plans
To add an Execution Plan, click the Add item button and then click New.
For more information, see “Add an Execution Plan” on page 65.
Import Execution Plans
To import an Execution Plan, click the Add item button , then click Import
and browse to the location of an exported Execution Plan. For more information,
see “Import an Execution Plan” on page 68.
Delete Execution Plans
To delete one or more Execution Plans, do one of the following:
• Select any Execution Plans that you would like to delete, and then click
Delete at the top of the list.
•
Click the Delete button in the Execution Plan’s Inline Actions Bar.
• Select an Execution Plan, and then click Duplicate at the top of the list.
•
Click the Duplicate button in the Execution Plan’s Inline Actions Bar.
• Select an Execution Plan, and then click Export at the top of the list.
•
Click the Export button in the Execution Plan’s Inline Actions Bar.
• Select an Execution Plan, and then click Edit at the top of the list.
•
Click the Edit icon in the Execution Plan’s Inline Actions Bar.
• Select an Execution Plan, and then click Execute at the top of the list.
• click the Execute icon on the Execution Plan’s Inline Actions Bar.
3. On the New Plan page, give the Plan a name and, optionally, a description.
a. Create a System Variable that identifies the System where the steps will be
performed. For information on System Variables, see “System Variables”
on page 80.
b. Click the Add steps button . Numerous Step types are available. For
information on adding and configuring Steps, see “Execution Plan Steps”
on page 69.
Tips
5. Re-order the Steps, if necessary, by using the buttons on the Step’s Inline
Actions Bar or by using the Drag and drop to reorder steps drag handle
beside each step.
6. When you have finished adding and configuring steps, run the Plan
immediately or save it for later use:
Tip: If the Save button is unavailable, verify that you have given the Plan
a name, assigned a System Variable to every Step in the Execution Plan,
and entered every mandatory value. If the Status icon indicates a problem
with your step, place your mouse pointer over it to see additional
information on the problem.
• Select an Execution Plan, and then click Edit at the top of the list.
•
Click the Edit icon in the Execution Plan’s Inline Actions Bar.
For information on adding, removing, and modifying steps, see “Execution Plan
Steps” on page 69.
• To run a plan immediately, create or modify a plan, and then, on the Plan Details
page, click Execute.
• To run a saved plan from the Plans Overview, do one of the following:
– Select an Execution Plan, and then click Execute at the top of the Plan list.
– Click the Execute icon on the Execution Plan’s Inline Actions Bar.
If the Plan that you execute requires passwords to be set or entered, you are
prompted to enter them at run time. Enter any required passwords, and then click
Next. To verify that the passwords are correctly entered, you can select Show
Passwords.
Tip: System Center Manager Execution Plans do not store passwords. You
must enter them each time you run an Execution Plan.
After you start an Execution Plan, the current view changes to the Execution Plans
view of the Activities page, where you can monitor the progress of the Plan. For
more information, see “Monitor Execution Plans” on page 69.
Before you copy an Execution Plan, verify that you are in the Environment that you
want it to apply to. For example, to copy an Execution Plan from the Development
Environment to the Production Environment, switch to the Production
Environment before you click the Duplicate icon.
• Select an Execution Plan, and then click Duplicate at the top of the Plan list.
• Click the Duplicate button on the Execution Plan’s Inline Actions Bar.
2. In the Duplicate plan dialog box, enter a Name and Description for your copied
Execution Plan and then click Duplicate.
The copied plan now appears on the Plans Overview and the Environment that it
applies to appears in the Environment column.
• Select an Execution Plan, and then click Export at the top of the Plan list.
•
Click the Export button on the Execution Plan’s Inline Actions Bar.
1. On the Plans Overview page, click the Add item button , and then click
Import.
2. On the Import plan page:
b. Beside the Choose plan file box, click Browse. Browse to the location of the
Execution Plan that you want to import, and select it.
Steps have multiple configuration settings that appear on one or more tabs. Before
you can use a Step in your Execution Plan, you need to provide suitable values for
the configuration settings.
Note: For several reasons, detailed System Center Manager online help is not
provided for specific Execution Plan Steps.
• Some Steps require no explanation because they perform a simple task, such
as copy a file, execute a Powershell command, or modify an INI file.
• Other Steps perform tasks that are documented elsewhere, such as install or
configure Content Server or Directory Services. The configurations required
in these steps are explained in their respective help and guides.
Add
To add a Step, open an Execution Plan, and select a System Variable that
represents the System that will run the Step. Click the Add steps button .
• To add one or more Steps, select the Steps and then click Add at the top of
the Step list.
•
To add a single step, click the Add button on its Inline Actions Bar.
Once you add a Step, you need to configure it. See “Configuring Plan Steps”
on page 71.
• Select a Step, and then click Edit at the top of the Plan list.
•
Click the Edit button on the Execution Plan’s Inline Actions Bar.
Review its existing settings and change them, if desired. Click Save to save your
changes.
Enable/Disable
To prevent a Step from running without removing it from the Plan, disable it
using one of the following methods:
• Select a Step, and then click Disable at the top of the Step list.
•
The Execution Plan will run but will skip the disabled Step. Disabling a Step
could be useful when you want to run an existing Execution Plan that has a Step
that does not apply to the current System or Environment. A disabled Step has a
• To remove one or more Steps, select the Steps and then click Remove at the
top of the Step list.
•
To remove a single step, click the Remove button on its Inline Actions
Bar.
Duplicate
To make a copy of a Step, do one of the following:
• Select the Step and then click Duplicate at the top of the Step list.
•
Click the Duplicate button on its Inline Actions Bar.
• Select the Step and then click Move up or Move Down at the top of the Step
list.
• Use the arrow buttons on the Step’s Inline Actions Bar.
The required configuration settings may appear on multiple tabs. For example, the
step that installs OpenText™ Directory Services (OTDS) on a System requires you to
provide information on the Default, Apache Tomcat, LDAP, and Java tabs. Be sure
to provide information on each of the tabs.
Tip: If you are configuring a software installation step and the software that
you want to install is not available in the Installer menu of the Step you have
selected, ensure that you have downloaded it using the Product Catalog. See
“Download Products” on page 61.
The following Execution Plan Steps are available in System Center Manager.
Combine these Execution Plan Steps in repeatable Execution Plans to automate
installation and configuration tasks.
Tip: Document Pipelines are often used with Archive Center. For information
on Document Pipeline Execution Plan Steps, see “Document Pipeline
Execution Plan Steps” on page 76.
This section lists the available Common Execution Plan Steps. More detailed
information is available within the Step itself. Each Common Execution Plan Step
includes a detailed Description of what the Execution Plan Step does and the
conditions that apply to it.
Tip: External vendor files are third-party files that you import into System
Center Manager. For more information, see “Settings: External Vendor
Files” on page 120.
Common: Copy software
Copies OpenText software to the specified directory on one or more System
Center Agent host machines.
Example: You have an Execution Plan that references the Content Server installation
directory multiple times, so you create a Step Variable called <Content_Server_home> that
represents the Content Server installation directory. If you re-use the Execution Plan to install
Content Server to a different location, you do not need to manually update the installation
directory repeatedly. Instead you can update the value of the <Content_Server_home> Step
Variable, and System Center Manager automatically applies the change throughout the
Execution Plan.
Step Variables have effect within a specific Execution Plan. You can define a Step
Variable for use in one Step and make use of it in the other Steps in your Execution
Plan. You cannot reference a Step Variable from one Plan in a different Plan.
Tip: If you have a useful set of Step Variables that you would like to use in a
different Execution Plan, you can copy the Plan to another Environment in
your Solution, or export it and import it to an Environment in another Solution.
The Step Variables that you define appear on the Variables tab of your Execution
Plan. Use this tab to review all of the Variables and to update their values, as
required.
2. Type a name in the Variable name box. As you enter the name, it appears
below the Variable box.
The new Variable is created with the value that exists in the configuration setting
beside it.
2. To change a Variable value, replace the content in the Variables Value box with
a different value.
3. Click Save.
After you change the value of a Variable, its value is updated in any configuration
setting in the Execution Plan that has the Variable assigned to it.
button that appears beside the Variable name. Removing the Variable does not
remove the value of the setting. You can change the value manually, if you need to.
When you first create an Execution Plan, the System Variables tab shows every
System that is registered in your current Environment, and each System Variable has
the same name as the System that it represents. You can remove any Systems that
you do not need to use in the current Execution Plan, and you can rename the
System Variable for any registered System.
If there is only one registered System in the Environment, it appears in the System
Variables tab and is automatically assigned to any step in the Execution Plan.
System Variable names must be unique within an Execution Plan, but it is possible
to create multiple System Variables that point to the same registered System.
Tip: Having two System Variables that point to the same System could be
useful if your Execution Plan has two Product installation steps. If you have
System Variables named product1_host and product2_host, you could use
them to install the two Products on the same System in a QA Environment and
on two different Systems in a production Environment.
1. Open an Execution Plan and click the System Variables tab. Name, System and
Status information appears for at least one System Variable.
a. Click the Add System Variable button . A new row appears on the
System Variables tab.
b. In the Name box, enter a System Variable name.
c. Choose a System from the Select a system menu. System Center Manager
displays the status of the System.
3. Click Save.
Rename
To rename any System Variable, click the Name box and enter a new name.
Reassign
To reassign the System Variable to a different System, click the Select a system
menu and choose a different System.
Add
To add a new System Variable, click the Add item button (See “Add a
System Variable” on page 80.)
Remove
To remove an existing System Variable, select it on the System Variables tab
and then click Remove above the list of System Variables. (See “Remove System
Variables” on page 81.)
After you click Save, any changes that you make to System Variables on the System
Variables tab are immediately reflected on the System Variable column of the Step
tab. For example, if you change a System Variable named cs_host to cs_agent_
server and assign a different System to it, any step that was performed by cs_host
is automatically updated to be performed by cs_agent_server with its new System
value.
To remove a System Variable, select it on the System Variables tab and then click
Remove above the list of System Variables. The row representing the System
Variable is immediately removed. Click Save to save the change.
• Activities Overview
• Execution Plans
• Downloads
• Notifications
The Status column provides information on the state of an activity that is in progress
or has finished running:
•
Activities that complete successfully appear with a status of Completed .
• Activities that complete with problems appear with a status of Complete with
errors .
•
Activities that you stop before completion appear with a status of Canceled .
•
To cancel an activity that is running, click the Cancel button .
•
To filter the view by Activity status, click the Filter button .
•
To obtain additional information about activities, click the Details button in
the Inline Actions Bar of any activity record.
•
To remove all activity records from the current tab, click Remove all items .
Note: This page view is not available in all versions of System Center Manager.
Running
Execution Plans that are in progress appear at the top of the view, under
Tip: When you cancel an Execution Plan, the current step runs to
completion before the Plan is stopped.
Other
Execution Plans that have completed, or that are queued to be executed, appear
on the Other tab. For a completed Plan, the icon in the Status column indicates
whether it completed successfully, was cancelled, or encountered an error.
Tip: If you start an Execution Plan that runs on a System that is already
busy running a different Plan, the plan appears in the Other execution
To view detailed status information on a running Execution Plan, click the Details
obtain information on the step that is currently running, click the Details button
on the step’s Inline Actions Bar. The <Step_Name> Details page opens and provides
information on the currently running step, including all of its parameters and the
values assigned to them.
Products
Software installers that you have downloaded from the Catalog appear on the
Products tab.
Note: The Products tab is not available in all versions of System Center
Manager.
Updates
Downloaded Product Updates appear on the Updates tab.
Hotfixes
Downloaded patches and hotfixes appear on the Hotfixes tab.
Language Packs
Downloaded Content Server Language Packs appear on the Language Packs
tab.
To limit what is shown on any of the four tabs, click the Filter button and enter
text in the Filter By box.
Various actions are available to you on the Downloads view of the Activities page:
Details
To view information on a download, do one of the following:
• Select a download and click Details at the top of the download list.
•
Click the Details button in the download’s Inline Actions Bar.
Delete
To delete one or more downloads from System Center Manager, do one of the
following:
• Select one or more downloads and click Delete at the top of the download
list.
•
Click the Delete button in a download’s Inline Actions Bar.
•
Select a download and click Download at the top of the download list.
•
Click the Download button in a download’s Inline Actions Bar.
To view all available Notifications, click More Notifications on the More Actions
menu to open the Activities page, Notifications view. To filter the view by
event type, click the Filter button and, in the side panel, select an event type
from the Type menu.
If you no longer wish to view a Notification, you can delete it using one of the
following methods:
• Select one or more Notifications and then click Remove at the top of the
Notifications list.
•
Click the Remove button in a Notification’s Inline Actions Bar.
When you apply an update to System Center Manager, the System Center Agents
that connect to that instance are automatically updated the next time they connect to
System Center Manager. After you have applied a System Center Manager update,
you do not need to take any additional action to update your System Center Agents.
The procedure for updating System Center Manager varies depending if you
operate in online mode or not. Follow the instructions that apply to your System
Center Manager deployment.
1. On the banner informing you that an update is available, click Start update.
2. The Confirm download dialog box appears. Enter your My Support user name
and password, and click Start download.
3. The Update System Center dialog box appears and displays messages
indicating that System Center Manager is downloading the update and
extracting it. When it has finished these operations, the dialog box informs you
that the update is ready to be applied to your system. Click Update to apply the
update.
4. The Update System Center dialog box informs you that System Center
Manager is applying the update. When it is finished, it informs you that your
system has been successfully updated. Click Refresh to refresh the System
Center Manager page that you are on and exit the update procedure.
1. On the banner informing you that an update is available, click Start update.
2. The Upload product update System Center dialog box appears. It has a Drag
product update file here area, where you can drop an update and a Select
product update file button that allows you to browse to the location of an
update. It also has a Download the product update file link. You can copy this
link and open it on an Internet-connected computer to download the System
Center Manager update. You will need to log on to My Support to obtain the
update.
3. After you have obtained the update, drag and drop it onto the Upload product
update System Center dialog box or click the Select product update file button
and browse to its location.
4. The Upload product update System Center dialog box displays messages
indicating that System Center Manager is uploading the update and extracting
it. When it has finished these operations, the Update System Center dialog box
appears, informing you that the update is ready to be applied to your system.
Click Update to apply the update.
5. The Update System Center dialog box informs you that System Center
Manager is applying the update. When it is finished, it informs you that your
system has been successfully updated. Click Refresh to refresh the System
Center Manager page that you are on and exit the update procedure.
The majority of System Center Manager settings are accessed on the Settings page.
In some cases, settings are managed in the <System_Center_installation_folder>/
configuration/config.ini file
Note: When you add a Microsoft Windows® file path into a System Center
Manager configuration file, enter it in one of the following manners:
Click Save when you make any change to the settings on this page.
Connection
System Center Manager can run in online mode (connected to the Internet) or in
Offline mode (with no Internet connection). Online mode is the default and
OpenText recommends that you operate in online mode, if you can.
Important
If you disable Online mode, special steps are required for updating the System
Center Manager manifest file and downloading Updates. See “Update the
System Center Manager Manifest File” on page 47 and “Download Updates”
on page 47.
1. Click Settings on the Navigation menu . The General view of the Settings
page opens.
3. Click Save.
Session timeout
If a user session is inactive for the number of minutes specified in the Session
timeout box, the session is invalidated. To continue working, the user must log back
on to System Center Manager.
Click Save when you make any change to the settings on this page.
Log Levels
By default, System Center Manager operates with minimal logging. For
troubleshooting, you can increase the log levels.
Log Level
The Log Level menu sets the level of System Center Manager logging. By
default, it is set to Info. To monitor the behavior of System Center Manager or to
troubleshoot an issue, set Log Level to Trace, Debug or Error.
HTTP Log Level
The HTTP Log Level menu sets the level of logging of HTTP messages sent and
received by System Center Manager and the System Center Agent. By default, it
is set to Error. For troubleshooting, set the level to Debug.
Request Logging
Request logs are a record of the requests that the server has processed. By
default, request logging is not enabled, but you can enable it for troubleshooting
purposes. To enable request logging, select the Enable check box and set the
number of days to retain request log files in the Log retention period (days) box.
By default, the log retention period is set to seven days.
Request log files are written to the <System_Center_installation_folder>/
logs/ directory. Each one has a name like requests_<yyyy_mm_dd>.log, for
example requests_2022_02_22.log. A new log file is created each day. At the
end of the log retention period, the oldest request log file is removed and a new
one is started, so with the default retention period of seven days, System Center
Manager will not store more than seven request log files in the logs directory.
For more information on logging for System Center Manager and System Center
Agents, see “System Center Manager and Agent Logging” on page 137.
Click Save when you make any change to the settings on this page.
Proxy Settings
If System Center Manager connects to the Internet through a proxy server, enable
Use a proxy server on the Settings page Proxy view and enter your proxy server’s
address so System Center Manager can update its manifest file and download
Updates over the Internet.
Important
For System Center Manager to operate successfully in online mode, your proxy
server administrator must configure the proxy server to allow System Center
Manager to connect directly to the following external addresses:
• api.otiam.opentext.com
• api.us1.covisint.com
• mimage.opentext.com
• login.opentext.com
• www.opentext.com
Enable Use a proxy server, and then enter the URL and port of your proxy server in
the Server and Port boxes.
If your proxy server requires a logon, select Digest or NTLM from the
Authentication type menu. To have System Center Manager store your proxy server
logon credentials, select Store credentials and enter a User name and Password.
Note: If you do not store your proxy server credentials, System Center
Manager will prompt you to provide them whenever you perform an action
that requires it to connect to the Internet, such as updating its manifest,
downloading an Update, or downloading software from the Catalog.
If there are servers within your internal network that System Center Manager can
connect to directly, without using your proxy server, enter them in the Exceptions
box and then click the Add button . For example, you could add localhost or
the names of any Systems that run the System Center Agent to the Exceptions
section.
To filter the Users list, click the Filter button and enter a text string in the Search
Id, given name, or surname box that appears in the Settings sidebar.
When you install System Center Manager, it has one user: the built-in Admin user.
The Admin user has unrestricted access to all of the functionality and to every
Solution Environment in System Center Manager, and is the only user that can make
changes to authentication or the manifest URL.
Normally, you should not use System Center Manager logged on as Admin. Instead,
you should create System Center Manager logons, with appropriate access
permissions, for anyone that will use it. You can limit a user’s access permissions in
two ways: by Role and by Solution or Environment.
Role
The scope of a user’s capabilities depends on the user’s role. There are three
roles in System Center Manager:
Administrator
Administrators have unrestricted access to System Center Manager. They
can access every Solution and Environment, and can make changes to any
System Center Manager setting.
Tip: Users that are assigned the Administrator role can do anything
that the built-in Admin user can do, except for modifying settings on
the Authentication or Manifest views of the Settings page.
Solution Manager
Solution Managers can manage any Solution that they are assigned, and can
manage any Environment within the Solution. They can add, modify, and
remove Environments in the Solutions that they are assigned.
On the Settings page, Solution Managers have access to the Audit, Agents,
Solutions, External Vendor Files and Manifest views, but not the General,
Users and Authentication tabs. They can only view data and make changes
for the Solutions that they manage.
Environment Manager
Environment Managers can manage any Environment that they are
assigned. They can view Execution Plans that are created in their
Environment’s Solution, and they can edit Execution Plans that are created
in their Environment.
On the Settings page, Environment Managers have access to the Audit,
Agents, Solutions, External Vendor Files and Manifest views, but not the
General, Users and Authentication tabs. They can only view data and make
changes for the Environments that they manage.
Permissions
Users have access only to the Environments and Solutions that they manage.
They can only access data or settings that belong to their Solutions and
Environments. For example, they can edit an Execution Plan only if they have
access to the plan’s Environment, and they can only view Audit events from the
Solutions or Environments that they manage.
Note: System Center Manager can perform all of its user management itself or
it can delegate most of its user management functions to OpenText Directory
Services. For information on integrating OpenText Directory Services, see
“Settings: Authentication” on page 109.
Solution Manager
Select one or more of the listed Solutions. Users will be able to view and
manage any Solutions that they are assigned, and will have access to every
Environment within those Solutions.
Environment Manager
Select a Solution Environment from the listed Environments. Users will be
able to view and manage any Environments that they are assigned.
• Select a user from OTDS. You can start typing in the Directory services user
name box, which will update to show the available users, filtered by your
text string.
• In the Role box, select either Administrator, Solution Manager, or
Environment Manager.
4. On the Permissions tab, assign the user access to Solutions or Environments.
Solution Manager
Select one or more Solutions on the Assigned Solutions page. Users will be
able to view and manage any Solutions that they are assigned, and every
Environment within those Solutions.
Environment Manager
Select a Solution Environment from the Assigned Environments page.
Users will be able to view and manage any Environments that they are
assigned.
To edit a user:
• Select a user and click Edit at the top of the user list.
3. The user setup page appears. Make changes on the General and Permissions
tabs, as required.
General tab
To change the user’s role, select a role from the Role menu.
To assign a new password to a user, enter the new password in the
Password and Confirm Password boxes.
Permissions tab
To assign access to a new Solution or Environment, select it on the
Permissions tab.
To remove access to an existing Solution or Environment, clear its check
box.
To remove a user:
• Select a user and click Remove at the top of the user list.
If a user account has been locked because of successive logon failures that exceeded
the Account Logon Threshold, you can unlock the account in one of the following
ways:
• Select a user and click Unlock at the top of the user list.
•
Click the Unlock button in the user’s Inline Actions Bar.
Notes
If you use OTDS for authentication, you can reset a user’s password in OTDS. Refer
to the OTDS online help for information on how to do this. If you need to reset the
password of the Admin user, however, you cannot do it through OTDS. For the
Admin user, follow the security token procedure described below.
For a normal System Center Manager user who has forgotten their password, you
have two ways of resetting the user’s password.
• To retrieve a security token, you must have access to the file system on
the System Center Manager server.
• Only the Admin user can change the Admin user’s password. If the
Admin user’s password has been forgotten, the only way to reset it is
by using a security token.
• A System Center Manager administrator who can retrieve the security token
from the file system on the System Center Manager server.
a. Inform a System Center Manager administrator that you are resetting your
password and that you will need assistance. (The security token expires in
5 minutes. If you do not use it before it expires, you will need to request a
new one.)
c. You are prompted to enter your user ID (email address). Click Continue.
d. You are prompted to enter your Security Token and a new password. Once
you receive the security token from your System Center Manager
administrator, enter it in the Security Token box, then enter your new
password in the Password and Confirm password boxes. Click Reset
password to complete the operation.
2. When a user requests a security token, System Center Manager generates a file
that contains the token. As an administrator who has access to the local file
system on the System Center Manager server, retrieve the user’s security token,
as follows:
b. Open the file whose name contains the user’s name. For example, for a user
named [email protected], open the file named [email protected]. The
security token is written inside this file.
c. Send the security token to the user. The user can then reset their password
as described in step 1d above.
To page through the audit records, use the controls at the bottom of the page. To
restrict the listing of audit records to a specific event of interest, click the filter button
. The Refine by area in the Settings sidebar contains menus and boxes that
allow you to filter by Event type, Solution, Environment, Description, User and
Date.
You can download the Agent installation software from the Agents view of the
Settings page.
Tip: If desired, you can customize the PowerShell script by modifying the
msiexec.exe command arguments that appear between double quotation
marks immediately after -ArgumentList. For information on these command
line arguments, see “Unattended Installation of the System Center Agent”
on page 103.
a. In System Center Manager, open the Agents view of the Settings page.
2. Run the PowerShell script on the computer that you want to add to System
Center Manager as a System.
1. Download the Agent for Windows from your installation of System Center
Manager.
a. In System Center Manager, open the Agents view of the Settings page.
Tip: If you open System Center Manager on the computer where you want
to install the System Center Agent, you can download the installation file
directly to the correct computer and run the installation immediately.
5. On the Destination Folder dialog box, enter the folder that will contain the
System Center Agent program files, or accept the default (C:\OpenText\
OpenText System Center Agent <##.#.#>\). Click Next.
6. On the Ready to Install dialog box, click Install. The Installing the Product
dialog box appears and shows the progress of the installation.
<installer_log_file_name>
The path of the installer’s log file. For example, C:\AgentInstall.log.
<System_Center_Agent_installer_file_name>
The path of the System Center Agent installer. For example, C:\Installers\
OpenText_SystemCenter_Agent.msi
<Agent_installation_directory>
The directory where you want to store the System Center Agent program files.
For example, C:\SystemCenter\OpenText System Center Agent\
<System_Center_Manager_port>
The port that the System Center Manager server uses to communicate. By
default it is 8888.
<System_Center_Manager_server>
The network name of the System Center Manager host computer. For example,
scm.example.com
For example, to silently install the System Center Agent on a computer using all of
the example values from above, run the following command:
If the user running the System Center Agent installer does not have access to the /
etc/opentext/landscape/ directory, the following message appears during the
installation:
Unable to create the landscape directory '/etc/opentext/landscape'.
The solution registry file is saved in <System_Center_Agent_home> instead.
It's recommended that the solution registry file be copied to '/etc/opentext/landscape'
directory for use by other OpenText products.
This message does not indicate an installation failure, but you can prevent it from
appearing by ensuring that the user that runs the System Center Agent installer can
create the /etc/opentext/landscape/ directory and write to it. If the message does
appear, you can copy the solution registry file from your
<System_Center_Agent_home> directory to the /etc/opentext/landscape/ directory
after the installation completes. This produces the same result as having the System
Center Agent installer create the file in the /etc/opentext/landscape/ directory
during the installation.
11.6.2.1 Install the System Center Agent using the Installation Script
To install the System Center Agent by running the installation script:
a. In System Center Manager, open the Agents view of the Settings page.
2. On the System Center Agent host computer, log on as the user that will run the
System Center Agent and execute the script.
Extracting OpenText_SystemCenterAgent.tar.gz...
Starting System Center Agent ...
System Center Agent is started.
Installation completed and Agent started.
Installation location is <System_Center_Agent_installation_directory>.
4. When the console displays Install Agent as Service? y/n:, type y to to install
the System Center Agent as a service. Enter n to have the System Center Agent
installed as a program that must be started and stopped manually.
1. Download the Agent for Linux from your installation of System Center
Manager.
a. In System Center Manager, open the Agents view of the Settings page.
2. On the System Center Agent host computer, log on as the user that will run the
System Center Agent.
6. When the console displays Install Agent as Service? y/n:, type y to to install
the System Center Agent as a service. Enter n to have the System Center Agent
installed as a program that must be started and stopped manually.
2. Log on to the System Center Agent host computer as the user that will run the
System Center Agent.
6. The installer prompts you to enter the hostname of the Manager. Enter the
name of the System Center Manager host computer.
7. The installer prompts you to enter the HTTP port number of the Manager. Press
ENTER to accept the default port (8888) or enter a different port number. The
following messages appear:
Extracting OpenText_SystemCenterAgent.tar.gz...
Starting System Center Agent ...
System Center Agent is started.
Installation completed and Agent started.
Installation location is <installation directory>
Installing Agent as Service requires elevated privileges.
Note: The agent will be running as <current user>
8. When the console displays Install Agent as Service? y/n:, type y to to install
the System Center Agent as a service. Enter n to have the System Center Agent
installed as a program that must be started and stopped manually.
1. Download the Agent for Linux from your installation of System Center
Manager.
a. In System Center Manager, open the Agents view of the Settings page.
2. On the System Center Agent host computer, log on as the user that will run the
System Center Agent.
4. Run the installation and pass required information to the installer in an answer
file. For example, run SystemCenter_Agent.sh < <answer_file>
Example: To install the System Center Agent to a non-default directory and configure it to
run as a service, the answer file should have contents similar to the following:
n
/usr/local/scm_agent
y
2. Log on to the System Center Agent host computer as the user that will run the
System Center Agent.
4. Run the installation and pass required information to the installer in an answer
file. For example, run install_otsystemcenteragent.sh < <answer_file>
Example: To install the System Center Agent to a non-default directory and configure it to
not run as a service, the answer file should have contents similar to the following:
n
/usr/local/OT/SC/SCagt
SCMhost.example.net
8888
n
Important
You must be logged on as the Admin user to change the authentication method
used by System Center Manager.
Note: Regardless of how you manage users in System Center Manager, you
can always log on as the Admin user, whose password is specified during the
installation of System Center Manager.
To enable integration with OTDS, provide the address of your OTDS server and the
Resource Identifier of the Resource that represents System Center Manager in OTDS.
When you enable OpenText Directory Services as your authentication provider, you
specify an OTDS group that contains System Center Manager administrators. You
can select an existing OTDS group for this purpose, or one that has been created
specifically to contain System Center Manager users.
1. Logged on as the Admin user, on the Authentication view of the Settings page,
enable OpenText Directory Services.
a. In the Server URL box, enter the URL of your OTDS server, for example:
http://myotds.example.net:8080
b. In the Resource Identifier box, enter the Resource Identifier of your OTDS
system, for example: 7ad3ea31-9131-4f31-b7e6-ef5d7123fb09
c. Click Test Connection to verify your settings.
d. After the test connection completes successfully, click Activate resource.
After you have enabled OTDS as your authentication provider, you must still assign
OTDS users to a System Center Manager role and to one or more System Center
Manager Solutions or Environments. See “Add an OTDS User” on page 96.
Local Account Policy settings determine how many successive times a user can fail
a logon attempt before being locked out and how long an account lockout lasts. To
change Local Account Policy settings, you must be a user with the Administrator
role, or be logged on as the Admin user.
The default value of the Account lockout duration is 15 minutes. You can set it to a
number from 1 to 60. When the Account Lockout period expires, the locked-out user
account can attempt to log on again. You can also unlock an account on the Users
view of the Authentication page to allow the user to log on immediately. See
“Unlock a User” on page 98.
The default value of the Account Lockout Threshold is 3. You can set it to a number
from 1 to 10. If a user fails a logon attempt more times in a row than the value of the
Account Lockout Threshold, the user is locked out for the Account lockout
duration.
Add item button . When the Add Solution page appears, enter a Solution name
and, optionally, a description, and then click Add.
The Solution now appears on the Solutions view, with a warning icon
indicating that the Solution does not yet have any Environments assigned to it. For
information on adding an Environment to a Solution, see “Add an Environment”
on page 115.
– Select a Solution and click Edit at the top of the Solution list.
–
Click the Edit button in the Solution’s Inline Actions Bar.
• To add an Environment to a Solution, see “Add an Environment” on page 115
• To modify one of the Solution’s Environments, see “Modify an Environment”
on page 115.
• To remove an Environment from a Solution, see “Delete an Environment”
on page 116.
• Select a Solution and click Delete at the top of the Solution list.
•
Click the Edit button in the Solution’s Inline Actions Bar.
The Delete dialog box appears and informs you of the number of Environments,
Systems, and users who are associated with the Solution. Click Delete to proceed to
delete the Solution.
Systems that are associated with a deleted Solution are returned to unregistered
status and can be registered again on the Systems page. See “Register and
Unregister Systems” on page 23.
1. The subfolders are present only if the Solution actually includes items of
that type. For example, if the Solution does not contain any External
Vendor Files, the extVenFiles subfolder is not included in the Solution ZIP
archive.
2. Patches are not included in an exported Solution. Only files that are
referenced in an Execution Plan are included in the Solution export.
Presume, for example, that you manage Content Server for a number of distinct
customers. You have developed a Content Server Solution that includes multiple
Content Server Environments and various Execution Plans that you use for
installing, configuring, and maintaining Content Server. You export this Solution
and import it into your customer’s System Center Manager installation, and then
you use the Environments and Execution Plans in it to set up and maintain the
customer’s Content Server deployment. This allows you to use the same tested and
repeatable procedures for each of your Content Server customers.
To export a Solution:
• Select a Solution and click Export at the top of the Solution list.
3. The Export Solution dialog box appears, informing you of the number of
Environments, Execution Plans, and files associated with the Solution. Click
Export.
4. When the Solution package is ready, the Export solution dialog box appears.
Click Download. Your browser downloads the Solution package.
To import a Solution:
• Click Add file, then browse to a Solution package and select it, or
• Drag the Solution package onto the Upload side panel.
4. The Import solution page appears. Click each tab in the Details area to learn
about the Environments, Systems, Execution Plans, External Vendor Files, and
Products that are included in the Solution package.
When you import a Solution, you must provide it with a Name. You can also
modify some of the Solution’s attributes:
Tip: The names in the Environment menu reflect any changes that you
make on the Environments tab.
5. Click Import.
To add an Environment:
1. Open the Solutions view of the Settings page, select a Solution to modify in one
of the following ways::
• Select a Solution and click Environment at the top of the Solutions list.
Tip: Environment names must be unique within a Solution, but can be re-used
in another Solution
1. Open the Solutions view of the Settings page, select a Solution to modify in one
of the following ways::
• Select a Solution and click Environment at the top of the Solutions list.
• Select an Environment and click Edit at the top of the Environments list.
3. Change the name and description of the Environment, and then click Save.
•
To edit the name or description of an Environment, click the Edit icon .
• To remove an Environment from a Solution, see “Delete an Environment”
on page 116.
1. Open the Solutions view of the Settings page, select a Solution to modify in one
of the following ways::
• Select a Solution and click Environment at the top of the Solutions list.
• Select an Environment and click Delete at the top of the Environments list.
Nothing to do
You may receive a notification that there is nothing to do because the Products
are already synchronized. This could happen if the Products are identical, but it
could also happen if, for example, the Product in the target Environment has one
more patch than the Product in the source Environment. In such a case, the
synchronization does not remove the extra patch from the target Environment.
Instead, System Center Manager informs you that there is nothing to do because
the Products are already synchronized.
Missing Packages
System Center Manager may inform you that a required package has not been
downloaded or that it encountered an error during the download of a required
package. If you see this message, click Continue. How you proceed after this
depends on whether you operate in online mode or not.
If you operate in online mode, System Center Manager displays the Confirm
download dialog box. Log on to My Support to download the missing patch.
1. On the Solutions tab of the Settings page, to select the Solution to synchronize
and start the synchronization process, do one of the following:
• Select a Solution and click Synchronize at the top of the Solutions list.
Tip: The Environment that you select must contain registered Systems
that run a Product that is supported for the synchronization
operation. Currently, the only Product that is supported for
synchronization is Content Server.
b. Select a Product name and Product version from the Environment that you
selected in the previous step. If there is only one Product and Version that
is supported for synchronization, its Product name and Product version
are presented as default options.
c. Click Next.
Tip: The Environment that you select must contain registered Systems
that run a Product that is supported for the synchronization
operation. Currently, the only Product that is supported for
synchronization is Content Server.
b. Select a Product name and Product version from the Environment that you
selected in the previous step. If there is only one Product and Version that
is supported for synchronization, its Product name and Product version
are presented as default options.
c. Click Next.
4. On the Target page, System Center Manager performs analysis to verify that it
can perform the synchronization. If:
5. On the Analyze page, System Center Manager validates that the Systems in the
target Environment are ready to be synchronized. If System Center Manager
finds problems, resolve them before you proceed. If System Center Manager
displays The analysis has completed successfully, click Next.
6. The Download page displays packages that System Center Manager needs for
the synchronization. To download any missing packages, click Download <#>
item(s) and log on to My Support, if necessary.
7. On the Validate page, System Center Manager validates that the Content Server
instances in the target Environment are ready to be synchronized. To view the
results of the validation, click View details.
If System Center Manager finds issues that require your attention, address the
issue before proceeding. The action that you need to take depends on the
warning that is displayed.
Important
Do not select the check box if you are not certain. Proceeding with the
synchronization despite the warning can have unpredictable results
on your Product Component Instance.
Problems with Updates, Patches, or Language Packs
If System Center Manager detects problems with any Updates, patches, or
Language Packs that it needs to apply to the target Environment, it displays
a warning that a package has not been downloaded, that a package is
currently downloading, or that a package encountered an error during
download. You must correct the problem before the synchronization can
complete. You may be able to proceed with the current synchronization
once you have corrected the problem, but in most cases, you need to restart
the synchronization.
8. On the Synchronize page, System Center Manager lists the Product Component
Instances that will be synchronized. Click Synchronize to proceed.
9. The synchronization begins. To view the progress of the synchronization, open
the Activities Overview page. Under Running Activities, a Synchronize Patch
Installation activity appears. Click the Details button for more information
on the activity’s progress.
10. When the synchronization completes, the Synchronize Patch Installation
activity appears in the Other activities section of the Activities Overview, with
the nature of the errors, click the Details button . If necessary, you can roll
back the Synchronize Patch Installation by following the instructions at “Roll
Back a Content Server Update Deployment” on page 56.)
Note: The Settings page, External Vendor Files view is not available in all
versions of System Center Manager.
Files that have been uploaded to System Center Manager appear on the External
Vendor Files view of the Settings page. You can filter your view of this page to
make it easier to find uploaded third-party files.
Optionally, you can enable restrictions on External Vendor File uploads to ensure
that no single file exceeds a maximum file size, and the total number of uploaded
files does not exceed a specified file count or a total size in megabytes. You can also
limit External Vendor File uploads to files that have an allowed file extension.
1. On the External Vendor Files view of the Settings page, click the Upload
button
2. On the Upload sidebar, add a file using one of the following methods:
3. Click Continue
The uploaded files now appear on the External Vendor Files view of the Settings
page.
• Select one or more files, and then click Delete at the top of the files list.
•
Click the Delete button in the file’s Inline Actions Bar.
Note: An Execution Plan that is configured to use a deleted file will generate
an error message similar to the following when you attempt to run it.
1. Using a computer that is connected to the Internet, download the latest System
Center Manager manifest from the Manifest URL shown on the Manifest view
of the Settings page.
3. The Upload sidebar appears. Upload the manifest file to System Center
Manager using one of the following methods:
4. Click Continue.
Note: Do not perform this action unless OpenText Customer Support advises
you to.
The way you repair the manifest differs in online and offline mode. Follow the
instructions that apply to your System Center Manager deployment.
• Drag the System Center Manager manifest onto the Upload sidebar, and then
click Continue.
• Click Upload Manifest, browse to the location of the manifest file and then select
it. Click Start when the Upload manifest for repair dialog box appears.
When the manifest repair is complete, a message at the top of the page confirms that
The system's current manifest was checked and published on <Date_Time>.
Tip: For information on generating logs and setting log levels, see “Settings:
Logs” on page 92 and “System Center Manager Logs“ on page 137.
You can create a Log Package for any single Solution Environment. If you need to
produce Log Packages for more than one Solution Environment, generate a Log
Package separately for each Environment.
System Center Manager can retain up to five Log Packages. If you attempt to create
more than that, System Center Manager warns you that it will delete an existing Log
Package before you proceed. To delete an existing Log Package yourself, click the
Delete button in the Inline Action Bar of the Log Package, or select the Log
Package and click Delete above the list of Log Packages.
1. On the Support view of the Settings page, click the Add item button .
• Clear the check box beside any Agent whose logs you do not want to
include. By default, the logs from every System Center Agent in the Solution
Environment are included in the Log Package.
3. Click Start. You are returned to the Log Packages page. The Log Package that
you have requested appears on the page. Its status indicates whether the
package is queued, in progress or available. Note that if any Agent is busy
performing activities when the Log Package request is generated, the Log
Package job will wait for the Agent to become available before it proceeds to
add its logs to the Log Package. Information on the generation of a Log Package
is also available on the Activities Overview page.
4. Once the Log Package has a status of Completed , you can click the
Download button beside the Log Package to save a local copy that you can
provide to Customer Support.
On the Notifications view of the Settings button, click the Automatic Notification
Purge toggle button to enable automatic purge of Notifications.
When you enable Automatic Notification Purge, you must also specify the
following settings:
When this setting is enabled, System Center Manager permits you to resubmit
certain activities that ran but did not complete successfully. If you know what
prevented the activity from completing and have corrected the underlying problem,
retrying an activity can allow it to succeed. For example, if a temporary network
failure made it impossible for System Center Manager to apply an Update to a
Product Component Instance, you can retry the activity once the network is
functional again.
When you enable Retry activities with an error, you can also set a Retry error
period (hours). This is the period during which the Retry option is available for
failed activities. By default the Retry error period (hours) is 24. You can set it to a
number of hours from 1 to 72. If more hours than the Retry error period (hours)
have elapsed since an activity was originally submitted, the Retry option does not
appear for that activity.
Note that enabling Retry activities with an error affects only activities that are
started after the setting is in place. It does not affect activities that have already run,
so you will not see a Retry option for existing activities when you enable the setting.
But you will see it for eligible activities that run after the setting is in place.
Disabling Retry activities with an error, on the other hand, is effective immediately.
As soon as you disable the setting, you stop seeing the Retry option for existing
eligible activities, including ones that offered the Retry option before you disabled
the Retry activities with an error setting.
In addition, the following requirements govern whether you see a Retry option for a
failed activity:
• It is an activity that supports the Retry operation. Support for retrying activities
varies by product and by activity.
• You are the person who initiated the failed activity. Only the user that initiated a
failed activity can Retry it.
• Another activity of the same type has not been initiated in the same environment.
To retry a failed activity, locate the activity that you would like to retry on the
Activities Overview and, in its Inline Actions Bar, click Retry . After you click
Retry, a message informs you that you should determine what caused the activity to
fail by inspecting the log files and resolve that problem before you retry an activity.
It also informs you that, unlike a new activity, the Retry operation does not verify
prerequisites before it runs. (For information on the prerequisites check, see “Verify
Prerequisites” on page 52.) Click Retry to proceed.
Tip: Your keystore must reference a certificate in use in your Public Key
Infrastructure. For an example of using a self-signed certificate, see “SSL
Deployment Using a Self-Signed Certificate” on page 130.
• jetty.etc.config.urls=etc/jetty.xml,etc/jetty-deploy.xml,etc/
jetty-https.xml
• jetty.sslContext.keyStorePath=etc/<keystore_filename>
• jetty.sslContext.keyStorePassword=<keystore_password>
• jetty.sslContext.keyManagerPassword =<key_password>
• jetty.ssl.port=<ssl_port_number>
4. Start the System Center Manager service.
Note: After you complete the above steps, you can open System Center
Manager using SSL. Your managed systems will appear with an Agent status
of Stopped, however, until you configure each System Center Agent to connect
to the SSL address of System Center Manager. See “Configure each System
Center Agent to Connect to the System Center Manager SSL Address”
on page 128.
In the following instructions, the cacerts file (the Java trust store) must trust the
security certificate used by System Center Manager. For an example of using a self-
signed certificate, see “SSL Deployment Using a Self-Signed Certificate”
on page 130.
Important
Be sure to copy the cacerts file and reference the location of the copy in the
config.ini file, as described in the following procedure. Do not reference the
<System_Center_agent_installation_folder>\jre\lib\security\cacerts
file directly in the config.ini file. The contents of the <System_Center_agent_
installation_folder>\jre\ folder may be overwritten when System Center
Manager is updated.
Example: com.opentext.sc.agent.server_uri=SCMhost.example.com:8443/
otsc-server/v1/agentwebsocket
Stop the System Center Manager service before you make any changes to the
config.ini file.
To access the utility library, open a command prompt and change to the <System_
Center_Manager_home>\plugins\ directory. Using the copy of Java that is installed
with System Center Manager, execute the following command to obfuscate the
keyStore and keyManager passwords:
Copy the OBF string to the config.ini file, replacing the existing clear-text
passwords, so that the keyStore and keyManager settings appear as follows:
jetty.sslContext.keyStorePassword=OBF:1k8q1v251y871tvf1vun1tvn1y7r1v291k5g
jetty.sslContext.keyManagerPassword=OBF:1k8q1v251y871tvf1vun1tvn1y7r1v291k5g
1. Create a keystore file and a certificate. Execute the following command in the
<System_Center_installation_folder>\jre\bin\ folder:
keytool -keystore keystore -alias systemcenter -genkey -keyalg RSA
-sigalg SHA256withRSA
Tip: Make a note of the answers that you provide to the questions that
keytool asks.
2. Add the keystore to System Center Manager and configure System Center
Manager to use SSL by following the steps in “Enable System Center Manager
to run on SSL” on page 127.
3. Using Google Chrome™, open the https address of System Center Manager.
Because you are using a self-signed certificate, Not secure appears to the left of
the System Center Manager URL in the browser address bar.
6. Make a copy of the cacerts file, as described in step 2 of “To configure a System
Center Agent to connect to System Center Manager using SSL:“ on page 128.
7. Configure the copy of cacerts to use your self-signed certificate by running the
following command in the <System_Center_agent_installation_folder>\jre\
bin\ folder:
keytool -import -alias systemcenter -file ..\..\localcert\<exported_
certificate_name> -keystore ..\..\localcert\cacerts -storePass
changeit
8. Update the System Center Agent config.ini file, as described in step 3 of “To
configure a System Center Agent to connect to System Center Manager using
SSL:“ on page 128.
9. Restart the System Center Agent.
• java.util.concurrent.ExecutionException: org.eclipse.jetty.websocket.
api.UpgradeException: 400 Illegal character CNTL=0x15
Complete the below steps to add a Java truststore to System Center Manager and
add your organization’s SSL certificate to the truststore.
javax.net.ssl.trustStore=<System_Center_installation_folder/path>/
cacerts
Example: javax.net.ssl.trustStore=<System_Center_installation_folder>/
localcert/cacerts
1. Open the OpenText System Center Manager Properties dialog box, using any
of the following methods:
2. On the Java tab of the OpenText System Center Manager Properties dialog
box, enter values for Initial memory pool and Maximum memory pool.
2. Create an executable shell file called setenv.sh if it does not exist already.
4. Restart System Center Manager or the System Center Agent to register your
changes.
The procedure for updating System Center Manager varies depending if you
operate in online mode or not. Follow the instructions that apply to your System
Center Manager deployment.
When you apply an update to System Center Manager, the System Center Agents
that connect to it are automatically updated the next time they connect to System
Center Manager. After you have applied a System Center Manager update, you do
not need to take any additional action to update your System Center Agents.
1. Click Start Update on the banner message informing you that an update is
available.
3. The Patch download started dialog box appears informing you that System
Center Manager is downloading the update. Click Close. When the message
The required package has been provided appears and the Status icon indicates
that System Center Manager has downloaded the update, click Next.
5. A series of messages informs you that System Center Manager is applying the
update. When it is finished, it informs you that your system has been
successfully updated. Click Close to exit the update procedure.
Important
Install the update using System Center Manager. Do not unzip the update onto
the System Center Manager application folder.
a. Click Start Update on the banner message informing you that an update is
available.
b. The Update page opens. To download the update, click the Download
Tip: If necessary, copy the URL from the Download button and use it
to download the System Center Manager update on a computer that is
connected to the Internet.
2. Apply the System Center Manager update. Perform the following steps on any
computer that can connect to System Center Manager.
a. Click the Upload the update hyperlink. The Upload sidebar opens. Provide
the update file to System Center Manager, either by browsing to it (click
Add file) or by clicking it and dragging it onto the Upload sidebar.
b. On the Upload sidebar, click Continue. A progress bar shows that System
Center Manager is uploading and validating the update file. When the
status of the upload is Succeeded, click Close to return to the System
Center Manager Update page.
c. Click Next. On the following page, click Install to apply the update. A
series of messages informs you that System Center Manager is extracting
the update and applying it. When it has finished these operations, the
System updated dialog box informs you that the update has successfully
completed. Click Close to complete the operation and return to System
Center Manager.
To help diagnose problems that you may encounter with System Center Manager or
your System Center Agents, you can enable various logging levels for the System
Center Manager and the System Center Agent.
Server logging
To set the log level for System Center Manager, open the Settings page, Logs
view, and select a value from the Log level menu. By default, Log level is set to
Info. For troubleshooting, raise the log level to Error or Debug.
Agent logging
To set the log level for a System Center Agent, open the System Details view of
a System that is registered in System Center Manager, and then click Edit. Select
a value from the Log level menu. By default, Log level is set to Info. For
troubleshooting, raise the log level to Error or Debug. You can also set the HTTP
logging level for an agent on this page.
HTTP logging
To set the log level for HTTP messages sent and received by System Center
Manager, open the Settings page, Logs view, and select a value from the HTTP
log level menu. By default, HTTP log level is set to Error. For troubleshooting,
raise the log level to Debug.
Request logging
Request logs are a record of the requests that the server has processed. To enable
request logging, open the Settings page, Logs view, click Enable request
logging check mark and specify a number of days in the Log retention period
(days) box.
Important
Before you edit the config.ini file, stop System Center Manager or the System
Center Agent.
• log.file=./logs/mylogs.log