Microsoft Codename “Oslo” Repository Redistributable Community Technology Preview Readme

©2008 Microsoft Corporation. All rights reserved.
September 2008

Overview

The Microsoft “Oslo” Repository Redistributable package includes tools to create a Repository database and tools to import/export repository database content. The package also includes Oslo models in Mx format which can be imported into a repository database.

Content list:

· CreateRepository.exe: a tool for creating a Repository database.

· Models.Mx: a compiled image of Oslo models.

· M.exe: the M compiler.

· Mx.exe: A tool for importing model schemas into the Repository database.

For documents, samples, and other tools for Repository, please install the Microsoft “Oslo” Software Development Kit (SDK) package.

Installation Prerequisites

• Administrator privileges on the local computer
• One of the following operating systems:
• Windows XP Professional SP2
• Windows Server 2003 R2, SP2 Standard or Enterprise
• Windows Vista
• Windows Vista SP1
• Windows Server 2008 Standard or Enterprise
• .NET Framework 3.5

Installing Microsoft “Oslo” Repository Redistributable

1. Run Repository.msi from your download location. This launches the Microsoft “Oslo” Repository Installer.
2. In the Welcome to Microsoft “Oslo” Repository dialog box, click Next to start the installation.
3. Read the End-User License Agreement. Accept the agreement and click Next to continue.
4. In the Custom Setup dialog box
1. Choose the location where the Repository Redistributable will be installed.
2. If Repository Database can be installed in the default location choose Complete or Typical and Click Next to continue
5. In the Ready to install the Microsoft “Oslo” Repository page, keep the box checked if you want to create repository database on the default instance of the local machine. Otherwise, uncheck the box. You can always run CreateRepository.exe later to create a repository database.

Note: SQL Server 2008 RTM (Enterprise or Developer Edition)or SQL Server Express 2008 is required to create a repository database.

6. Click Install to start the installation process.
7. When setup is complete, click Finish.

Uninstalling Microsoft Repository Redistributable

1. In the taskbar, click Start, and then click Control Panel.
2. Click Uninstall a program in the Programs group. This opens the Uninstall or change a program dialog box.
3. In the Uninstall or change a program dialog box, select Microsoft “Oslo” Repository, and click Uninstall.
4. Follow the instructions to uninstall Microsoft Repository Redistributable.

Note: Uninstalling Repository Redistributable will not remove the repository database.

Troubleshooting Setup Failures

All setup errors are written to OsloRepositorySetup.log by default which is created in the %temp% folder. You can also create a more detailed setup log by running the repository setup using the following command line: “msiexec /i Repository.msi /l* OsloRepositorySetup.log”

Error Message: “Create repository database failed, please try later”

· If you see this message on the setup completion page, the setup failed to create a Repository database on your local machine.

· Open the OsloRepositorySetup.log for more details on the error.

· You can try to create the Repository database by running CreateRepository.exe. This tool by default is installed on your machine in the directory “%ProgramFiles%\Microsoft Oslo Repository\”.

Error Message: “Load Oslo model failed, please try later”

· If you see this message on the setup completion page, the setup failed to import the Oslo models into the repository database on your local machine.

· Open the OsloRepositorySetup.log for more details on the error.

· You can try to import the Oslo models into your repository database by running the following command line: “Mx.exe /i:Models.Mx /db:Repository”.

Known Issues

· Machine Administrator cannot logon to SQL Server after renaming the computer that had Repository installed.

o Following is the work around for this issue

• sqlcmd -d Repository -A -Q "drop login [<oldmachinename>\$(USERNAME)]"
• sqlcmd -s . -d Repository -A -Q "create login [$(COMPUTERNAME)\$(USERNAME)] from windows"
• sqlcmd -s . -d Repository -A -Q "EXEC sp_changedbowner [$(COMPUTERNAME)\$(USERNAME)]"
• sqlcmd –A –Q “sp_addsrvrolemember [$(COMPUTERNAME)\ $(USERNAME)], [sysadmin]"

Product Support/Provide Feedback

Placeholder for product support information.