Belle II Registration and Account FAQ

(% style="color: rgb(0,0,0);" %)This page is meant to serve as a (% style="color: rgb(255,0,0);" %)supplement to the normal documentation(% style="color: rgb(0,0,0);" %) in case of misunderstandings or unclear descriptions. It (% style="color: rgb(0, 0, 0); color: rgb(255, 0, 0)" %)does not replace(% style="color: rgb(0,0,0);" %) the documentation which therefore should be considered first.

5

6

(% style="color: rgb(0,0,0);" %)Consider in particular:

7

8

* [[doc:BI.Belle II Newcomers.WebHome]]

9

* [[doc:BI.Belle II Newcomers.Belle II User Registration.WebHome]]

10

* [[doc:BI.Belle II Support Contacts.WebHome]]

11

* [[doc:BI.Belle II Collaborative Services and Tools.WebHome]]

12

* [[doc:BI.Belle II Membership Management System.WebHome]]

13

14

(% style="color: rgb(255,0,0);" %)**Use the 'ctl-f' to search for your problem!**

\\

----

== {{id name="BelleIIRegistrationandAccountFAQ-General"/}}General ==

33

34

35

If you want us to add another tip here, let us know via __[[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]//.//__

If you want us to add another tip here, let us know via __[[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]//.//__

----

== {{id name="BelleIIRegistrationandAccountFAQ-Basic(Credentials,account,password)"/}}Basic (Credentials, account, password) ==

53

54

55

The Belle II credentials are your account name and your password. The credentials are valid for **all** resources. Please denote [[doc:BI.DESY Requirements for Account Names and Passwords.WebHome]].

56

57

58

{{confluence_tip title="I lost the password of my KEKCC account."}}

59

The account of the KEK computing facility is **different** from the credentials for the Belle II collaborative services (B2CS). For your KEKCC account please contact (% style="color: rgb(0,51,102);" %)__[[takanori.hara_AT_kek.jp>>url:http://takanori.hara_AT_kek.jp||shape="rect"]]__(%%) . The B2CS is handled by __[[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]__ .__//

//__

{{confluence_tip title="Can I use my KEK account/passwords at DESY?"}}

64

No, the DESY and the KEK registry are completely independent. Please refer to [[doc:BI.Belle II Newcomers.Belle II User Registration.WebHome]] to request DESY credentials (account name / password). Your DESY credentials are good for all Belle II collaborative services including the membership management system.

65

66

67

{{confluence_tip title="Do I need a KEK account to get into the Belle II membership management system?"}}

68

No, you request Belle II membership via [[doc:BI.Belle II Newcomers.Belle II User Registration.WebHome]], which generates login credentials at DESY which are good for all Belle II collaborative services including the membership management system.

69

70

71

{{confluence_tip title="Do I need a KEK account to gain access to the Belle II collaborative services and tools?"}}

72

No, you request Belle II membership via [[doc:BI.Belle II Newcomers.Belle II User Registration.WebHome]], which generates login credentials at DESY which are good for all Belle II collaborative services including the membership management system.

73

74

75

{{confluence_tip title="Can I use my DESY account/password at KEK?"}}

76

No, the KEK and the DESY registry are completely independent. Please refer to [[doc:BI.Belle II Newcomers.WebHome]] to request a KEK account.

----

== {{id name="BelleIIRegistrationandAccountFAQ-Contacts"/}}Contacts ==

90

91

{{confluence_tip title="I need to contact the mailing lists manager / master?"}}

92

Please use exclusively use __[[listmaster_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]//.

//__

----

== {{id name="BelleIIRegistrationandAccountFAQ-BelleIIMembership"/}}Belle II Membership ==

107

108

{{confluence_tip title="I am new to Belle II. What do I have to do?"}}

109

Please refer to the page [[doc:BI.Belle II Newcomers.WebHome]]. You need to register.

110

111

112

{{confluence_tip title="How do I become a Belle II member and how do I get into the Belle II Membership Management System? "}}

113

If you have DESY credentials to access the Belle II collaborative services such as confluence, you were automatically included in the [[doc:BI.Belle II Membership Management System.WebHome]] (B2MMS). If not please refer to [[doc:BI.Belle II Newcomers.Belle II User Registration.WebHome]]. With your registration you will be included in the [[doc:BI.Belle II Membership Management System.WebHome]] (B2MMS).

114

115

116

{{confluence_tip title="Who is the representative of my institution (IR)?"}}

117

Please ask your colleagues. We might also help you by email at __[[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]__.

118

119

120

{{confluence_tip title="How long does it take to get a Belle II membership?"}}

121

Your membership request triggers an approval workflow which involves the representative of your institution (IR), and the IB - if you are physicist / faculty/staff - followed by the creation of your DESY credentials (account name / password). The entire process is usually finished within one workday but obviously depends on the availability of people.

Please refer to the official [[Belle II members list>>url:http://belle.kek.jp/secured2/secretary/memberlist/list2.cgi||shape="rect"]] (protected).

If your affiliation with your current Belle II institution ends, e.g. after finishing a thesis, your current Belle II institution representative (IR) will set your Belle II membership to 'Expired'. Subsequently your DESY account for the Belle II collaborative services and tools will expired with a grace period of one month as well. See [[doc:BI.Belle II Membership Management System.WebHome]] for information if you change to another Belle II institution. Do not register again, your record remains in the system.

----

== {{id name="BelleIIRegistrationandAccountFAQ-Registration"/}}Registration ==

143

144

{{confluence_tip title="After registration I received an email about the readiness of my account. How can I change the password?"}}

145

Account and password are the ones you typed into the form at registration time.

146

147

148

{{confluence_tip title="The certificate-based registration fails, because my name is not in the CN of my certificate."}}

149

The portal compares your name with the name in your certificate to avoid miss-use of stolen certificates. In this very rare case cancel the process and contact__ [[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]__.__//

//__

{{confluence_tip title="My initial password does not work. I am sure though that it is the right one."}}

154

The DESY registry needs some time (<=5h) to set up the credentials and notify the connected services. Please try again in a few hours. You will get an email if everything is set up.

155

156

157

{{confluence_tip title="Why am I asked for my date and place of birth?"}}

158

In order to uniquely identify you in our system, we have to know your date and place of birth. Be sure the information will not be used elsewhere according to the privacy rules.

----

== {{id name="BelleIIRegistrationandAccountFAQ-AccountandPassword"/}}Account and Password ==

172

173

174

Your DESY account is a 4-8 character string; **case insensitive**. The DESY account is not an email address! We recommend to use parts of your last name.

Belle II collaborators who have //already// a **DESY credentials** should contact __//[[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]//__ . The credentials can be prepared for Belle II. A **Grid user certificate** and the membership in the **VO** '[[belle'>>url:https://voms.cc.kek.jp:8443/voms/belle||rel="nofollow" shape="rect" class="external-link"]] is strongly recommended though.

Your credentials (account name / password) are good to login to DESY by //ssh// to [[bastion.desy.de>>url:http://bastion.desy.de||shape="rect"]]. You will see your AFS home dir at DESY (DESY.DE).

Login by //ssh// to [[bastion.desy.de>>url:http://bastion.desy.de||shape="rect"]] using your DESY credentials and type 'kinit'. Example:

187

188

bastion02: [~~] kinit

189

Password for [[xxx@DESY.DE>>mailto:gellrich@DESY.DE||shape="rect"]]:

190

Warning: Your password will expire in 33 days on Wed Mar 28 00:59:58 2018

191

192

In case you can't remember your password, please write to __[[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]//.//__//

193

//An admin will set a temporary password and you will be asked to use this temporary password to log in to [[https:~~/~~/password.desy.de/>>url:https://password.desy.de/||shape="rect"]] and set a new one.

In case you can't remember your password, please write to __[[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]//.//__//

198

//An admin will set a temporary password and you will be asked to use this temporary password to log in to [[https:~~/~~/password.desy.de/>>url:https://password.desy.de/||shape="rect"]] and set a new one.

199

200

201

{{confluence_tip title="What about capital letters in account names and email addresses?"}}

202

In general **account names** and email addresses are (% style="color: rgb(255,0,0);" %)**case insensitive**(%%)!

203

204

205

{{confluence_tip title="What are the DESY password requirements/rules?"}}

206

Please refer to [[doc:BI.DESY Requirements for Account Names and Passwords.WebHome]] .

207

208

209

{{confluence_tip title="What are the 'Conditions of Use for Information-Processing Systems at DESY' all about?"}}

210

At the bottom of the request portal you are asked to agree to the '[[Conditions of Use for Information-Processing Systems at DESY>>url:http://it.desy.de/e93779/BO-IV-DESY-Eng.pdf||rel="nofollow" shape="rect" class="external-link"]]'. The underlying document contains links to pages which are not relevant for abroad users, such as the local work council '[[http:~~/~~/www.desy.de/betriebsrat'.>>url:http://www.desy.de/betriebsrat||rel="nofollow" shape="rect" class="external-link"]]

211

212

213

{{confluence_tip title="How long does it take to create my login credentials?"}}

214

(% style="color: rgb(0,51,102);" %)The creation of the login credentials is finished within one work day. Please note: DESY is in the Central European Time-zone (CET).

Use [[https:~~/~~/password.desy.de/>>url:https://password.desy.de/||shape="rect"]] or (deprecated!) login to //[[bastion.desy.de>>url:http://bastion.desy.de||shape="rect"]]// and use the command '//passwd//'. It connects to the DESY registry which manages the access to afs, [[web>>url:http://belle2.org||shape="rect"]] pages, and //Atlassian// tools (confluence, stash, agira, bamboo). The [[Sympa>>url:https://lists.belle2.org||shape="rect"]] ML server and [[Indico>>url:https://indico.desy.de/categoryDisplay.py?categId=428||shape="rect"]] are //not// managed automatically. The account name / password is valid for **all** resources. Please denote [[doc:BI.DESY Requirements for Account Names and Passwords.WebHome]].

219

220

If the web service [[https:~~/~~/password.desy.de/>>url:https://password.desy.de/||shape="rect"]] fails due to your network settings (we saw such cases), login via '//ssh password.desy.de//'.

221

222

223

{{confluence_tip title="I changed my DESY password using 'passwd' on a DESY login host?"}}

224

The command '//passwd//' issued on a DESY login host, e.g. //[[bastion.desy.de>>url:http://bastion.desy.de||shape="rect"]]//, connects to the DESY registry which manages the access to afs, [[web>>url:http://belle2.org||shape="rect"]] pages, and //Atlassian// tools (confluence, stash, agira, bamboo). The [[Sympa>>url:https://lists.belle2.org||shape="rect"]] ML server and [[Indico>>url:https://indico.desy.de/categoryDisplay.py?categId=428||shape="rect"]] are //not// managed automatically.

If your password got lost we reset it for you, please contact //[[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]//. **Do not register again! **Please denote [[doc:BI.DESY Requirements for Account Names and Passwords.WebHome]].

See [[doc:BI.Belle II Newcomers.Belle II User Registration.Belle II Requesting Additional Resource Access.WebHome]].

233

234

235

{{confluence_tip title="What is my Belle II account at DESY good for?"}}

236

The DESY Belle II credentials you got through the [[registration procedure>>doc:BI.Belle II Newcomers.Belle II User Registration.WebHome]] can be used to access the **new** Belle II web pages and the new Confluence Wiki incl. JIRA and STASH.

237

238

239

{{confluence_tip title="Do I have to renew my Belle II account at DESY yearly as at KEK?"}}

240

No, this is not necessary but you will be asked regularly to change your password. The account name / password is valid for **all** resources. Please denote [[doc:BI.DESY Requirements for Account Names and Passwords.WebHome]].

If you were able to or are still able to login to //[[bastion.desy.de>>url:http://bastion.desy.de||shape="rect"]]// , you got DESY credentials earlier which can be used for Belle II. Contact [[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]] . A new registration attempt via the portal would fail.

The DESY credentials ( account name / password) are valid for **all** resources. Use [[https:~~/~~/password.desy.de/>>url:https://password.desy.de/||shape="rect"]] . Please denote [[doc:BI.DESY Requirements for Account Names and Passwords.WebHome]].

249

250

251

{{confluence_tip title="Email from the DESY registry that account expires?"}}

252

(% style="color: rgb(255,0,0);" %)**DESY will take care! There is nothing you must do!**(%%) According to the DESY (security) rules, accounts automatically expire but can be extended by an admin. As long as you are an active Belle II member according to your status in the B2MMS, your account will be extended.

----

== {{id name="BelleIIRegistrationandAccountFAQ-EmailAddress"/}}Email Address ==

\\

The DESY registry will use the (% style="color: rgb(255,0,0);" %)**names**(%%) you have given as 'given middle family' and create email addresses such as __[[given.middle.family_AT_desy.de>>url:http://given.middle.family_AT_desy.de||shape="rect"]]__ and __[[given.middle.family_AT_belle2.org>>url:http://given.middle.family_AT_belle2.org||shape="rect"]]__. Make up your mind if you really want the middle name. The spaces will be transformed to dots! Example: (% style="color: rgb(255,0,0);" %)'Nino de Angelo' will become '__nino.de.angelo_AT_desy.de__' and '__nino.de.angelo_AT_belle2.org__' whereas 'Nino deAngelo' (no middle name) will end up in '__nino.deangleo_AT_desy.de__'.

271

272

273

{{confluence_tip title="How do I change my email address in the collaboration email list?"}}

274

The collaboration members email list is automatically created from the Belle II Membership Management System (B2MMS). Please change your email address there (see [[doc:BI.Belle II Membership Management System.WebHome]]).

275

276

277

{{confluence_tip title="Do I have a DESY and belle2.org e-mail address?"}}

278

The addresses are of the form 'firstname[.middlename].[[lastname_AT_desy.de>>url:http://lastname_AT_desy.de||shape="rect"]]' and 'firstname[.middlename].[[lastname_AT_belle2.org>>url:http://lastname_AT_belle2.org||shape="rect"]]'. See [[Belle II email Addresses>>doc:BI.Belle II Newcomers.Belle II User Registration.Belle II Email Addresses.WebHome]] . The assigned address can also be found in your personal record in the Belle II membership management system.

'Privacy Enhanced Mail'. This is your 'real' personal email address with your mailbox behind.

Please send an email to __b2-helpdesk_AT_belle2.org__//.//

----

== {{id name="BelleIIRegistrationandAccountFAQ-GridUserCertificateandVO'belle'membership(VOMS)"/}}Grid User Certificate and VO 'belle' membership (VOMS) ==

\\

Please refer to the page [[doc:BI.Belle II Registration and Account FAQ.What are Grid User Certificates.WebHome]] . Note: Service or host certificates identify services and hosts not users!

305

306

307

{{confluence_tip title="Are there step-by-step instructions to obtain and use a Grid user certificate?"}}

308

Please go to [[doc:BI.Belle II Newcomers.Belle II User Registration.WebHome]] and scroll down.

309

310

311

{{confluence_tip title="I have already a Grid user certifcate?"}}

312

Belle II collaborators who have a //already// a **Grid user certificate** and are //already// member of the **VO** '[[belle'>>url:https://voms.cc.kek.jp:8443/voms/belle||shape="rect"]] see [[doc:BI.Belle II Newcomers.Belle II User Registration.WebHome]]. Make sure the Grid user certificate is in the browser!

313

314

315

{{confluence_tip title="I got my Grid user certificate in an e-mail?"}}

316

You must copy the certificate part in the email into a file such as '//mycert.cer//' and import this into your browser.

317

318

319

{{confluence_tip title="Is my Grid user certificate in the browser?"}}

320

Check existence and validity of your Grid user certificate in your **firefox** browser in //Preferences / Advanced / Certificates / View Certificates / Your Certificate.

//

{{confluence_tip title="I am confused about the name of the VO. Is it 'belle' or 'belle2.org'?"}}

325

For historic reasons the VO [['belle'>>url:https://voms.cc.kek.jp:8443/voms/belle||shape="rect"]] is the **correct** one. Although this seems wrong, please do **not** use the VO '[[belle2.org>>url:http://belle2.org||shape="rect"]]'.

See [[https:~~/~~/voms.cc.kek.jp:8443/voms/belle>>url:https://voms.cc.kek.jp:8443/voms/belle||shape="rect"]] .

330

331

332

{{confluence_tip title="With my certificate I am already member of another VO?"}}

333

The Grid user certificate allows to electronically prove your identity. This is independent of any VO membership though it can be used to gain membership one ore more VOs.

334

335

336

{{confluence_tip title="I lost the password of my Grid user certificate?"}}

337

As the private key the password is as the the word implies 'private'. It is only known to you. Unfortunately you must request a new certificate from your CA.

338

339

340

{{confluence_tip title="How to convert my KEK user certificate to .p12?"}}

341

Please refer to this// KEK [[manual.>>url:http://gridca.kek.jp/repository/usersmanual.html||shape="rect"]]

//

{{confluence_tip title="I needed a .p12 cert for my browser but seem to have .p7b?"}}

346

Please refer to [[https:~~/~~/www.sslshopper.com/ssl-converter.html>>url:https://www.sslshopper.com/ssl-converter.html||shape="rect"]] for details.

347

348

349

{{confluence_tip title="How to test my Grid user certificate in ~~/.globus ?"}}

350

Grid users usually have exported their Grid user certificate to ~~/.globus to use it with Grid commands such as 'voms-proxy-init', 'dirac-proxy-init', or 'gb2_proxy_init'. The following commands may help to investigate the situation.

The directory:

~> cd ~~/.globus

~> ls -l

-r~-~-r~-~-r~-~- 1 usercert.pem

359

360

-r~-~-~-~-~-~-~-~- 1 userkey.pem

\\

Checking if public (cert) and private (key) match:

\\

(% class="code" %)

(((

~> openssl x509 -noout -modulus -in usercert.pem | openssl md5

371

~> openssl rsa -noout -modulus -in userkey.pem | openssl md5

)))

\\

Checking subject, issuer, and validity dates:

377

378

~> openssl x509 -subject -issuer -email -dates -noout -in ~~/.globus/usercert.pem

\\

Recreating a single file with public and private key to be improted into a broser:

383

384

~> openssl pkcs12 -export -out my_cert.p12 -inkey userkey.pem -in usercert.pem

----

== {{id name="BelleIIRegistrationandAccountFAQ-Others(Browsercertproblems,GIT/Stash,CAPTCHA)"/}}Others (Browser cert problems, GIT/Stash, CAPTCHA) ==

\\

{{confluence_tip title="My browser complains about connection / SSL problems?"}}

402

Connection errors such as 'SSL_ERROR_HANDSHAKE_FAILURE_ALERT' are due to old or missing CA certificates in your browser. You might want to check //Preferences / Advanced / Certificates / View Certificates / Servers //and// Authorities .// Also consider to use another browser. We have good experiences with **firefox** and we saw also **safari** on MAC working. From our experience there is usually someone in your group or institute who managed.

403

404

405

{{confluence_tip title="When trying to connect to the KEK VOMS server I see 'SSL_ERROR_HANDSHAKE_FAILURE_ALERT'?"}}

406

In order to create the necessary secure connection to the KEK VOMS server, your browser needs to accept the VOMS server's certificate. Click 'Advanced' / 'Add exception' / 'Get certificate' / 'Store permanently' / 'Confirm' .

407

408

409

{{confluence_tip title="How can I use my account with GIT/stash?"}}

410

Please refer to [[doc:BI.Belle II Internal.Software.Software Basf2SoftwarePortal.GitIntroduction.WebHome]] .

411

412

413

{{confluence_tip title="I see with git or stash: 'fatal: remote error: CAPTCHA required'?"}}

414

You probably have typed in a **wrong password to often**. Now the system wants to make sure you are not a robot to reset the counter. Please try to log in to [[https:~~/~~/stash.desy.de>>url:https://stash.desy.de||shape="rect"]] and see the '**captcha**' there and solve solve. If you are still logged in, **log out completely first**. Also make sure have **not stored an old password** in a script e.g. for git access!

415

416

Remember: Do NOT use your email address to log in, but your account name!

417

418

CAPTCHA stands for (% class="st" %)"Completely Automated Public Turing test to tell Computers and Humans Apart." It will ask you questions to find out whether you are real ...

----

== {{id name="BelleIIRegistrationandAccountFAQ-AnalysisFacility(NAF)"/}} Analysis Facility (NAF) ==

\\

Please refer to the// [[NAF-Wiki>>url:https://naf-wiki.desy.de/Main_Page||shape="rect"]] .

//

{{confluence_tip title="I want to use Belle II computing resources?"}}

441

Registered Belle II users may get access to the Analysis Facility (NAF) at DESY. Please refer to [[doc:BI.Belle II Newcomers.Belle II User Registration.Belle II Requesting Additional Resource Access.WebHome]].//

//

The NAF provides scratch space of per default 1TB/user on a distributed file system (DUST). Please look for '///nfs/belle2/user/<your_account_name>//'. If it is not yet there please contact __[[b2-helpdesk_AT_belle2.org>>url:http://b2-helpdesk_AT_belle2.org||shape="rect"]]__.

See [[doc:BI.Belle II Newcomers.Belle II User Registration.Belle II Requesting Additional Resource Access.WebHome]].