Dataverse:Handle - Histórico de revisão

Renefgj: /* Documento 2 */

2021-08-19T11:11:00Z

Documento 2

Renefgj em 20h21min de 13 de maio de 2021

2021-05-13T20:21:35Z

Renefgj em 19h33min de 13 de maio de 2021

2021-05-13T19:33:14Z

Renefgj em 19h23min de 13 de maio de 2021

2021-05-13T19:23:48Z

Renefgj em 14h36min de 21 de setembro de 2020

2020-09-21T14:36:31Z

Renefgj em 15h36min de 6 de junho de 2020

2020-06-06T15:36:44Z

Renefgj em 15h32min de 6 de junho de 2020

2020-06-06T15:32:29Z

Renefgj: Criou página com '

Introdução

Identificadores persistentes são tanto requerimentos quanto uma parte integral da plataforma Dataverse.
Por padrão e por conveniências de teste,...'

2020-06-06T15:28:42Z

Criou página com '<h1>Introdução</h1> Identificadores persistentes são tanto requerimentos quanto uma parte integral da plataforma Dataverse. Por padrão e por conveniências de teste,...'

Página nova

<h1>Introdução</h1>
Identificadores persistentes são tanto requerimentos quanto uma parte integral da plataforma Dataverse. Por padrão e por conveniências de teste, o instalador configura um namespace de teste temporário no Doi através do EZID. Através deste é possível criar e publicar Dataverses e Datasets não sendo, entretanto, possível cita-los ou garantir sua preservação.
 Para configurar propriamente um identificador para uma instalação de produção, devem ser adquiridos uma conta e um namespace através de um dos seguintes provedores de DOI ou HDL mediante a cobrança de taxação: EZID (http://ezid.cdlib.org), DataCite (https://www.datacite.org), Handle.Net (https://www.handle.net). 
Uma vez tendo a conta cadastrada e um namespace DOI ou Handle funcionando, as seguintes opções da JVM e da database devem ser configuradas:
Para doi: 
JVM:
<ul>
<li>doi.baseurlstring</li>
<li>doi.username</li>
<li>doi.password</li>
</ul>
Database:
<ul>
<li>:DoiProvider</li>
<li>:Protocol</li>
<li>:Authority</li>
<li>:Shoulder</li>
<li>:IdentifierGenerationStyle (optional)</li>
<li>:DataFilePIDFormat (optional)</li>
</ul><hr>
 
Para Handle: 
JVM
<ul>
<li>dataverse.handlenet.admcredfile (chave privada de administração)</li>
<li>dataverse.handlenet.admprivphrase (senha utilizada na encriptação da chave)</li>
<li>dataverse.handlenet.index (index do handle, valor padrão é 300)</li>
</ul>
Database
<ul>
<li>:Protocol</li>
<li>:Authority</li>
<li>:IdentifierGenerationStyle (optional)</li>
<li>:DataFilePIDFormat (optional)</li>
</ul>
<h2>Configurando a Database </h2>
As opções da Database são configuradas através de requisições http através da linha de comando. 
Para listar as configurações atuais, execute:
curl localhost:8080/api/admin/settings
Para editar alguma configuração, execute:
curl -X PUT -d (novo valor) localhost:8080/api/admin/settings/:(configuração)
<hr>
Primeiro é necessario informar o Dataverse que será utilizado handle em vez do doi que vem por padrão. Para isso, edita-se o valor de :Protocol para hdl
curl -X PUT -d 'hdl' localhost:8080/api/admin/settings/:Protocol
Em seguida, é necessario informar o Dataverse o prefixo handle através da configuração :Authority
curl -X PUT -d '20.500.11959' localhost:8080/api/admin/settings/:Authority
Em seguida se faz necessario configurar o estilo de geração do identficardor, uma vez que o handle funciona com numeros e o dataverse vem configurado de modo a gerar uma string de caracteres aleatorios para o doi. 
Primeiro, deve-se mudar a opção :IdentifierGenerationStyle com o comando:
curl -X PUT -d 'sequentialNumber' localhost:8080/api/admin/settings/:IdentifierGenerationStyle
Após, baixe o arquivo createsequence.sql no link http://guides.dataverse.org/en/latest/_downloads/createsequence.sql e através do usuario postgres execute-o na tabela dvndb, para gerar o contador da sequencia na database
sudo -u postgres -i
wget http://guides.dataverse.org/en/latest/_downloads/createsequence.sql
psql dvndb
\i createsequence.sql
<h2>Configurando a JVM </h2>
Há dois modos de configurar as opções da JVM: via linha de comando através ou editando o arquivo domain.xml. A maior diferença entre um e outro é que editar o arquivo requer que o servidor seja reiniciado para que as alterações façam efeito. Por tanto, é preferivel configurar via linha de comando. Caso seja necessario, o arquivo domain.xml fica no seguinte caminho:
/usr/local/glassfish4/glassfish/domains/domain1/config/domain.xml
<hr>
Para acessar o aplicativo e configurar via linha de comando, é necessario estar no diretorio /bin do servidor.
cd /usr/local/glassfish4/glassfish/bin
Dentro do diretorio, é só executar o app asadmin passando os comandos como parametros. Para listas ar configurações atuais execute:
./asadmin list-jvm-options
'''''Caso o sistema peça por senha, ela se encontra no arquivo local-password dentro da pasta glassfish/domains/domain1/config'''''
Para alterar configurações ja definidas, se faz necessario deletar a versão atual e depois cria-la novamente atraves dos comandos delete-jvm-options e create-jvm-options. 
Como o dataverse vem configurado para doi, inicialmente não há a necessidade de substituir(deletar e criar novamente) sendo possivel, somente criar as configurações do handle
./asadmin create-jvm-options '-Ddataverse.handlenet.admcredfile=/hs/svr_1/admpriv.bin'
./asadmin create-jvm-options '-Ddataverse.handlenet.admprivphrase=SENHA DO ADMPRIV AQUI'
./asadmin create-jvm-options '-Ddataverse.handlenet.index=300'

<h2>Instalando o Handle.net em modo espelho</h2>
crie a pasta '''hs''' na raiz e dentro desta baixe e extraia o zip do handle.net através do link no site https://www.handle.net/download_hnr.html
mkdir hs
cd hs
wget https://www.handle.net/hnr-source/handle-9.0.3-distribution.tar.gz
tar -xvzf handle-9.0.3-distribution.tar.gz
 Em seguida, rode o script de instalação e siga os passos que serão descritos pelo script.
/hs/handle-9.0.3/bin/hdl-setup-server /hs/svr_1

 O dataverse só consegue decriptar o arquivo admpriv.bin caso ele esteja usando a encriptação da versão 6 do handle. Para resolver erros devido a isso, basta re-encriptar o arquivo usando o app hdl-keyutil localizado na pasta bin/ do handle.net

@@ Linha 104: / Linha 104: @@
   curl -X PUT -d "dt/" http://localhost:8080/api/admin/settings/:Shoulder
 == Documento 2 ==
 dspace.cfg

@@ Linha 1: / Linha 1: @@
-<h1>Introdução</h1>
+= Introdução =
 <p>Identificadores persistentes são tanto requerimentos quanto uma parte integral da plataforma Dataverse.<br>Por padrão e por conveniências de teste, o instalador configura um namespace de teste temporário no Doi através do EZID. Através deste é possível criar e publicar Dataverses e Datasets não sendo, entretanto, possível cita-los ou garantir sua preservação.</p>
 <p> Para configurar propriamente um identificador para uma instalação de produção, devem ser adquiridos uma conta e um namespace através de um dos seguintes provedores de DOI ou HDL mediante a cobrança de taxação:<br><b>EZID</b> (http://ezid.cdlib.org), <b>DataCite</b> (https://www.datacite.org), <b>Handle.Net</b> (https://www.handle.net).<br><br>
@@ Linha 34: / Linha 34: @@
 <li>:DataFilePIDFormat (optional)</li>
 </ul>
-<h2>Configurando a Database </h2>
+== Configurando a Database ==
 <p>As opções da Database são configuradas através de requisições http através da linha de comando.<br>
 Para listar as configurações atuais, execute:</p>
@@ Linha 53: / Linha 53: @@
   psql dvndb
   \i createsequence.sql
-<h2>Configurando a JVM </h2>
+== Alterando o prefixo do Handle no Dataverse ==
 <p>Há dois modos de configurar as opções da JVM: via linha de comando através ou editando o arquivo domain.xml. A maior diferença entre um e outro é que editar o arquivo requer que o servidor seja reiniciado para que as alterações façam efeito. Por tanto, é preferivel configurar via linha de comando. Caso seja necessario, o arquivo domain.xml fica no seguinte caminho:</p>
   [[$PAYARA]]/glassfish/domains/domain1/config/domain.xml

@@ Linha 67: / Linha 67: @@
   [[$PAYARA]]/bin/asadmin create-jvm-options '-Ddataverse.handlenet.admprivphrase=SENHA DO ADMPRIV AQUI'
   [[$PAYARA]]/bin/asadmin create-jvm-options '-Ddataverse.handlenet.index=300'
 <p> O dataverse só consegue decriptar o arquivo admpriv.bin caso ele esteja usando a encriptação da versão 6 do handle. Para resolver erros devido a isso, basta re-encriptar o arquivo usando o app hdl-keyutil localizado na pasta bin/ do handle.net

@@ Linha 55: / Linha 55: @@
 <h2>Configurando a JVM </h2>
 <p>Há dois modos de configurar as opções da JVM: via linha de comando através ou editando o arquivo domain.xml. A maior diferença entre um e outro é que editar o arquivo requer que o servidor seja reiniciado para que as alterações façam efeito. Por tanto, é preferivel configurar via linha de comando. Caso seja necessario, o arquivo domain.xml fica no seguinte caminho:</p>
-  /usr/local/glassfish4/glassfish/domains/domain1/config/domain.xml
+  [[$PAYARA]]/glassfish/domains/domain1/config/domain.xml
 <hr>
 <p>Para acessar o aplicativo e configurar via linha de comando, é necessario estar no diretorio /bin do servidor.</p>
   cd /usr/local/glassfish4/glassfish/bin
 <p>Dentro do diretorio, é só executar o app asadmin passando os comandos como parametros.<br>Para listas ar configurações atuais execute:</p>
-  ./asadmin list-jvm-options
+  [[$PAYARA]]/bin/asadmin list-jvm-options
 <p>'''''Caso o sistema peça por senha, ela se encontra no arquivo local-password dentro da pasta glassfish/domains/domain1/config'''''</p>
 <p>Para alterar configurações ja definidas, se faz necessario deletar a versão atual e depois cria-la novamente atraves dos comandos delete-jvm-options e create-jvm-options.<br>
 Como o dataverse vem configurado para doi, inicialmente não há a necessidade de substituir(deletar e criar novamente) sendo possivel, somente criar as configurações do handle</p>
-  ./asadmin create-jvm-options '-Ddataverse.handlenet.admcredfile=/hs/svr_1/admpriv.bin'
+  [[$PAYARA]]/bin/asadmin create-jvm-options '-Ddataverse.handlenet.admcredfile=/hs/svr_1/admpriv.bin'
-  ./asadmin create-jvm-options '-Ddataverse.handlenet.admprivphrase=SENHA DO ADMPRIV AQUI'
+  [[$PAYARA]]/bin/asadmin create-jvm-options '-Ddataverse.handlenet.admprivphrase=SENHA DO ADMPRIV AQUI'
-  ./asadmin create-jvm-options '-Ddataverse.handlenet.index=300'
+  [[$PAYARA]]/bin/asadmin create-jvm-options '-Ddataverse.handlenet.index=300'
 <h2>Instalando o Handle.net em modo espelho</h2>

← Edição anterior		Edição das 15h36min de 6 de junho de 2020
Linha 109:		Linha 109:
	Alterando o prefixo do HAndle		Alterando o prefixo do HAndle
	curl -X PUT -d "dt/" http://localhost:8080/api/admin/settings/:Shoulder		curl -X PUT -d "dt/" http://localhost:8080/api/admin/settings/:Shoulder
		+
		+	== Documento 2 ==
		+	dspace.cfg
		+
		+	local.cfg
		+	# Name of the site
		+	dspace.name = DSpace at RDP-CEDAP

@@ Linha 74: / Linha 74: @@
   wget https://www.handle.net/hnr-source/handle-9.0.3-distribution.tar.gz
   tar -xvzf handle-9.0.3-distribution.tar.gz
-<p> Em seguida, rode o script de instalação e siga os passos que serão descritos pelo script.
+Em seguida, rode o script de instalação e siga os passos que serão descritos pelo script.
   /hs/handle-9.0.3/bin/hdl-setup-server /hs/svr_1

← Edição anterior		Edição das 15h32min de 6 de junho de 2020
Linha 78:		Linha 78:

	<p> O dataverse só consegue decriptar o arquivo admpriv.bin caso ele esteja usando a encriptação da versão 6 do handle. Para resolver erros devido a isso, basta re-encriptar o arquivo usando o app hdl-keyutil localizado na pasta bin/ do handle.net		<p> O dataverse só consegue decriptar o arquivo admpriv.bin caso ele esteja usando a encriptação da versão 6 do handle. Para resolver erros devido a isso, basta re-encriptar o arquivo usando o app hdl-keyutil localizado na pasta bin/ do handle.net
		+
		+	--- Documentação 2 ---
		+	Verificar as configurações
		+
		+	curl localhost:8080/api/admin/settings
		+
		+	Ativando o Handle
		+	curl -X PUT -d 'hdl' localhost:8080/api/admin/settings/:Protocol
		+	curl -X PUT -d '20.500.11959' localhost:8080/api/admin/settings/:Authority
		+	curl -X PUT -d 'sequentialNumber' localhost:8080/api/admin/settings/:IdentifierGenerationStyle
		+
		+	Criando tabela no PGSQL
		+	sudo -u postgres -i
		+	wget http://guides.dataverse.org/en/latest/_downloads/createsequence.sql
		+	psql dvndb
		+	\i createsequence.sql
		+
		+	Configurando o Glassfish
		+	cd /usr/local/glassfish4/glassfish/bin
		+
		+	./asadmin create-jvm-options '-Ddataverse.handlenet.admcredfile=/hs/svr_1/admpriv.bin'
		+	./asadmin create-jvm-options '-Ddataverse.handlenet.admprivphrase=SENHA DO ADMPRIV AQUI'
		+	./asadmin create-jvm-options '-Ddataverse.handlenet.index=300'
		+
		+	Ver os paramentos setados
		+	./asadmin list-jvm-options
		+
		+	curl localhost:8080/api/admin/settings
		+
		+	Alterando o prefixo do HAndle
		+	curl -X PUT -d "dt/" http://localhost:8080/api/admin/settings/:Shoulder