Setting up the product library in an ArcSDE environment
Two different procedures are used to create and set up an ArcSDE geodatabase for the product library. One is used for setting up the product library on an ArcSDE geodatabase for Microsoft SQL Server Express licensed for ArcGIS Desktop (instance of SQL Server Express). The other is used for setting up the product library on an ArcSDE geodatabase licensed for ArcGIS Server Enterprise. The steps in this workflow are for setting up the product library on an ArcSDE geodatabase for Microsoft SQL Server Express licensed for ArcGIS Desktop, but additional information and links are provided for setting up the product library on an ArcSDE geodatabase licensed for ArcGIS Server Enterprise.
Adding a database server
This section describes how to add a database server connection under the Database Servers node in the Catalog window. This is a connection to a Microsoft SQL Server Express instance set up to store geodatabases. You can skip this section if you are using Oracle, SQL Server Enterprise, or another ArcSDE geodatabase licensed for ArcGIS Server Enterprise to store the geodatabase you are using as the product library.
You will need to install SQL Server Express, if you have not already, and enable it to store geodatabases.
- Start ArcMap, open the Catalog window, then expand the Database Servers node in the Catalog tree.
- [データベース サーバを追加] をダブルクリックします。
-
In the Add Database Server dialog box, provide the name of the ArcSDE database server. This is in the form <server_name>\<instance_name>, where the server name is the name of the server on which SQL Server Express is installed and the instance name is the name of the SQL Server Express instance.
For example, if a database server is named SOPHIE\SQLEXPRESS, SOPHIE is the server name, and SQLEXPRESS is the instance name. Using 127.0.01 for the server name will avoid sourcing issues if multiple users are going to be accessing the product library.
- Click OK.
カタログ ツリーの [Database Servers] フォルダの下に、サーバ アイコンが表示されます。
Creating the administrator database connection
If the product library is stored in an ArcSDE geodatabase licensed for ArcGIS Server Enterprise, you need to create an administrator database connection. If your product library is stored in SQL Server Express, you can skip this section, since you only need to add a database server connection (first section of this workflow).
If you want to create a database connection for SQL Server, go to Making a direct connection from ArcGIS Desktop to a geodatabase in SQL Server. If you want to create a database connection for Oracle, go to Making a direct connection from ArcGIS Desktop to a geodatabase in Oracle.
Creating an ArcSDE geodatabase
The server administrator needs to create a new geodatabase from Oracle, SQL Server, SQL Server Express or another enterprise database management system (DBMS) that can be used as the product library. The steps in this section are for creating an ArcSDE geodatabase for Microsoft SQL Server Express licensed for ArcGIS Desktop (SQL Server Express geodatabase). If you want to create a geodatabase from Oracle, SQL Server, or another ArcSDE geodatabase licensed for ArcGIS Server Enterprise, see the following topics for information:
- A quick tour of setting up a geodatabase in DB2
- A quick tour of setting up a geodatabase in Informix
- A quick tour of setting up a geodatabase in Oracle
- A quick tour of setting up a geodatabase in PostgreSQL
- A quick tour of setting up a geodatabase in SQL Server
Recommendations for Oracle databases
It is recommended that you ensure that the following parameter values are used when creating an Oracle database:
Parameter name |
Value |
---|---|
Configure with Database Enterprise Manager |
Enabled |
Shared memory management |
AUTOMATIC |
Character Sets |
Unicode (AL32UTF8) |
OPEN_CURSORS |
2000–10000 |
SESSION_CACHED_CURSORS |
50–150 |
pre_page_sge |
True |
The steps below are for creating an ArcSDE geodatabase for Microsoft SQL Server Express licensed for ArcGIS Desktop (an instance of SQL Server Express).
- Log in as a server administrator, start ArcMap, then open the Catalog window.
- カタログ ツリーで、新しいジオデータベースの作成先となるデータベース サーバを右クリックします。
- [新規ジオデータベース] をクリックします。
-
[ジオデータベース名] テキスト ボックスに新しいジオデータベースの名前を入力します。
名前の先頭文字は必ず英字にしてください。スペースまたは特殊文字(#、@、* など)を含めることはできません。この名前はサーバ名と合わせて 31 文字以内に収める必要があります。
- データベース ファイルの場所を変更する場合は、省略符号ボタン([...])をクリックして場所を参照し、[ジオデータベース ファイル] テキスト ボックスに新しい場所を指定します。
- [初期サイズ] テキスト ボックスに、新しいジオデータベースのサイズを入力します。
-
[単位] ドロップダウン メニューから [MB] または [GB] を選択するか、デフォルト サイズの 100MB を使用します。
初期サイズにかかわらず、ジオデータベースのサイズは必要に応じて 4GB まで拡張されます。
メモ:ジオデータベースの初期サイズは、SQL Server Express Edition インスタンスの model データベースよりも小さいサイズに設定することはできません。model データベースは、すべての新規データベースのシステム テンプレートです。model データベースのサイズにより、SQL Server Express Edition インスタンスで作成されるすべてのデータベースの最小サイズが決定されます。この最小サイズよりも小さいジオデータベースを作成しようとすると、データベースの作成は失敗し、次のエラー メッセージが返されます。
Error creating this geodatabase CREATE DATABASE failed. Primary file must be at least <size of model> to accommodate a copy of the model database.
- Click OK.
データベース ファイルとジオデータベース スキーマが作成されている間、プログレス バーが表示されます。完成した新しいジオデータベースは、カタログ ツリーの [コンテンツ] タブに表示されます。
Creating geodatabase users
You can choose to add users to a geodatabase stored in SQL Server through Microsoft SQL Server Management Studio Express.
Learn how to add users for an Oracle database
Learn how to add Windows-authenticated users or groups to a SQL Server database
Learn how to add database-authenticated users to a SQL Server database
The steps below are for creating users for the product library geodatabase in ArcCatalog on a database server (an instance of SQL Server Express) and SQL Server.
- Log in as a server administrator, start ArcMap, then open the Catalog window.
- ユーザまたはグループを追加するデータベース サーバを右クリックします。
- [権限] をクリックします。
- [権限] ダイアログ ボックスで [ユーザを追加] をクリックします。
-
ユーザまたはグループを検索する場所を指定します。
これにはローカル コンピュータまたはドメインを指定することができます。
- 追加するユーザまたはグループの名前を入力します。[詳細設定] ボタンをクリックすると、適切なユーザを検索するための情報をより詳細に指定することができます。
- [名前の確認] をクリックし、ログイン名が有効であることを確認します。
- Click OK.
Granting geodatabase roles/permissions
A role needs to be assigned to the users that are going to be working with the product library so they can view or add components, information, and data to the product library. These permissions are at the geodatabase level, assigned separately from the product library permissions. The roles are assigned through ArcCatalog as permissions for users that are using a product library stored in SQL Server Express or SQL Server. For Oracle and any other ArcSDE geodatabase licensed for ArcGIS Server Enterprise, the role CKB_USERS must be created for the users to be recognized by the product library. This can be done by using the following statement:
CREATE ROLE CKB_USERS NOT IDENTIFIED
User names for the role are required for any users who are going to be working with the product library and need to read from or write to the product library tables and other components. The administrators are considered the owners of the data, so they already have this privilege.
Below are suggested user names and the permissions required for each level for Oracle (and SQL Server if using Microsoft SQL Server Management Studio Express).
For product library administrators, the following is suggested:
User type |
Role |
Oracle permissions |
SQL Server permissions |
---|---|---|---|
Data owner |
CONNECT |
|
|
For product library editors, the following is suggested:
User type |
Role |
Oracle permissions |
SQL Server permissions |
---|---|---|---|
Data editor/Data viewer |
|
CREATE SESSION |
CREATE TABLE |
The steps below are for granting roles/permissions on a database server (an instance of SQL Server Express), and SQL Server.
- ユーザ権限を割り当てるジオデータベースを右クリックします。
- [管理] をクリックし、その後 [権限] をクリックします。
- [権限] ダイアログ ボックスで、リストから対象のユーザまたはグループを選択します。
-
Click the appropriate role:
- なし - ユーザにはジオデータベースまたはジオデータベースのデータセットへの特定のアクセス権がありません。
- 読み取り専用 - ユーザはデータの表示および選択のみを許可されます。
- 読み取り/書き込み - ユーザはジオデータベース内の新規データセットの読み取り/書き込み、新規データセットの作成、既存のデータセットの読み取り/書き込みを許可されます。
- 管理 - ユーザは特定のジオデータベースでの管理タスクの実行を許可されます。
- サーバ管理者 - このユーザがデータベース サーバを管理します。
- Click Apply.
Configuring the database in ArcSDE
You need to configure the MAXBLOBSIZE and TCPKEEPALIVE parameters for the ArcSDE geodatabase used as the product library. The product library can be set up in a central or local geodatabase. A central geodatabase is usually an ArcSDE geodatabase with Oracle, SQL Server, SQL Server Express, or another enterprise DBMS installed. A local geodatabase is usually an ArcSDE geodatabase with SQL Server Express installed locally to house and manage the product library.
The DBMS used for the geodatabase should be configured before the product library is set up with the default geometry storage. See geodatabase storage in relational databases or geodatabase parameters for more information.
The MAXBLOBSIZE value is -1 by default. However, if you are using Oracle or another enterprise DBMS, make sure that this value is set to -1 and the TCPKEEPALIVE value is set to 1. This command should be used from the command prompt of a machine where ArcSDE is installed.
For example:
sdeconfig -o alter -v MAXBLOBSIZE=-1-i <service> -u sde -p <sde_password>
For more information, see the ArcSDE Administration Command Reference.
You can download a Portable Document Format (PDF) version of the book from the ESRI Support Center Web site (login required): ArcSDE Server documentation
The ArcSDE documentation refers to the parameter name as Property Name in the command line examples.
Use the steps below if you are using SQL Server Express or SQL Server to configure the MAXBLOBSIZE and TCPKEEPALIVE parameters.
- Open SQL Server Management Studio Express.
- Click Connect on the Connect to Server dialog box that appears.
- Expand Databases, the geodatabase you are using for the product library, and Tables.
- Right-click on the SDE_server_config table and click Edit Top 200 rows.
- Find MAXBLOBSIZE in the prop_name field and change it to -1 in the num_prop_value field if it is another value.
-
Find TCPKEEPALIVE in the prop_name field and change it from 0 to 1 in the num_prop_value field.
注意:
If you are using a local geodatabase and you modify the parameters while the Catalog window is open, you need to refresh (or disconnect and reconnect to) your SQL Server Express instance to confirm that the geodatabase has the new settings. You can right-click the database server and click Refresh.
- Close SQL Server Management Studio Express.
Defining and upgrading the geodatabase as a product library
After the geodatabase has been created, various tables and feature classes that are part of the product library need to be added to it. This process can be completed in ArcMap.
The steps in this section are for defining and upgrading the geodatabase as a product library in ArcMap.
- Start ArcMap.ヒント:
If the ArcMap - Getting Started dialog box appears, you can open a new or existing map document. You can also check the Do not show this dialog box in the future check box and click Open.
- On the main menu, click Customize → Production → Production Properties.
The Production Properties dialog box appears.
-
If necessary, click Data Management.
-
Click the cell next to Workspace in the Product Library section and click the ellipsis (...) that appears.
The Please browse to the location of the Product Library Workspace dialog box appears.
- Navigate to the product library database.
-
Click Open.
The Upgrade Workspace dialog box appears.
-
Click Yes to upgrade the geodatabase you want to use as the product library.
The Product Library Workspace Upgrade window appears and displays a progress bar while the geodatabase is updated. The Production Properties dialog box appears once the process is complete.
- Click OK.
Granting privileges to product library components
All the tables in the product library need to have read/write privileges assigned to them, except the PCAT_PERMISSION table. The PCAT_PERMISSION table only needs read privileges assigned to it.
The permissions need to be assigned to the CKB_USERS role.
Both the administrator and other user accounts in the underlying database management system should have appropriate privileges and roles assigned to them. When you set up your connection to your spatial database, ensure you are connecting as the appropriate user.
- Start ArcCatalog.
-
Expand one of the following:
- Database Servers if using a SQL Server Express geodatabase
- Database Connections if using an Oracle, SQL Server, or another enterprise geodatabase
- Double-click the product library administrator connection geodatabase to connect to it.
- Select all tables except PCAT_PERMISSION, right-click, then click Privileges.
- Type CKB_USERS into the text box on the Privileges dialog box.
- Check the check box next to SELECT, UPDATE, INSERT, and DELETE.
- Click OK.
- Select PCAT_PERMISSION, right-click, then click Privileges.
- Type CKB_USERS into the text box on the Privileges dialog box.
- Check the check box next to SELECT.
- Click OK.
Versioning within product library
You need to register product library components for versioning to allow them to be editable.
You need to register the product library feature classes and tables for versioning.
- Start ArcCatalog.
-
Expand one of the following:
- Database Servers if using a SQL Server Express geodatabase
- Database Connections if using an Oracle, SQL Server, or another enterprise geodatabase
- Double-click the product library administrator connection geodatabase to connect to it.
-
Right-click each feature class in your product library and choose Register as Versioned.
Do not check the Register the selected objects with the option to move edits to base check box.
- Click OK.
-
Right-click each table in your product library and choose Register as Versioned.
Do not check the Register the selected objects with the option to move edits to base check box.
- Click OK.
Creating database connections for product library users
Database connections need to be created for the other product library users if the product library is stored in Oracle, SQL Server, or another ArcSDE geodatabase licensed through ArcGIS Server Enterprise. If your product library is stored in SQL Server Express, you can skip this section, since other users will only need to add a database server connection (first section of this workflow).
If you want to create a database connection for SQL Server, go to Making a direct connection from ArcGIS Desktop to a geodatabase in SQL Server. If you want to create a database connection for Oracle, go to Making a direct connection from ArcGIS Desktop to a geodatabase in Oracle.
For step 6, if using database authentication, type the user name of the product library user for which you want to create a database connection.
Once you have performed all the steps in this workflow, the product library workspace is ready for you to create the solution, product class, series, and users and user permissions. Other users still need to define the product library workspace in their client machine to be able to create and manage data and/or products.