Contents
About this Release
SBM 10.1.1.4 is the version that immediately follows SBM 10.1.1.3. All of the features, changes, and fixes that were made in SBM 10.1.1.3 can be found in SBM 10.1.1.4.
SBM 10.1.1.4 supports new installations—you do not need to install a previous version of SBM before installing this version. If this is a new installation, download version 10.1.1.4 from http://www.serena.com/support and then follow the instructions in the SBM Installation and Configuration Guide.
- If you have already installed SBM 2009 R3 or later, follow the steps in Minor Upgrades to upgrade to SBM 10.1.1.4.
- If you have not yet upgraded to at least 2009 R3, follow the steps in solution S138037 to perform the upgrade to SBM 10.1.1.4.
SBM 10.1.1.4 is available in U.S. English only.
Terminology Changes
The following terminology and component name changes have been made since the release of SBM 2009 R4.
Old Term | New Term |
---|---|
SBM Application Administrator |
SBM Application Repository |
Web Administrator | SBM Application Administrator |
Manage Data | Auxiliary Data (in SBM Application Administrator) |
Notification Server (in the SBM installer) | SBM Mail Services |
- For changes made in SBM 2009 R4, refer to the readme.
- For terminology changes made since TeamTrack 6.6.1, refer to the Moving to Serena® Business Manager guide.
Supported Configurations
The supported configurations for 10.1.1.4 are identical to those published for 10.1. Detailed information about supported platforms and software configuration is available in the Supported Platform Matrix.
For 64-bit SBM installations, you can install and run Serena License Manager 2.1.5, which is supported natively for 64-bit systems.
Web Services
The latest application Web service calls can be found in the sbmappservices72 WSDL. The latest administrative Web service calls can be found in the sbmadminservices72 WSDL. All TeamTrack Web services and earlier SBM Web services (including ttwebservices, aewebservices70, and aewebservices71) are still compatible with this release. However, these WSDLs have been deprecated and will not contain any of the new calls or parameters found in SBM Web services version 7.2. For new Web service implementations, use SBM Web services version 7.2.
Build Numbers
The following component build numbers apply to this version:
- SBM User Workspace: Build 99
- SBM Composer: Build 026
- SBM System Administrator and SBM Application Administrator: Build 99
- Application Repository: Build 83
- SBM Configurator: 10.01.01.04.78
- Database version: 1011040106
- English – 10.1.1.4
- Japanese – 2009 R4.01 (the translated content applies to version 2009 R4.01)
Third-Party Tools
For third-party software information, refer to:
What's New
The following features have been added in this release.
Securing Your Installation
Attempt to Send All Notifications
The Notification Server can now attempt to send every applicable notification for an item, regardless if the notifications might no longer be applicable. Normally the Notification Server does not send messages each time an item changes state if the changes happen in rapid succession. Instead, the service assumes that a message should be sent for only the last state change that occurs. The Notification Server can now attempt to send messages for each individual change that occurs, even if the change is no longer relevant to the current status of the item.
Additional Changes
The following sections describe additional features that have been changed or added to SBM 10.1.1.4
Administrator Changes
- The Subscriptions page in SBM Application Administrator now enables you to manage subscriptions for several users at once using either the Select All or Clear All drop-down lists.
SBM Composer Changes
- Log Viewer was renamed to Common Log Viewer to clarify the association between the Common Log in Application Repository and its viewer in SBM Composer.
Orchestration Changes
- The Log field in the Event Summary dialog box in SBM Application Repository now includes detailed information about exceptions or faults that were reported when an asynchronous orchestration workflow failed.
Solution Support
- Resource Management (Serena Demand Manager)
Resource management has been added to SBM Application Administrator. Resources enable you to manage team assignments, scheduling, job functions, and skills of employees in your organization. This information can be used for assigning resource teams to plans in Serena Demand Manager.
- Transition Pause (Serena Demand Manager)
Items in SBM User Workspace can now be "paused" by Serena Demand Manager. This means that once an item is paused by Serena Demand Manager, the item's state cannot change until the item is subsequently unpaused by Serena Demand Manager. When an item is paused, only state-to-same-state transitions are available for the item.
Note the following information about paused items:
- When an item is paused, users cannot transition the item to another state via mass update, an API call, nor by Web services. Similarly, users cannot change state values for paused items using Rich Editable Grid reports until the items are unpaused from Serena Demand Manager.
- You can add a new optional Pause Status system field to your applications in SBM Composer to easily search and report on paused items. For example, once you add the Pause Status field and deploy the process app, you can display the Pause Status field as a column in reports, filter report results based on Pause Status reason values, and sort report results based on an item's Pause Status value.
- When an item becomes paused or unpaused by Serena Demand Manager, the item's change history is updated in SBM User Workspace.
- The current pause status is displayed after the item's title in the item view (for example, IDM Project Issue - 000195: Item 1 ( Paused )). Note that this status is not part of the item's value display format; rather, it only appears in the Item Details pane when you view an item.
- The new optional Pause Status system field displays the reason an item is paused and therefore unable to use transitions that move it to another state. The related this item is paused/unpaused condition is now available for form actions.
- New notification rule operators have been added for items that have been paused by Serena Demand Manager. You can now create notification rules when an item Changes to Paused or Changes from Paused. For more information, see the "Condition Settings" section in the SBM Application Administrator Guide.
- A new template tag has been added for
notification templates:
- $PAUSESTATUS()
Use to indicate whether as item is paused or unpaused. If an item has been paused by Serena Demand Manager, the tag returns "Paused".
- $PAUSESTATUS()
- Demand Widget (Serena Demand Manager)
The new Demand Widget control for state forms displays information about an item in the context of Serena Demand Manager (a Serena Orchestrated Ops solution).
- Smart Search (Serena Service Manager)
A Smart Search tab has been added to SBM Configurator. Smart Search provides sophisticated search handling by recognizing keywords, phrases, synonyms, wild cards, and returning related knowledge base items.
Upgrades
Please refer to prior readmes for a list of features and changes that were added in another version before this release.
- TeamTrack 6.6.1.x
- Serena Business Mashups 2009 R1.0x
- Serena Business Mashups 2009 R2.0x
- Serena Business Mashups 2009 R3.0x
- Serena Business Manager 2009 R4.0x
- Serena Business Manager 10.1
- Serena Business Manager 10.1.1.1
- Serena Business Manager 10.1.1.2
- Serena Business Manager 10.1.1.3
New Installations of Serena Business Manager
If this is a new installation, download version 10.1.1.4 from http://www.serena.com/support and then follow the instructions in the SBM Installation and Configuration Guide to install Serena Business Manager.
Upgrading From Tracker
There are two methods for migrating from Tracker to SBM. For more information on migrating your Tracker data to SBM, refer to the "Migrating Tracker Data to SBM" solution (S138468).
Upgrading From TeamTrack 6.6.1.x
If you have TeamTrack 6.6.1.x installed, download version 10.1.1.4 from http://www.serena.com/support, and then follow the instructions in Moving to Serena® Business Manager. This guide only covers upgrades from TeamTrack.
You should also refer to solution S137372 to learn about the upgrade preparation utility.
Upgrading From Earlier Versions of SBM
To test this release, you must mimic your installation on a separate set of hardware. This test installation should include all environments used by your system. You can then upgrade and test this installation before upgrading your production installation. To upgrade successfully, SBM 10.1.1.4 must be installed on each server and client machine.
- Major upgrades are upgrades from any version prior to 2009 R3. If you are upgrading from a version prior to 2009 R3, review the Important Notes for Major and Minor Upgrades below and then follow the steps in solution S138037 to upgrade to 10.1.1.4.
- Minor upgrades are upgrades from version 2009 R3 and later. If you are upgrading from version 2009 R3 or later, review the Important Notes for Major and Minor Upgrades below and then follow the steps in Minor Upgrades to upgrade to 10.1.1.4.
Important Notes for Major and Minor Upgrades
- SBM Configurator
warns you if your installation currently uses default certificates (which
should be replaced) or if your current certificates will expire soon.
Important: To properly secure your installation, you must generate new key pairs even if you do not plan to use SSO. If you do not generate new key pairs, then the default certificates that the STS inherently trusts are used. To increase security, launch SBM Configurator and generate new unique certificate for all components. For details, see "Securing SBM" in the SBM Installation and Configuration Guide.
- You must have one instance of SSO installed in order to have a functional instance of SBM, regardless if you plan to enable SSO or not. The SBM upgrade does not install missing components; therefore, if SSO is not currently installed, you must run the installer, perform an uninstall, and then reinstall SBM with SSO included. In a distributed installation, choose a server to host SSO, and then perform the uninstall and reinstall on that machine.
- For Oracle systems, the required roles and privileges for the SBM schema user have changed. Please visit S133641 for details.
- You must ensure that all of the SBM components are installed on one or more servers prior to upgrading. This includes SSO and SBM Common Services. You can choose to enable or disable SSO once it is installed; however you still must install the SSO component for SBM to function properly.
- You must disable the
User Access Control (UAC) setting before you
install
SBM
on Windows 2008 or 2008 R2. To disable this setting, perform the following
steps:
- From the Windows Start menu, open the Control Panel and select User Accounts.
- Turn off UAC:
- On Windows 2008, open the User Accounts window, click Turn User Account Control on or off and clear the Use User Account Control (UAC) to help protect your computer check box.
- On Windows 2008 R2, click Change User Account Control settings, and move the slider to the Never notify position.
- Click OK.
- Reboot the server and perform the install.
After the installation is finished, you can enable UAC; however, you must disable it again if you attempt to uninstall SBM.
-
Microsoft .NET Framework 3.5.1 must be installed on all Windows
machines. If it is not detected, .Net Framework 3.5.1 is installed by
SBM.
To save download and installation time, you may want to install version 3.5.1
prior to running the
SBM
installer. Also, if you will not have Internet access during the installation,
you should download and install 3.5.1 beforehand.
Note: Microsoft .NET framework 3.5.1 is not installed by the suite installer on Windows 2008 R2 servers if version 3.5.1 is not detected on the server. To work around this issue, navigate to the Control Panel, select Programs and Features, select Turn Windows features on or off, and install .NET 3.5.1 from the Features list.
- On Windows 2003 systems, the
SBM installer
requires Windows Installer 4.5 in order to install SQL Express without a system
restart. (This is not a requirement if you are not installing SQL Express). If
you do not pre-install Windows Installer 4.5, the
SBM installer
performs the install for you and prompts you to restart the system after you
select the option to install SQL Express. When the system
restart is finished, you must begin the installation again starting from the
Welcome dialog. Therefore, to avoid an unscheduled system restart, download and
install Windows Installer 4.5 from
Microsoft, restart your server, and then
install
SBM. To
determine if version 4.5 is already installed, open the command line and enter
the following:
msiexec -?
- If you are connecting to a Microsoft SQL Server 2008 database, you must select the 2008 SQL Server Native Client driver. The SQL Server ODBC driver is not compatible with Microsoft SQL Server 2008.
- If you upgrade to Windows 2008 in addition to upgrading
SBM,
you must enable the Web Server (IIS) role before you install
SBM Application Engine.
If the Web Server (IIS) role is not already configured on your Windows 2008
server, see the "Enabling the Web Server (IIS) Role in Windows 2008 Server"
section in the
SBM Installation and Configuration
Guide
for steps to enable the role.
Note: SBM requires Internet Protocol Version 4 (IPv4) on Windows 2008 systems (IPv6 alone will not work). Both IPv4 and IPv6 protocols can be enabled simultaneously on Windows 2008; however, SBM requires at least IPv4 on each Windows 2008 server in your SBM environment.
- Upgrade support for migrating to a 64-bit version of
SBM is handled
through a new suite installation on one or more 64-bit Windows 2008 R2 servers.
You can either perform a
Custom install that installs one or more
SBM components
on multiple 64-bit operating systems or you can perform a
Complete install, which installs every component on a single
64-bit server. You can still perform Remote Administration tasks or connect
directly to the database via ODBC using 32-bit clients.
You can use the SBM System Administrator that is installed by the suite installer on a 64-bit Windows 2008 R2 server to upgrade the database. As part of the upgrade, review and upgrade any scripts and APIs that were originally created on a 32-bit operating system to ensure that they also run on a 64-bit system. For example, if you have any scripts that load .dll files, those dll files must be upgraded to run on a 64-bit machine.
The hardware requirements for SBM running on a Windows 2008 R2 64-bit operating system are as follows. The memory requirements are greater than those for a 32-bit operating system.
- Recommended Requirements – 2 GHz or higher multi-processors; 16 GB memory; 10 GB operational disk space.
- Minimum Requirements – 800 MHz or higher single processor; 8 GB memory; 2.5 GB operational disk space.
- For Oracle systems, you must perform the database upgrade using
either the Mashup2009 DSN that is installed with
SBM
or a system DSN that uses the "Oracle for SBM" driver
that is installed with
SBM. As part
of the upgrade, the existing Mashup2009 DSN is automatically converted to use
the new "Oracle for SBM" driver. If you attempt to use
a DSN other than the Mashup2009 DSN provided by
SBM,
the
SBM System Administrator
prompts you to either use the Mashup2009 DSN or to modify or create a DSN that
uses the "Oracle for SBM" driver.
Important: The underlying driver used in the "Oracle for SBM" DSN that ships with SBM has changed in SBM as of version 10.1. If you currently use the Mashup2009 DSN with SBM, you do not need to do anything. If you created your own custom DSN with the "Oracle for SBM" driver prior to upgrading to SBM 10.1 or later, then you must recreate the DSN and use the new "Oracle for SBM" driver that ships with SBM after the upgrade is finished.
If you previously designated a SID for Oracle, then that SID is automatically used in the Service name field in SBM Configurator. Verify with your DBA that the correct service name is now used in the Database Servers tab of SBM Configurator.
- For existing multi-environment installations (the
development, test, and productions servers that you plan to upgrade), you can
create new databases to host Common Log data for each environment.
For example, you can back up your current Common Log database on your production server and restore it to a new space on your development database server. Once the data has been restored in the development database, purge the existing Common Log database space on the production database server and create a new database space for your test server (this results in two blank databases--one for test and one for production). Run SBM Configurator on the test and development SBM servers and update the Database Servers tab with the database connection information for the two new unique Common Log databases.
This ensures that you have unique databases for the Common Log in each environment and it also moves your existing Common Log data from the previous production space into the new development space.
- States, transitions, and projects now have unique internal names
that make it possible to unambiguously refer to them in a Web service,
AppScript, or API call. (This enables you to change the display name of the
state or transition and not interfere with any of these references). Note the
following:
- The internal state and transition names are derived from the internal name of their defining workflows. These internal values are set when you open a process app in SBM Composer for the first time after upgrading to SBM 10.1 or later versions.
- You can change the new default internal names for states and transitions at any time before the process app is published for the first time in SBM 10.1 or later versions. Once the process app is published, the internal names cannot be changed.
- The internal names for existing projects are automatically
created upon upgrade to
SBM 10.1 or
later versions. When you create new projects in the
Application Administrator
in versions after 10.1,
SBM
automatically creates the internal project name for you.
Note: During promotion, if the internal project name clashes with an existing internal project name, the internal name in the target database is affected in one of two ways:
- For new projects that are added during promotion, when a conflict occurs, the project name in the target database will be a blank or empty string.
- For existing projects that are updated during promotion, when a conflict occurs, the project name in the target database remains unchanged. If the internal name in the incoming XML does not conflict with the internal name in the target database, then the promoted project's internal name is used.
- The Java Notification Server does not support the
MAPI standard. For upgrading customers formerly using MAPI with the
Notification Server, you can now connect to your Microsoft Exchange server
using the
Exchange e-mail server type in
SBM Configurator.
The
Exchange option enables
SBM
to communicate with your Microsoft Exchange server using the MS Exchange Web
services API.
For customers currently using MAPI, perform the following steps to configure the Notification Server to connect using MS Exchange:
- Run the SBM Configurator on each server where the Notification Server is installed.
- In the Mail Services tab, select the Notification Server tab.
- In the E-Mail Server Type drop-down list, select Exchange.
- Enter your current Exchange server version, connection URL, and system user credentials.
You might use the Exchange option if your company does not allow connection through SMTP. The Exchange protocol is also available for use with the Mail Client in the event your company does not allow connection through POP3 or IMAP. If no such restrictions exists, consider choosing SMTP for the Notification Server and POP3 for the Mail Client because they enable faster connection speeds than MS Exchange.
- In
SBM
2009 R4, application icons were introduced. You could specify an icon in the
application editor in
SBM Composer,
and the icon appeared on the application tabs in the
SBM User Workspace.
If you did not specify an icon, a default red icon was automatically used. As
of
SBM
10.1, the red icon is no longer the default; instead no icon is used if you do
not specify one.
- If you are upgrading from a release earlier than SBM 2009 R4, you will see no change; no icon will appear on the application tab.
- If you are upgrading from SBM 2009 R4 or later, and changed the default red icon to something else, you will see no change; your icon will still appear on the application tab.
- If you are upgrading from SBM 2009 R4 or later, and kept the default red icon, you will no longer see the icon; the application tab will be blank. If you want to restore the red icon, you can select it from the list that opens when you select "New image..." from the drop-down list in the application editor in SBM Composer. Redeploy your process app after making this change.
- Security Tokens are now generated for authenticated users
regardless of the log in method you choose in
SBM.
Note the following behavior for upgrades from releases prior to 10.1:
- If SSO was enabled in a prior release, after the upgrade to 10.1.1.4, deployed apps will use Security Tokens automatically without having to be redeployed.
- If SSO was disabled in a prior release, after the upgrade to 10.1.1.4, deployed apps will not use Security Token authentication unless they are redeployed (even if SSO is enabled after the upgrade).
- The following information only applies to
SBM systems in
which external events were used with orchestration workflows and
SSO
was not used:
- With the use of security tokens for all communication with SBM components regardless of authentication method, it is now necessary to provide credentials in the User element of external events that are processed by the Event Manager. Credentials must be supplied in order to receive a security token.
- Previous
SBM
releases allowed anonymous events if
SSO
was disabled. As of
SBM
10.1, security tokens are used in all underlying communication. As part of the
upgrade process, in order to still accept external events without credentials,
the Event Manager is automatically configured to continue to accept external
events without authentication credentials. If
SSO
was enabled prior to upgrade, then it is assumed that external events always
included credentials and will continue to do so in your environment.
Important: If you are currently using external events without SSO, it is strongly recommended that you adjust the source of those external events to now include credentials. Once you adjust the external source to include a credential, you can then manually override the Event Manager settings by setting the no_authentication parameter to “false” in the alf.properties file. For configuration instructions, see solution S138463.
- After upgrading, the no_authentication setting is independent of the SSO setting. If you are performing a new installation, you can override the default behavior for the Event Manager and enable it to accept external events without credentials. For configuration instructions, see solution S138463.
- For SBM Application Engine Web services, the SBM Application Engine auth still overrides the security token auth. In some cases, this is useful in day-to-day operations and may be useful if you are upgrading from versions prior to 10.1. For example, orchestration workflows that contain coded auth for the SBM Application Engine service calls will continue to work if the external event is changed to send a credential; the coded auth will override the security token and continue work as it did prior to upgrade.
- User credentials in
SBM Application Engine
Web service calls that use Basic authentication are now handled exclusively by
SBM Application Engine
itself, instead of IIS. This configuration is common if your
SBM
system is set up with
NT Challenge Response for end-user authentication. After
upgrade, this means that you must now specify the Windows domain for Web
service calls in
SBM System Administrator,
otherwise the domain that the IIS server machine is installed on is used for
user validation.
As part of the upgrade, SBM Configurator should perform the following steps for you automatically to accommodate this new requirement. However, for systems that use NT Challenge Response authentication that have an authentication override set in SBM System Administrator, you must perform the following steps manually:
- In IIS, copy or take note of the current domain that you have set for Basic Authentication on the GSOAP directory.
- Clear Basic Authentication from the GSOAP directory and only specify Anonymous Access or Anonymous Authentication. (In previous versions of SBM, you had to specify Basic Authentication on the IIS GSOAP directory and provide the domain there).
- From the Options menu in the SBM System Administrator, select Settings or click the Settings icon on the toolbar. The Settings – Server tab opens.
- Paste or enter the correct Windows domain in the Default domain for web services field.
- If your database does not contain at least one Regular User or Managed Administrator account with Remote Administration privilege, the Reset Administrative User Access Wizard appears immediately after the database upgrade is finished. You use this wizard to define at least one user as your primary system administrator (an account that has Regular User or Managed Administrator product access with Remote Administration privilege). Once the wizard is finished, you should be able to log in to SBM Application Administrator using the user account that you specified in the wizard. For details, see the SBM System Administrator Guide.
-
Note: The following information is only applicable if you had previously upgraded to 10.1 or 10.1.1.1. If you did not upgrade to either version prior to upgrading to 10.1.1.4, then you can ignore the following information.Values in promotion profiles that were created in 10.1 or 10.1.1.1 were set to All by default. As of 10.1.1.2, entities for new items (items added to a process app since the profile was created) will be set to None by default.In addition:
- Profiles created prior to 10.1 that had entities set to None may have been incorrectly using All. These entities will be set back to None.
- Profiles created in 10.1 or 10.1.1.1 that had entities set to the default All may also be set to None. These entities must be manually corrected.
Minor Upgrades
This section provides important notes and upgrade instructions for upgrades to SBM 10.1.1.4 from version 2009 R3 and later.
Before you upgrade, review the information above in addition to the following topics:
Pre-upgrade Steps
Follow these steps before beginning the upgrade:
- Verify that SBM 2009 R3 or later is installed on your system by opening the "About" box in the Web interface. You can also view the current version of each component in the System Information tab of the SBM Configurator.
- Back up your existing database before installing this version.
- Back up the SBM installation directory structure on your Application Engine Web server machine.
- Download the release from support.serena.com.
- Stop the following services on the Application Engine Web server:
Internet Information Services – IIS, Serena Common JBoss, and the Notification
Server and Mail Client.
Note: You can stop IIS and the Serena Common JBoss Service on the Manage Services tab of SBM Configurator.
Server Installation
- Extract the server installation files.
- On the server machine for each server component, launch the suite executable. An installer message prompts you to confirm that you are upgrading your system. Click Next to continue.
- The
Upgrade Summary dialog box appears and
summarizes the components that are currently installed on the server and ready
for upgrade. The current installation directory that will be upgraded is noted
as well.
As of SBM 10.1, the Notification Server and Mail Client are powered by Serena Common JBoss and installed independently from the SBM Application Engine component. For upgrades from versions prior to 10.1, the option to install the new SBM Mail Services (which contains the Notification Server and Mail Client) is selected by default (except on servers that host only the SBM Application Engine and no other components; in that scenario, you must manually select the SBM Mail Services check box to install the Notification Server and Mail Client because the installation of these components now includes the Serena Common JBoss service, which consumes additional resources on the server).
Before you install the SBM Mail Services, review the following installation considerations:
- For your production environment, if you have a high volume of Notification Server and Mail Client activity, you can now add additional instances of the SBM Mail Services. Installing multiple instances not only provides failover in case one of the servers shuts down; it also improves the overall performance of notification handling because the processing load is distributed across multiple servers.
- For installations with over 1000 users or heavy orchestration usage, consider installing the SBM Mail Services on a dedicated server without any other SBM components. If you install the SBM Mail Services separately, you must enter the SBM Application Engine host name and port in SBM Configurator after the installation. This enables the Notification Server and Mail Client to communicate with the SBM Application Engine.
- For multi-environment installations that include separate SBM Application Engine installations for test, staging, and production environments, install the SBM Mail Services at least once in each environment.
After you have reviewed the components that are currently installed and decided whether or not to install the SBM Mail Services, click Upgrade Now to proceed.
Note: For minor upgrades, if you want to uninstall existing components or install new components other than the SBM Mail Services, you must use the Windows Add/Remove Programs utility to completely uninstall SBM and then perform a Custom install using the suite installer again (which performs a clean install). This process does not upgrade the current installation. It is recommended that you back up your existing SBM installation directory before you uninstall and reinstall with different component selections. Once the desired components are installed, continue to the next step and reconfigure your installation using SBM Configurator. - At the end of the installation process, click
Configure to launch
SBM Configurator.
You must complete the
SBM Configurator
wizard before you can access
SBM.
Note: If you are prompted to restart your server, SBM Configurator launches automatically once the server has restarted. (On Windows 2008 systems, you must launch SBM Configurator manually once the server has restarted). If you decline to restart the server at this time, you will not be able to run SBM Configurator until the server has restarted.When you launch SBM Configurator, it detects that you are upgrading your system and it upgrades the file system by merging existing configurations from your previous installation into the new installation files. After SBM Configurator is finished upgrading your file system, you can run it anytime thereafter to verify or modify your configuration settings as needed. Guidance is available by clicking the Help buttons throughout the wizard.
- Launch the SBM System Administrator and upgrade the SBM Application Engine database. If you use multiple environments, you must perform this step for each database in each environment.
- Review the database upgrade log file in the Log folder of the installationDirectory\Serena\SBM\Application Engine directory and correct any problems that occurred during the upgrade. If the log file is empty, no errors or warnings occurred during upgrade.
- Merge custom modifications to HTML templates, e-mail templates,
and Web interface online help files made to your upgraded files. Backup
templates are stored in a backup folder in the
installationDirectory\Serena\SBM\Application
Engine\Backup<version>-<date>-<time>
directory.
Note: See solution S139247 for a list of configuration Files, Web Interface templates, JavaScript files, and strings that have changed in this release. You must manually merge some of your existing SSO customizations into the newly installed files after you upgrade your software and database.Important: If you installed the TT4ZMF integration prior to upgrading, you must follow the instructions in the TT4ZMF readme to reinstall the integration after the SBM upgrade is complete.
- If you performed the previous step, open SBM System Administrator, select File, and then select Put Files in Database. ALL templates and images in the database are replaced by files on your local machine.
- In SBM Configurator, verify that these services are started in the Manage Services tab: SBM Application Engine Web server (Internet Information Services - IIS), Serena Common JBoss, Notification Server, and Mail Client.
- Instruct all SBM Composer users to install the client tools using the instructions in the following section (Client Installation).
- Instruct SBM User Workspace and SBM Application Repository users to clear the cache in their Web browsers.
Client Installation
The client executable contains SBM Composer and is intended to be run only on client machines.
Previous versions of SBM System Administrator are automatically uninstalled as part of the upgrade (administrative duties are now performed using SBM Application Administrator). Previous versions of SBM Composer are upgraded automatically and do not need to be uninstalled prior to upgrading. The new versions are installed in the same location as the old versions.
To upgrade SBM Composer:
- Download the client installer from support.serena.com.
- Launch the installer by double-clicking the file.
- Click Next on the Welcome dialog box.
- Click Install to upgrade the current client installation.
Fixed Issues
A list of defects fixed in this version can be found in the Knowledge Base. You must have a Serena.com user account to view items in the Knowledge Base. Register for a free account if you do not have already have one.
Beginning in SBM 10.1, user accounts are managed in SBM Application Administrator rather than in SBM System Administrator. SBM Application Administrator, which requires a connection to the SBM Web server, is not available if the number of users in your system exceeds the number of installed seat licenses.
If you receive a seat license error in a version earlier than SBM 10.1.1.4, contact Customer Support for assistance is resolving the issue. If you have SBM 10.1.1.4 or later installed, the Users tab in the SBM System Administrator is enabled automatically if you encounter this problem. Open SBM System Administrator and delete or modify user accounts so that they are in compliance with their seat licenses. (If you encounter this problem and the SBM System Administrator is already open, you need to close it and reopen it for the Users tab to appear.) Once you resolve user accounts, the Users tab is not visible the next time you open the SBM System Administrator.
Known Issues
For a complete list of known issues and potential workarounds, refer to the Knowledge Base.
Administrator Issues
- SBM Application Repository can crash in Internet Explorer 9 if you are not using the Compatibility View feature. To use this feature, select Compatibility View settings from the browser's Tools menu and adjust the settings.
- Only resource teams that do not have child teams can be assigned to plans in Serena Demand Center. To work around this problem, do not establish a team hierarchy when creating resource teams in SBM Application Administrator.
- You cannot delete process app snapshots that were loaded from a file in SBM Application Repository. SBM Application Repository returns an invalid message that states that the snapshot's source was a solution and therefore it cannot be deleted.
-
Note: The following issue is only applicable if you had previously upgraded to 10.1 or 10.1.1.1. If you did not use either version prior to upgrading to 10.1.1.4, then you can ignore the following information.Values in promotion profiles that were created in 10.1 or 10.1.1.1 were set to All by default. Starting with 10.1.1.2, entities for new items (items added to a process app since the profile was created) will be set to None by default.In addition:
- Profiles created prior to 10.1 that had entities set to None may have been incorrectly using All. These entities will be set back to None.
- Profiles created in 10.1 or 10.1.1.1 that had entities set to the default All may also be set to None. These entities must be manually corrected.