Copyright © Cloud Software Group, Inc. All Rights Reserved

Managing Repository Instances

This section discusses the different repository management activities TIBCO Designer offers.

•	Creating Repository Instances

•	Specifying Additional Repository Information

•	Cloning Repository Instances

•	Deleting Repository Instances

•	Stopping a Repository Server

•	Starting or Stopping a Repository Instance

Exporting and importing repositories is discussed in Introduction. It usually involves making changes to the XML file that results from the export.

Creating Repository Instances

In most circumstances, you do not create repository instances using the Repository Finder, but instead create a project and save it to the project repository. See TIBCO Designer User’s Guide, available via Help > Designer Help for more information.

If for some reason you want to create a repository using Repository Finder, you must first decide whether you want to create a local or a remote repository instance.

•	Local repository files cannot be located by a repository server.

•	Remote repositories can be files or in a database. They must always be associated with a repository server.

Creating Local Repository Instances

To create a local repository instance using Repository Finder, follow these steps:

1.	If Local File Repositories is not currently displayed below Repository Finder in the project tree, find an already existing local repository instance.

TIBCO Designer displays a Local File Repositories icon in the project tree and below it any repository instances it found in the specified location.

2.	Right-click Local Repositories and choose Create Repository Instance.

Figure 116 Create Repository Instance

3.	Specify the instance name, display name, and file type as prompted.

TIBCO Designer creates a repository instance and displays it under Local File Repositories.

4.	If you like, you can specify additional information. See Specifying Additional Repository Information

You can also add a repository instance by − Selecting Local File Repositories. − Dragging an Instance icon from the palette panel to the design panel. − Specifying the instance information when prompted.

Creating a Repository Instance Managed by a Server

A repository instance managed by a server can be on any machine on the network, and can either be a file or inside a database.

To create a remote repository instance, follow these steps:

1.	Make sure the repository server for the instance is running.

2.	In the Repository Finder configuration panel, click Search Remotely, specify the search parameters for the server, and click Rediscover.

The server is displayed, even if this server currently has no instances.

3.	From the right-button menu of the server, choose Create Repository Instance.

4.	Provide the name, display name, and request subject prefix as prompted.

TIBCO Repository creates the repository instance in the remoteRepos directory associated with that server.

If you like, you can specify additional information. See Specifying Additional Repository Information.

You can also add a repository instance by − Selecting the appropriate repository server. − Dragging an Instance icon from the palette panel to the design panel. − Specifying the instance information when prompted.

 

Specifying Additional Repository Information

After you have created a local repository or a repository managed by a server, you can specify additional information for it as follows:

1.	Select the repository.

2.	In the configuration panel (with the General tab selected), specify the following information:

Table 92 Configuration Panel with General Tab Selcted

Display Name	Display name for this repository
Encoding	Specify the encoding you intend to use for this project’s encoding property. This property is used by client applications that access the project for any TIBCO Rendezvous communications. For example, if a TIBCO Adapter accesses the file, it will then use the value specified in this Encoding property for TIBCO Rendezvous communication with other applications. Note that this is not the encoding of the repository's persistent storage. Legal values are ISO8859-1 (for Latin-1 and ASCII 7-bit character sets) and UTF-8 (for other non-Latin-1 and Asian character sets).
Responsible Person	Person to contact.
Description	Description of this repository.
Support Info	Support information for this repository.
IsDefault	If checked, this is the default repository. Warning: There can be only one default repository within a repository network. That is then the repository to which the server connects when you search for repositories. The option should almost always be left unchecked.

 

The following information is included in the General tab but cannot be changed.

Table 93 Configuration Panel with General Tab Selcted

Version	Shows the version for this repository (cannot be changed). Default for TIBCO Designer 4.0.0 repositories is 4.0.0.
Instance Type	Either LocalFile for a local file repository or remoteRV for any repository managed by a server.
File Type	Either BIN or XML, as specified during repository creation.
Dir Name	(Local only) Directory in which this repository is stored.
Request Subject Prefix	TIBCO Rendezvous request subject prefix for this repository.

Cloning Repository Instances

You can clone a repository instance, that is, create a precise copy that is associated with the same repository server as the original. To clone a repository instance, follow these steps:

1.	In the project tree, right-click the repository instance you want to clone.

You can clone either a local or a remote repository.

Figure 117 Cloning Repository Instances

2.	Select Clone Repository Instance.

You are prompted for information about the new repository. For local file repositories:

	Instance Name	Name of the instance.
	Display Name	Display name.
	File Type	Either XML or BIN.
	Dir Name	Directory name for this repository.

 

3.	Supply the information and click OK.

TIBCO Designer creates an exact copy of the source repository. If you clone a remote repository, the copy is accessible through the same server.

Deleting Repository Instances

To delete a repository instance:

1.	Select the instance.

2.	From the right-button menu, choose Delete Repository Instance.

3.	You are prompted whether you really want to delete the instance.

Deletion is permanent. When deleting the instance, you are permanently removing it from the hard disk.

4.	Click Yes to remove the repository, No to keep it where it is.

Stopping a Repository Server

You can stop a repository server version 3.3 or later using TIBCO Designer as follows:

1.	Select the repository server you want to stop.

2.	From the right-button menu, click Stop Repository Server.

As an alternative, you can also click Stop Repository Server in the configuration panel’s General tab with the server selected.

After you stop a repository server, no one on your network can view or modify repository instances associated with that server.

Starting or Stopping a Repository Instance

When you stop a repository instance, it is no longer visible to the server that manages it. As a result, it is also no longer visible through TIBCO Designer.

When you start a repository instance, it then becomes visible again.

To stop a repository instance, follow these steps:

1.	Select the repository instance in the project tree.

2.	From the right-button menu, choose Stop Repository Instance.

3.	After a short time-out, the selected repository disappears from your display.

To start a repository instance, follow these steps:

1.	Select the Repository Server for the repository instance.

2.	From the right-button menu, choose Start Repository Instance.

3.	Type the name of the repository into the dialog.

You cannot start a repository that is already running.

4.	The repository is displayed below the selected server or below Local File Repositories.

Copyright © Cloud Software Group, Inc. All Rights Reserved