SharePoint Technical Notes: SharePoint 2010

SQL Server インスタンスのエイリアス利用

オンプレミスでSharePoint サーバーを構築する際、SQL Server は必須です。SharePoint サーバーセットアップ時に SQL Server のインスタンス名を指定しますが、インスタンス名にはホスト名エイリアスが使えます。ようするに別名を付けてアクセスするということです。実際のサーバーインスタンス名を隠蔽できるため、SharePoint 側の設定を変更することなく、SQL Server 側のアップグレードやサーバー統合、ディザスタリカバリー対策などがしやすくなります。

ホスト名エイリアスの追加手順は次の記事に公開されていますが英語の資料であるため、ここから手順のみを抜粋して記載しておきます。

[参考]MSDN blog : How to Add a Hostname Alias for a SQL Server Instance

手順の概要は次の通りです。

DNSサーバーに目的のサーバーのAレコードを登録する
1で作成したAレコードの IP アドレスのポート 1433 をSQL Server がリッスンするように構成する

ここからはホスト名エイリアスを SP-SQL とし、SharePoint からはこのエイリアスでアクセスするようファームを構築する前提でもう少し細かく手順を確認していきます。

DNSサーバーにAレコードを登録する

DNSサーバーに SP-SQL という名前の Aレコードを登録します。既存の SQL サーバー(SP-SQL14) の IP アドレスは 192.168.11.81 だとすると、Aレコードは次の通りです。

1433ポートをリッスンするように SQL Server を構成する

SQL Server 構成マネージャーを起動し、[SQL Server ネットワークの構成] > [<目的のインスタンス>] > の順にクリックします。[TCP/IP] をダブルクリックします。

TCP/IP のプロパティウィンドウの [プロトコル]タブで [すべて受信待ち] を いいえ に変更し、特定のIPアドレスからのポート 1433 のみをリッスンするようにします。

[IPアドレス]タブでは、IPAll セクションで TCP 動的ポートが空白になっており、動的ポートが無効になっていることを確認します。TCPポートは 1433 を指定します。

続いて同じ[IPアドレス]タブで、リッスンするIPアドレスの構成を確認し、[有効] をはいに設定します。

以上の設定が終わったら SQL Server のインスタンスを再起動します。

SQL Server Management Studio でログを確認します。

以上で基本手順は完了です。

なお、冒頭でご紹介したMSDNのブログではSQL Server側を Kerberos 認証で構成する場合の手順や SQL Server 自体からローカルアクセスする際に必要なKB情報などが掲載されています。

Kerberos 認証を使う場合は SQL Server サービスアカウントの SPN (サービスプリンシパル名) を追加する
ローカルアクセスする場合、BackConnectionHostNames エントリーを追加して NTLM 認証を有効にする

ただ、ローカルアクセス云々は SharePoint ファームでは直接関係はないので、必要に応じて記事を確認するとよいでしょう。

以上、ホスト名エイリアスの登録が終わったら、SharePoint ファームを構成ウィザードで構築する際に(下図)、サーバーインスタンス名として利用できます。

これでSQLサーバーの実際のインスタンス名に依存しない SharePoint 環境の運用が可能になります。

[2014/10/28補足]

(これから構成する方は多くないと思いますが、) FAST Search for SharePoint 2010 を構成する場合は、SQL サーバーのエイリアス設定だとうまくいかないことがあるようですので、念のためご注意ください。

Use a custom SQL port in the scripted installation of Fast For SharePoint

カスタムタイマージョブ展開時の注意事項

カスタムタイマージョブ開発を行う場合の、SharePoint 2010 および 2013 共通の注意事項について記載しておきます。

カスタムタイマージョブの登録は、サイトコレクションなどのフィーチャーの Activated イベントなどを使って行いますが、当該フィーチャーを非アクティブ化した後で再びアクティブ化しようすとるとエラーが発生してアクティブ化できなくなることがあります。

ULSログを確認すると、次のような「アクセスが拒否されました」というエラー情報のエントリーが確認できます。

この事象については、マイクロソフト社の KB に情報が公開されていますので詳細は下記を確認してください。

「Access denied when deploying a timer Job or activating a feature from SharePoint 2010 content web application」

SharePoint 2010 から導入された新しいセキュリティ機能の影響で、Microsoft.SharePoint.Administration 名前空間内の SPPersistedObject から派生したオブジェクトへのあらゆる変更はブロックされ、コンテンツを保持するWebアプリケーション側から構成データベースを更新することは許可されないようになっています。この新しい機能は、SPWebServie.RemoteAdministratorAccessDenied プロパティで制御されています。

そのため、こうしたエラーが発生した場合は、必要に応じてWindows PowerShell　などを使って、このプロパティ値を false に変更し、IISReset を行います。

[SharePoint管理シェルの例]


#RemoteAdministratorAccessDenied プロパティを確認する
>$contentService=[Microsoft.SharePoint.Administration.SPWebService]::ContentService
>$contentService.RemoteAdministratorAccessDenied
#この機能をオフにする
>$contentService.RemoteAdministratorAccessDenied=$false
>$contentService.Update()
>IISRESET

SharePoint Web Services 証明書変更による不具合

SharePoint Server 2010 および SharePoint Server 2013 の Web フロントエンドの IIS サーバー上には SharePoint Web Services という名前のサイトが作成されています。

このサイトはサービスアプリケーションが使用します。HTTP (TCP 32843) および HTTPS (TCP 32844) を使用できるようになっていますが、HTTPS のバインドでは証明書が未選択になっています。

[バインド設定]

そこで手動で任意の証明書に変更すると、Secure Store Services が利用できないなど不具合が発生します。

たとえば Secure Store Services の管理ページにアクセスするとアクセス権限がないというメッセージが表示されてしまうようになります。

[Secure Store Services にアクセスしたところ]

イベントログにも下記のようなエラーが記録されます。

また、SharePoint Server 2013 の Access Services 2013 などにも影響がでてしまい、アプリケーションの利用、新規作成、削除などができなくなります。

対処方法

対処方法は netsh コマンドを使って、SharePoint 内部で使用している証明書に戻すことです。IIS管理マネージャーのGUIからは設定できません。

SharePoint サーバー上のローカルコンピュータの証明書管理コンソールを起動すると、[SharePoint]ノード内に 3つの証明書が既定で追加されていることがわかりますが、このうちの SharePoint Services の証明書を SharePoint Web Services サイトに設定しなおす必要があります。

まず、SharePoint Web Services サイトに割り当てた証明書を削除するため次のコマンドを実行します。ちなみに、証明書の直接削除は GUI からは行えません。

netsh http delete sslcert ipport=0.0.0.0:32844

続いて SharePoint Serviceの証明書を追加するのですが、拇印とアプリケーションIDの指定が必要です。拇印については、証明書管理コンソールから証明書のプロパティを表示すれば確認できます。

アプリケーションIDについては、SharePointでは基本共通となるため次のコマンドを実行し、取得します。


netsh http show sslcert

以上を踏まえ、SharePoint Services の証明書の追加は次のようなコマンドを実行することになります。


netsh http add sslcert ipport=0.0.0.0:32844 certhash="c4ac6c96e4f24e1822dfb474ef2dcb7378038bc5" appid="{4dc3e181-e14b-4a21-b022-59fc669b0914}" certstorename=SharePoint

コマンド実行後に SharePoint Web Services サイトのバインドを確認すると、証明書は再び未選択のままとなりますが実際には設定されています。この後は、Secure Store Services 管理ページなどは問題なくアクセスできるようになるはずです。

参考資料

[SharePoint 2010] Sandbox ソリューションのエラー対応

SharePoint 2010 でサンドボックスソリューションとして Web パーツ開発などする場合、いざWebパーツをページに追加しようとすると、次のようなメッセージが表示されてしまうことがあります。

「Sandboxed Code host Services がビジー状態で要求を処理できなかったので、セキュリティで保護されたコード実行要求が拒否されました」

この手のエラーが表示されることは意外と多くあります。対処方法が次のマイクロソフト社のサイトに記載されていますので、問題に遭遇したらこのURLを参考にするとよいです。

Error: "The sandboxed code execution request was refused because the Sandboxed Code Host Service was too busy to handle the request" (Ricky Kirkham)

ちなみに、私の環境でも同様のエラーが出ていたのですが、上記情報のうち "レジストリーを修正する" 手順で治りました。よく見ないと間違いがわからないので気を付けてください。レジストリの値が "0x00023c00" ではなく、"0x00023e00 " になっている必要があります。

簡単に手順を書くと次の通りです。

1. Windows サービスの管理コンソールを開き、SharePoint 2010 User Code Host サービスのログオンユーザーアカウントを確認する。

2.SharePoint 管理シェルを起動し、次のコマンドを実行して1のサービスで使用しているユーザーアカウントの SID を調べる。
> (Get-SPManagedAccount -Identity "ドメイン名\ユーザー名").Sid.Value

3.レジストリエディタを起動し次のレジストリキーを確認する。

>HKEY_USers\<2で取得したSID>\SOFTWARE\Microsoft\Windows\CurrentVersion\MinTrus\Trust Providers\SoftwarePublishing

4.State キーの値が "0x00023e00" となっていることを確認する。異なっている場合は修正する。

5. 全サーバーのSharePoint 2010 User Code Host サービスを再起動する。

この手のトラブルに見舞われず、開発作業に専念したいものです。

[TIPS] クライアントオブジェクトモデルをページロード時に呼び出す

SharePoint 上のページに JavaScript Object Model を使ったコードを実装する場合、ページロード時に関数を呼び出したいことがあります。

この場合は _spBodyOnLoadFunctionNames.push() メソッドを使うのが一般的です。通常のWebサイトであれば、Body要素の Load イベントを利用するところですが、SharePoint のコンテンツページ上からは Body 要素の Load イベントに直接追加できません。

そのために用意されているのが _spBodyOnLoadFunctionNames 配列であり、push メソッドに呼び出したい関数名を指定します。

しかし、クライアントオブジェクトモデルを使う場合にこれを用いてしまうと、呼び出しに必要な SP.JS ファイルがロードされる前に関数が呼び出されてしまうのでうまくいきません。

このようなケースでは ExecuteOrDelayUntilScriptLoaded 関数を利用すると便利です。

カテゴリ「SharePoint 2010」の86件の投稿