Oracle BIEE多用户开发环境的搭建.docx

Oracle BIEE
多用户开发环境的搭建

文档作者: 周 飞
创建日期: April 16, 2009
最近更新: 四月 4, 2021
文档编号: 周 飞/MD020
文档版本: 1.0

拷贝数量_____

文档控制

更改记录

日期
作者
版本
更改参考

16-Apr-09
周 飞
1.0
无前版本

目录
文档控制 2
1、 设置多用户开发环境(Administrator) 4
a) 创建多用户开发环境使用的项目 4
b) 设置Shared Network Directory 6
c) 将主存储库拷贝到Shared Network Directory 7
2、 对多用户开发环境做出修改(Developers) 8
a) 设置Admin Tools指向网络上的多用户开发目录 8
b) check out存储库项目 8
c) 关于修改和测试元数据 11
3、 Check in多用户开发存储库项目 13
4、 未结与已结问题 16
未结问题 16
已结问题 16

1、 设置多用户开发环境(Administrator)

搭建多用户开发环境需要管理员进行如下的操作任务：
创建多用户开发环境使用的项目；
设置Shared Network Directory；
将主存储库拷贝到Shared Network Directory。

a) 创建多用户开发环境使用的项目
一个项目包含了元数据的一个子集。项目中，可以包含展现层的的内容以及相对应的业务模型中的逻辑事实表，维度，分组，用户，变量，初始化块等。Oracle BI的管理员在存储库中创建项目，然后将存储库拷贝到Shared Network Directory中。在创建项目时，Oracle BI管理员选择展现层的内容或者是与展现层相关的逻辑事实表的子集，Administration Tool会将业务模型和逻辑层中的相关对象自动添加到项目中。一个对象可以存在于多个项目中。
创建项目的步骤如下：
1、以Offline方式打开需要向多个开发员提供的存储库文件：

2、在Administration Tool目录菜单中，选择Manage à Projects:

3、在打开的Project Manager对话框中，在右边面板空白处，右击鼠标键，选择”New Project”

在Name中输入项目名称，这里我预计将这个项目分配给usa用户，负责销售额的事实表。在Group Facts By选项中选择Business Model，将Sales Facts双击选入右边的栏中。此时看到与其相关的Presentation Catalogs中的内容被自动添加到了项目中。另外，我们还将usa用户以及所有的变量和初始化块都加入到项目中：

OK，保存。
同样的步骤，我们创建项目cn pro给用户cn，负责成本事实表：

OK，保存。

b) 设置Shared Network Directory
定义了项目和设置了Shared Network Directory之后，Oracle BI Administrator需要制定或创建一个所有开发人员可以访问的Shared Network Directory，然后将最新的存储库文件上传到这个目录。这个Shared Network Directory只能用于多用户开发。
在Tools中选择Options，进入MultiUser 选项页：

指定Shared Network Directory，这里我在默认的Repository目录下新建了一个share目录用于作为Shared Network Directory。
c) 将主存储库拷贝到Shared Network Directory
将默认的Repository目录下的SH0.rpd文件(我的主存储库文件是SH0.rpd)拷贝到Shared Network Directory下。

2、 对多用户开发环境做出修改(Developers)
在check out出项目前，开发人员需要在Admin Tools中设置由Admin创建的包含了住存储库的Shared Network Directory。在check out和check in中，主存储库的一个拷贝将会被临时拷贝到开发人员的本地存储库目录中(默认是\Oracle BI\Repository)。在check out项目并对本地存储库文件作出修改后，开发人员又可以check in(merge)这些修改到主存储库中去，或者放弃修改。

对多用户开发环境做出修改需要进行如下操作：
a) 设置Admin Tools指向网络上的多用户开发目录
Admin Tools会将这个路径保存到Windows注册表中的一个隐藏设置中，并且在check out和check in对象的时候使用它。
在Admin Tools中选择Tools菜单栏，选择Options选项，在Multiuser选项卡中指定Shared Network Directory：

(我在虚拟机中安装了客户端来访问宿主机)
b) check out存储库项目
在设置了多用户开发的目录后，开发人员就可以check out项目，修改元数据，测试元数据了。
从Admin Tool的目录中，选择File -> Multiuser -> Checkout
（这个选项只在设置了Shared Network Directory之后才可用）

多用户开发checkout对话框打开，选择存储库打开（如果在多用户开发目录中只有一个存储库文件，则存储库选择对话框将不会显示）
提示输入用户名和密码(如果存储库中没有项目，会显示一条消息，存储库也不会打开)

在浏览对话框中，选择需要checkout的项目(如果只有一个项目，项目选择对话框也不会打开)：

OK之后，选择将包含项目的存储库保存到什么位置以及命名：

默认就保存到\Oracle BI\Repository下，命名为usa pro.rpd。
Admin Tool会自动打开check out并保存的存储库文件，如下：

可以发现，关于成本的事实表New Costs并不在其中，因为我们把它分配给了用户cn，而且，虽然我们只为usa用户选择了Sales Facts事实表，但是与它关联的所有的维表也自动被check out了。
除了check out出的usa pro.rpd文件以外，还有另外一个文件，originalusa pro.rpd也被保存在了相同的目录下，这2份文件是完全一致的。这是你check out出的文件的原始版本，你的修改将会在usa pro.rpd文件中生效，所以，不要修改originalusa pro.rpd文件，这个文件可以用于比较你对usa pro.rpd文件所做的修改。

下面，使用同样的方法，我在宿主机上用cn用户登录，并check out出关于成本的项目。

c) 关于修改和测试元数据
能在标准存储库文件上进行的大部分操作都可以在本地存储库文件上进行。开发人员可以添加新的逻辑列、逻辑表、修改表的定义、逻辑表源等等。开发人员也可以同时在同一个项目上进行操作。值得注意的是，Oracle BI会假设开发人员都明白他们所做的修改将会对主存储库文件产生怎样的影响，比如，如果一个开发人员在本地存储库文件上删除了一个对象，这个更改将会传播到主存储库中，而不会带有任何提示。
如下这些修改是不能在本地存储库中进行的：
层级定义。如果2个开发人员同时进行修改，这个修改将不能被正确的合并；
项目定义。这只能由管理员在主存储库中进行；
物理连接设置。
在对本地存储库文件进行修改之后，开发人员可以修改本地的NOSConfig.INI文件，来测试元数据。
在修改并测试本地存储库文件后，开发人员可以从File -> Multiuser目录中选择进行一下操作：
同原始版本进行比较：前面提到过以original开头的check out出的本地存储库的副本；
放弃本地修改：在check out出之后和check in之前，都可以放弃对本地存储库所做的任何修改；
合并本地修改：锁定主存储库，以check in本地的修改；
发布到网络：成功合并修改后，主存储库就会在本地打开，此时“Publish to the network”选项才可用。当选择这个选项后，锁定被解除，存储库会被发布到在线模式，存储文件也关闭了。

此例中，我们在宿主机和虚拟机中分别进行一下修改：
虚拟机中，使用usa用户登录，删除业务模型和映射层中的% of Quota度量，删除Presentation层的Customers下的Country_ID。删除Presentation层的Channels下的Channel ID；
宿主机中，使用cn用户登录，修改Presentation层的Channels下的Channel ID为Channel Num。添加度量Cost/Price；取消Times和New Costs的外连接。
3、 Check in多用户开发存储库项目
当check-in开始后，Admin Tool会先检查住存储库是否被锁定，如果没有，它就锁定主存储库以防其他开发人员也进行合并操作，直到合并完成；与此同时，其他开发员File -> Multiuser下的合并选项也不可用，直到本次合并完成；Admin Tool会自动拷贝Shared Network Directory中的当前版本到开发员本机的\\Oracle BI\Repository目录中，这是由于在开发员check out之后，存储库也许已经被其他开发员改变了。
合并多用户开发元数据涉及到一下几个文件：
本地存储库的原始副本，即以original开头的文件；修改后的本地存储库；Shared Netwok Directory中的主存储库。

在前一节中，我们已经对两个项目所在的存储库文件(usa pro.rpd、cn pro.rpd)分别进行了修改，我们先在虚拟机中去usa pro.rpd进行check in。
按下图进行选择，选择“Merge Local Changes”：

中间会弹出一个对话框，选择Merge按钮就行了，Shared Network Directory中的主存储库就会自动打开，如下图：

观察上图会发现Customers下的Country ID已经没有了，Sales Facts下的% of Quota也被删除了(Channels由于图像大小原因没有截图)。
然后，保存存储文件。此时，如果直接选择关闭存储文件或者退出的话，会弹出如下对话框，提示尚未将存储文件发布到网络中(SH0.rpd文件的修改仍然保存在本地，没有进入Shared Network Directory)，我们选择Publish repository就可以了，随后存储文件会自动关闭。并且本地Repository目录下的项目相关rpd文件会自动删除，只留下一个log文件记录了合并过程。

在合并完之后，我们也可以直接在File -> Multiuser 中选择Publish repository来进行发布。

同样的方法，我们在宿主机中对cn用户的文件进行合并，在合并对话框中，会出现下面的提示：

这是由于在usa用户的开发过程中，Channel ID已经被删除了，但是cn用户的开发过程中是对它进行了修改(修改为了Channel Num)，所以这里的提示是希望用户来处理冲突。这里的关键就是Decision选项。此例中没有去细究几个选项的意义，只是凭着感觉做了如图的选择，我的目的是希望保存cn用户的修改而不是删除 Channel ID。选择“Merge”，合并过程完成后，进行下图的查看，发现Channel ID变为了 Channel Num，Cost/Price度量如期出现了，Times表和New Costs表的外连接也删除了。

在默认的Repository目录下留下了一些log文件和csv文件，记录了合并的情况，可以进行查看。

4、 未结与已结问题

未结问题
序号
问题
解决方案
负责人
目标日期
实际日期

已结问题

序号
问题
解决方案
负责人
目标日期
实际日期