Install and configure IBM Rational System ArchitectVersion 11.3 : Part 1. Stand-alone installation withMicrosoft SQL ExpressSami JoueidiSenior Enterprise ArchitectIBM
25 March 2010
This Part 1 of a three-part series. This article provides an overview of IBM® Rational® SystemArchitect® terminology and explains the steps for installing and configuring the software toconnect to Microsoft SQL Express. The example is targeted for professional encyclopedias,which are one of the two types of repositories in Rational System Architect.
View more content in this series
Installing and configuring IBM® Rational® System Architect might be challenging especially sinceit requires a relational database management system (RDBMS) for its repository. Moreover, thevarious available installation scenarios including installations to Microsoft® SQL Server 2005Express, Microsoft® SQL Server 2005, and Oracle, combined with the imposed network andsecurity constraints on workstations, can make the installation more complex.
This three-part series of articles covers Rational System Architect Version 11.3. It describesinstallation in a secured environment and configuration to connect to Microsoft SQL Server 2005(SQL Server) and Microsoft SQL Server 2005 Express (SQL Express) in a non-shared and sharedenvironment, targeting professional and enterprise encyclopedias. Each part also includes a BasicTroubleshooting section.
This article, Part 1 of a three-part series, provides an overview of Rational System Architectterminology and utilities. It then walks you through the steps of installing and configuring thesoftware to connect to SQL Express on a workstation targeted to professional encyclopedias.
Part 2, Connect Rational System Architect to Microsoft Server 2005, describes the steps toconnect a server environment targeted to professional encyclopedias.
Part 3, Configure Rational System Architect by using Catalog Manager, explains the steps foran installation targeted to enterprise encyclopedias by using Rational System Architect CatalogManager.
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 2 of 21
Overview of IBM Rational System ArchitectRational System Architect is comprehensive enterprise architecture software that provides fullyintegrated support across four keys domains: business, information, systems, and technology. It isused for modeling to capture complex knowledge about organizations and related technology.
Empowered with this knowledge, executives, decision makers, and managers can analyze andoptimize current capabilities, because they will have a more thorough understanding of theorganizational structures, portfolio of business strategies, business processes, information flow,applications, and technology infrastructure. The result is an enhanced collaboration betweenstakeholders and improvement in the organization effectiveness to proactively respond to businesschanges and an enhanced ability to consider new capabilities.
Rational System Architect includes the Federal Enterprise Architecture Framework (FEAF) thatassists the U.S. Government departments and agencies in incorporating and using the U.S. Officeof Management and Budget (OMB) Reference Models, as well as the subsequent creation andpublishing of OMB Exhibit 300 and Exhibit 53 reports.
In addition, Rational System Architect is the most widely used enterprise architecture solutionin support of the U.S. Department of Defense Architecture Framework (DoDAF). It provides thecapabilities for building models representing U.S. Department of Defense (DoD) architectures andautomatically generates DoDAF work products and reports.
What you need to know before you startTerms and utilitiesInstalling and configuring Rational System Architect is a two-part process:
1. The first part is installing the software on the workstation.2. The second part is connecting Rational System Architect to an RDBMS (rational database
management system).
Rational System Architect depends on Microsoft® Windows® features provided in the latestservice packs and operating system upgrades. It has a native reporting engine to produce variousreports. It also has the capability to produce Microsoft® Excel and Microsoft® Word reports. Thiscapability requires these products to be installed on the workstation.
Rational System Architect also requires a license to unlock its various features. The licenses areavailable as either node-locked (user) licenses, which are tied to a specific workstation, or asfloating (server) licenses.
Rational System Architect encyclopedias
Rational System Architect provides an underlying storage mechanism for its repository to storeall diagrams and definitions, among other information. Consult the Rational System ArchitectInstallation Guide for software and hardware requirements.
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 3 of 21
This Rational System Architect repository is called an encyclopedia. An encyclopedia isa database within a Microsoft SQL Server instance. There are two types: enterprise andprofessional.
• Enterpriseencyclopedias are databases that have role-based access control and instance-level access control. These encyclopedias are attached to a Rational System Architectcatalog that controls access to these enterprise encyclopedias. These types of encyclopediasare managed by the Catalog Manager, an optional Rational System Architect add-on.
• Professional encyclopedias are standard Rational System Architect encyclopedias that arenot attached to a catalog.
Encyclopedias with Microsoft SQL Server or SQL Express
SQL Server and SQL Express are RDBMS (relational database management systems) that runon platforms (physical hardware, such as workstations or servers). Both SQL Server and SQLExpress run only on Microsoft operating systems.
SQL Express is a free, lightweight version of SQL Server. Rational System Architect bundles SQLExpress with its installation files. The Startup wizard provides an option to install SQL Express ona workstation.
SQL Server and SQL Express instances are a way of having more than one SQL server runningon a physical server or workstation. The databases and their objects (tables and views) arecreated within a SQL Server instance. Rational System Architect identifies the instance name bythe hostname and the instance name in this format:<hostname>\<instance name>.
Rational System Architect encyclopedias are actual databases. These encyclopedias can becreated only by using Rational System Architect, and they reside within a SQL Server instance, asFigure 1 shows.
In Figure 1, the tree view, shows a SQL Server instance called "RSA" running on a physical serverwith the hostname of IBM-MAX0Q2AIFG2. Within the IBM-MAX0Q2AIFG2\RSA instance areseveral Rational System Architect encyclopedias, such as Tutorial and Samples.
Figure 1. Tree view of Rational System Architect encyclopedias
The Encyclopedia Manager
developerWorks® ibm.com/developerWorks/
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 4 of 21
The Encyclopedia Manager is a utility that provides a set of tools for maintaining Rational SystemArchitect encyclopedias. It includes a subset of administrative functions in SQL Server EnterpriseManager. It provides the ability to attach, detach, back up, and restore Rational System Architectencyclopedias. It is also used to create logins to the SQL Server instances and to define roles anduser access to the encyclopedias.
The Startup Wizard
The Startup Wizard is the tool used to configure the settings for Rational System Architectinstallation. You start it by selecting Help > Startup Wizard.
You can use the wizard for these tasks:
• Install SQL Server Express to the local workstation• Connect to an existing SQL Server (or SQL Express) located on the workstation• Connect to an existing SQL Server (or SQL Express) located on the network
The wizard also provides the options for selecting the default framework and configuring thesample encyclopedia projects.
License requirements
Rational System Architect requires a valid license to unlock its features. Rational System Architectuses the FlexNet License Server to manage the licenses. This license server is automaticallyinstalled when Rational System Architect is installed and runs as a Windows service. The licensesare stored in a file called license.dat.
FlexNet licenses are available as either node-locked (user) licenses or floating (server) licenses.
Floating licenses
Floating (server) licenses are accessible on a network and are not tied to one particularworkstation. Instead, the license is tied to the workstation or server where the FlexNet LicenseServer is installed. In such configuration, not every workstation running Rational System Architectsoftware requires its own license.dat file. Instead, floating licenses provide a pool of licenses thatcan be shared among all Rational System Architect workstations. All floating licenses are placed inone license.dat file. The number of Rational System Architect workstation that can run concurrentlyis determined by the number of purchased floating licenses.
The floating configuration requires the FlexNet License Server to be network accessible by allRational System Architect workstations. Each workstation running Rational System Architect usesor "consumes" a license from the FlexNet License Server.
FlexNet License Server provides a graphical user interface program called LMTOOLS to managethe floating licenses. LMTOOLS functions include the start and stop actions for the lmgrddaemon,
ibm.com/developerWorks/ developerWorks®
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 5 of 21
which manages the licenses and the port number of the server to communicate with RationalSystem Architect. LMTOOLS is installed using the IBM Rational License Server TL setup.
Node-locked licenses
For a node-locked (user) license, the license is tied to a specific workstation. In such aconfiguration, every workstation running Rational System Architect requires having its own specificlicense.dat file.
1. Install Rational System ArchitectNote:The Rational System Architect installation described in this article focuses on SQL Express forprofessional encyclopedias.
Uninstall the previous version, if it existsYou must remove previous versions of Rational System Architect from the workstation beforeinstalling a new version.
1. Log on to the workstation as a workstation administrator.2. Access the control panel to uninstall any previous versions of Rational System Architect from
the workstation.
Install the new version1. Log on to the workstation as the workstation administrator.2. Run the Rational System Architect MSI file, and follow the prompts.3. Accept the license agreement.4. Enter the Customer Information: User Name and Organization (Figure 2).5. Click this option under "Install this application for:" Anyone who uses this computer(all
users).
Figure 2. Option to install this application for all users
developerWorks® ibm.com/developerWorks/
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 6 of 21
6. Choose a destination location. Accept the default unless you want to specify a differentlocation.
7. Supply license information.• Specify the license file location (path) for a node-locked license. It is best to store the
node locked license.dat file in the C:\Documents and Settings\All Users\ApplicationData\IBM\System Architect directory so that it can be accessible to all users of theworkstation. Tip: Show hidden folders to get to the path.
• Or specify the license server for a floating license (port@license-serverhostname, forexample: 19393@LicenseServer hostname). For more information, consult the sectioncalled Install and configure a license server with a floating license.
Figure 3. Specify the path for the license file
8. Under "Please select a setup type," click Complete to install all of the Rational SystemArchitect options (Figure 4).
Figure 4. Choose All Program Features will be Installed
9. Click Next.10. Click Install to install the software.
ibm.com/developerWorks/ developerWorks®
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 7 of 21
11. Click Finish after it is installed.
The installation of Rational System Architect software on the workstation is now complete.
2. Configure SQL Express and the included encyclopediasRational System Architect requires an RDBMS (relational database management system) for itsrepository to store the diagrams and definitions. The next step is to install SQL Express on theworkstation, create a SQL Express instance, and install the tutorial and sample encyclopedias andother start-up options. The Startup Wizard automates this process.
Launch the Startup Wizard and install SQL Express
1. Log on to the workstation as the workstation administrator2. Start Rational System Architect either by selecting Start > Program Files > IBM Rational
>IBM Rational System Architect or by double-clicking the Rational System Architect iconon your desktop.
3. Click Help > Startup Wizard to start the Rational System Architect Wizard if did not alreadystart automatically.
Figure 5. Launch the Startup Wizard
4. Click Yes to navigate to the next screen.5. On the Welcome to Rational System Architect Startup Wizard dialog click Next.6. On the "Select options to configure" screen (Figure 6), click Next to accept the default
settings.
Figure 6. Startup Wizard default options
7. Under "Configure where encyclopedia data will be stored," select the option to install SQLExpress locally on the workstation (Figure 7).
developerWorks® ibm.com/developerWorks/
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 8 of 21
Figure 7. Option to Install SQL Express Locally
8. Click Next to get to the Configure Startup View screen.9. Click Welcome guide, and leave the Default Welcome Guide Generic option selected.
10. Click Next to move to the Configure Sample Encyclopedia Projects screen (Figure 8).11. Uncheck Auto Open and Open Tutorial for DoDAF Tutorial.
12. Click Next.13. Click Finish to complete the installation steps.
When the installation is finished, you will be prompted to enter an Audit ID. The Audit ID is usedto track the changes made by a user to diagrams and definitions in the encyclopedia for auditpurposes.
14. Enter an Audit ID (your log in name), and then click OK (Figure 9).
Figure 9. The "Enter Audit ID" window
ibm.com/developerWorks/ developerWorks®
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 9 of 21
At this point, both Rational System Architect and SQL Express are installed on the workstation. ASQL Express instance called RSA is created.
The following are additional steps that are necessary to complete the software configuration.
Enable SQL server network protocols
SQL Express is usually installed as a named instance. The named instance is identified by thenetwork name of the computer and the instance name that you specify during installation. TheTCP and Named Pipes network protocols are installed by SQL Express setup. However, theservices are sometimes disabled by default, so you must explicitly enable them.
1. Log on to the workstation as the workstation administrator2. Right-click the My Computer icon on your desktop and select Manage from the drop-down
menu to open the Computer Management window.3. Expand Services and Applications.4. Expand SQL Server 2005 Network Configuration.5. Select Protocols for RSA, where RSA is the instance name (Figure 10).6. Ensure that the Shared Memory, TCP/IP, and Named Pipes protocols are enabled.
Figure 10. Enable SQL server protocols
The next step is to restart the SQL server service for the instance for the changes to take effect.
7. Under Computer Management, expand SQL Server Configuration Manager if it is notalready expanded from
8. Click SQL Server 2005 Services.9. Right-click SQL Server (RSA), where RSA is the instance name.
10. Ensure that NT AUTHORITY\NetworkService is the services owner (the next sectionexplains more about that service).
11. Click Restart to stop and then restart the SQL server service.
developerWorks® ibm.com/developerWorks/
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 10 of 21
Figure 11. Restart SQL server service
3. Create a shared folder for encyclopedia backupsOn Windows Server 2003 and Windows XP, the SQL Express services run under a specialaccount called NT AUTHORITY\NetworkService. This account is also known as NETWORKSERVICE or SERVICE. It has minimum amount of security privileges, which minimizes networkattacks on the workstation or server.
The Encyclopedia Manager provides Rational System Architect administrators the ability to backupand restore Rational System Architect encyclopedias. The backup files are written to a shareddirectory. NT AUTHORITY\NetworkService must have both read and write access to this directory.To allow Network Service read and write access to the folder, the security for the folder must bemodified. Follow these steps to create a shared folder and modify the security:
Enable Simple file sharing option1. Log on to the workstation as the workstation administrator.2. Click Start > Programs > Accessories > Windows Explorer.3. Click Tools > Folder Options.4. Click the View tab.5. Under Advanced Settings, scroll down to the end of the list, and uncheck Use Simple file
sharing option.6. Click Apply.7. Click OK.
Create the shared folder1. From Windows Explorer, navigate to the drive or folder where you want to create the shared
folder (example: c:\Document and Settings\All Users\Documents).2. Select File > New > Folder to create a new folder3. Type saDBShare as the (suggested) name for the new folder, and then press Enter.
Modify security settings for the new folder1. Right-click the new folder saDBShare, and then select Sharing and Security.2. Click Security tab and then click Advanced.3. Click to clear Inherit from parent the permission entries that apply to child objects.4. In the Security dialog, select Copy.5. Click Apply.
ibm.com/developerWorks/ developerWorks®
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 11 of 21
6. In the Advanced Security Settings dialog, select Add.7. In the Select User or Group dialog, for the object name, type NETWORK.8. Click Check Names.9. Select NETWORK SERVICE, and then click OK.
10. In the Select User or Group dialog box, click OK.11. In the Permission Entry dialog box, click Allow for the Full Control permission.12. Click OK.13. Repeat the steps to add SERVICE.14. In the Advanced Security Setting window, click Apply, and then click OK.
Share the folder and modify the permissions1. From the saDBShare folder Properties dialog, click the Sharing tab and then select Share
this folder.2. For the name of the shared folder, enter saDBShare.3. Click Permissions.4. In the Permissions for dialog, click Add.5. In the Select Users or Groups dialog, type NETWORK SERVICE, and then click Check
Names. If NETWORK SERVICE is not found, type NETWORK instead.6. Click OK.7. In the Permissions for dialog box, select NETWORK SERVICE, and then for the Full
Control, click Allow.8. Click Apply.9. Repeat the steps for SERVICE.
10. In the Permissions for dialog box, select Everyone, and then click Remove.
NETWORK SERVICE (or NETWORK) and SERVICE now show under Group or user names.
11. Click Apply, and then click OK.12. In the Properties dialo box, click Apply, and then OK to close the window.
Tip:To back up and restore Rational System Architect encyclopedias by using the EncyclopediaManager, you can connect to this shared folder by using its Universal Naming Convention (UNC)format (\\computername\saDBShare) or by using the mapped drive.
4. Grant the BUILTIN\Users group SQL server rolesNote:To allow Rational System Architect users access to SQL Server or SQL Express instances andencyclopedias, SQL Server security uses either Windows authentication (for local or domainusers) or SQL Server authentication (for users defined within SQL Server by the databaseadministrator). For this example, you will use Windows authentication.
So far, the workstation administrator is the only person with the rights to use Rational SystemArchitect and create Rational System Architect encyclopedias. Users who belong to the BUILTIN\Users group are not automatically granted rights to connect to SQL Server nor can they create oruse Rational System Architect encyclopedias.
developerWorks® ibm.com/developerWorks/
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 12 of 21
Grant dbcreator and sysadmin rolesThe next step is to grant the Windows BUILTIN\Users group dbcreator and sysadmin roles.Rational System Architect users who belong to this group will be able to create and modifyRational System Architect encyclopedias within the SQL Express instance. This task isaccomplished by using the Encyclopedia Manager for SQL Server utility.
1. Log on to the workstation as a workstation Administrator2. Click Start > All Programs > IBM Rational > IBM Rational Lifecycle Solutions Tools >
IBM Rational System Architect 11.3 > SAEM(SQL Server) utility.3. Click Server > Connect to create a connection to the SQL instance.4. From the drop-down menu, select the local SQL Express instance. The SQL instance is in
the form of <local hostname>\<instance name>.5. Select Windows for authentication (Figure 12).6. Press OK.
Figure 12. Use Windows Authentication to connect to a SQL server
Now, grant BUILTIN\Users group dbcreator and sysadmin roles:
7. Click Server > Logins to see a list of existing Windows users and groups.8. Select the BUILTIN\Users group.9. Click the Edit icon (Figure 13) to edit the properties for the Windows BUILTIN\Users group.
Figure 13. Edit BUILTIN\Users Group properties
10. From the Properties window, click the Server Roles tab.11. Check both sysadmin and dbcreator options to give the group administrator rights to the
SQL Express instance and the ability to create encyclopedias within the instance.12. Click OK, and close the Login Properties window.13. Click Server > Disconnect to disconnect from the SQL instance.
ibm.com/developerWorks/ developerWorks®
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 13 of 21
14. Close the SAEM(SQL Server) utility.
Figure 14. Use the check boxes to grant server roles
Users who belong to the BUILTIN\Users group now have the security rights that are necessaryto use Rational System Architect to connect to the local SQL Express instance and createencyclopedias. They are also considered the database owners of these encyclopedias.
5. Connect to SQL Express as a local or domain userYou have finished the workstation administrator's tasks for Rational System Architect installationand configuration. Non-administrative users of the workstation can now log in to the workstationand start the software. You can proceed with these steps:
1. Log off of the workstation as a workstation administrator.2. Log on to the workstation as a local or domain user.3. Start Rational System Architect (which automatically activates the Startup Wizard).4. Click Yes to dismiss the Tip of the Day dialog.5. On the Welcome to System Architect Startup Wizard screen, click Next.6. From the "Configure Where Encyclopedia Data Will Be Stored" dialog (Figure 15), click Next
to accept the defaults.7. Select the Existing SQL Server Located on this machine option to connect to the local
SQL Express instance.8. Click Next.
Figure 15. Select a server to host Rational System Architect encyclopedias
9. From the Available Local SQL Servers window, select the local SQL Express instance name.For this example: IBM-MAX0Q2AIFG2\RSA
developerWorks® ibm.com/developerWorks/
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 14 of 21
Figure 16. Select the Local SQL Server instance
10. Click Next.11. For the Connection Information option, select Use Windows authentication.
Figure 17. Specify Windows Authentication for the Local SQL Server
12. Click Next to navigate through the rest of the screens.13. Click Finish to dismiss the Summary of User Selections window.14. When prompted, enter an Audit ID.15. Click OK.
You will then see the Open Encyclopedia dialog. The next steps are to create a SQL Expressconnection, browse the sample encyclopedias, and create a new one.
Create a local SQL Express connection1. From the Open Encyclopedia window, click Existing to show the existing sample
encyclopedias included in Rational System Architect.2. Click the button under Connection to create a connection to the SQL instance.3. In the next dialog window, click New to create the connection .4. Under Connection Name in the Connection Manager dialog (Figure 18), type Local
Connection.5. From the combination box in the form of <workstation name>\<instance name>, select the
local SQL Express instance name. For this example, select this one:IBM-MAX0Q2AIFG2\RSA
6. Click OK.
Figure 18. Create a New Connection to the Local Instance
ibm.com/developerWorks/ developerWorks®
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 15 of 21
When the list of the sample encyclopedias is displayed, you can select one from the list to open it.
7. Click Cancel to dismiss the Open Encyclopedia dialog.8. Click Close to dismiss the Tip of the Day dialog.
Configure subsequent workstationsYou can install and configure Rational System Architect on additional workstations byrepeating the process described in this article.
Create a new encyclopediaThe next step is to create a new Encyclopedia.
1. From the Rational System Architect main page click File > Open Encyclopedia.2. In the Open Encyclopedia window, click New to create a new Rational System Architect
encyclopedia.3. Browse to select Local Connection to connect to the SQL instance.4. Enter a name for the new encyclopedia (for example, Test).5. Click OK.
Figure 19. Create a New Rational System Architect Encyclopedia
6. When the Property Configuration dialog opens, click OK to accept the default selections.
The newly created encyclopedia opens, and the installation and configuration of Rational SystemArchitect is now finished.
6. Install and configure a license server for floating licensesIf you are using floating licenses, a FlexNet License Server is required and must be networkaccessible by all Rational System Architect workstations. Rational System Architect workstationsuses a floating license by connecting to the license server using the port@license-serverhostnameformat.
To set up the FlexNet License Server:
1. Locate a server or workstation to host the FlexNet License Server.2. Run the IBM Rational License Server TL installation program.3. From the Welcome screen, click Next and accept the License Agreement.
developerWorks® ibm.com/developerWorks/
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 16 of 21
4. Click Next. In the destination location screen, retain the default path for installation of thelicense server. Click Next.
5. Enter the path to the license file. For this example:C:\Documents and Settings\All Users\Application Data\IBM\System Architect\License
File
6. Enter the path for the license log. For this example:C:\Documents and Settings\All Users\Application Data\IBM\System Architect\Log File
7. Click Next to complete the installation.8. Check the box for Register the License Manager as a Service (Figure 20).9. Click Finish.
Figure 20. Register the License Manager as a Service
7. Basic troubleshootingInstructions follow for how to handle the following problems or tasks:
SQL Server login failureUse either the domain\username or username@fully_qualified_domain format to log in.
SQL Server does not exist or access deniedFigure 21. Error Message: SQL Server does not exist
ibm.com/developerWorks/ developerWorks®
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 17 of 21
1. Ensure that SQL Express is installed properly.2. Ensure that the SQL Server protocols are enabled and that SQL services are running.
SQL Server Services will not start1. Disable anti-virus software.2. Restart the SQL services.
SQL Server Express failed to install on Windows XPThe Startup Wizard displays an error during the installation and configuration of SQL ServerExpress on Windows XP. This error is related to a conflict with the MSXML 6 Parser.
The work around is to use the Windows Installer CleanUp utility to remove references to MSXML6. To do this, follow these steps:
1. Download the Windows Installer Cleanup utility from Microsoft Support. .2. Run the utility.3. Select MSXML 6 from the list, and then click Remove.4. Reboot the workstation.5. Start Rational System Architect and re-run the Rational System Architect Startup Wizard.
Windows Installer Cleanup Utility Failed to Install1. Download and install the Microsoft® Visual Basic Script (VBScript).2. Reboot the workstation.3. Re-run the Windows Installer Cleanup Utility.
NT AUTHORITY\NETWORK SERVICE (Network Service) issuesFollow the instructions in Step 3, Create a shared folder to store encyclopedia backups, to resolvethe issue.
Locate the license file or the license serverThe environment variables TELELOGIC_LICENSE_FILE points to either one of these:
• The license server in the form of port_number@license_server if you are using a floatinglicense.
• The license.dat file path if you are using node-locked licenses.
Type Set in an MS-DOS command prompt to verify the value of the TELELOGIC_LICENSE_FILEvariable. The Set command lists all currently set variables, including theTELELOGIC_LICENSE_FILE variable.
Merge license filesEach Rational System Architect feature requires a license. All licenses for the various featuresmust reside in a single license.dat file. If you received a license file from IBM to unlock anadditional feature, you must merge the content of the new license file with the existing one.
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 18 of 21
To merge two license files, follow these steps:
1. Back up the existinglicense.dat file.2. Back up the new license.dat file.3. Open the existinglicense.dat file with Notepad.4. Scroll to the end of the file.5. Put a couple of spaces between the #END_OF_LICENSE_KEY statement and the statement
before it (Figure 22).
Figure 22. Edit the existing license.dat file
6. Use Notepad to open the newlicense.dat file.7. Select and copy the new Feature lines (Figure 23).
Figure 23. Copy the Feature section from the new license file
8. Paste the selection into the existing file, just before the #END_OF_LICENSE_KEY statement(Figure 24).
ibm.com/developerWorks/ developerWorks®
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 19 of 21
Figure 24. Paste the new Features section into the existing license file
9. Save the file.10. Stop the license server.11. Reload the license.dat file.12. Start the license server.
developerWorks® ibm.com/developerWorks/
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 20 of 21
Resources
Learn
• Learn more about Rational System Architect:• developerWorks page for Rational System Architect• Watch the demonstration online.• Check the Rational System Architect Information Center for documentation for all
versions• Find technical details in the IBM Rational Document Download Information Center and
IBM Rational Documentation areas, including these:• Rational System Architect Release Notes• Rational System Architect and System Architect XT Installation Guide
• Demo• Discussion forum
• Visit the Rational software area on developerWorks for technical resources and bestpractices for Rational Software Delivery Platform products.
• Explore Rational computer-based, Web-based, and instructor-led online courses. Hone yourskills and learn more about Rational tools with these courses, which range from introductoryto advanced. The courses on this catalog are available for purchase through computer-basedtraining or Web-based training. Additionally, some "Getting Started" courses are availablefree of charge.
• Subscribe to the IBM developerWorks newsletter, a weekly update on the best ofdeveloperworks tutorials, articles, downloads, community activities, webcasts and events.
Get products and technologies
• Download a free, fully enabled trial version of Rational System Architect..• Download trial versions of other IBM Rational software.• Download these IBM product evaluation versions and get your hands on application
development tools and middleware products from IBM® DB2®, IBM® Lotus®, IBM® Tivoli®,and IBM® WebSphere®.
Discuss
• Participate in the Enterprise Architecture and Business Architecture forum, which isdedicated to the collaboration of the Enterprise Architecture community, where you can shareinformation about methods, frameworks, and tool implementations. Discussions include tool-specific technical exchanges about Rational System Architect.
• Join the Development Tools forum to ask questions and share your experiences withcolleagues.
• Check out other developerWorks blogs and get involved in the developerWorks community.
Install and configure IBM Rational System Architect Version 11.3:Part 1. Stand-alone installation with Microsoft SQL Express
Page 21 of 21
About the author
Sami Joueidi
Sami Joueidi holds a master's degree in electrical engineering. He is certified byIBM as an IT Architect and by Carnegie Mellon as an Enterprise Architect. His focusincludes application lifecycle development in both IT and systems areas.
