نصب جیرا در ویندوز: راهنمای کامل و تصمیم‌هایی که بعداً گران تمام می‌شوند

نصب جیرا در ویندوز با اینستالر گرافیکی چند دقیقه طول می‌کشد و تقریباً همیشه کار می‌کند. مشکل اینجاست که سه تصمیم در همان چند دقیقه گرفته می‌شود که تا آخر عمر آن نمونه با شما می‌مانند: مسیر JIRA_HOME، دیتابیس، و حافظهٔ اختصاص‌یافته. این نوشته دربارهٔ همان سه تاست، نه دربارهٔ زدن دکمهٔ Next.

پیش‌نیازها

• ویندوز سرور (نسخهٔ پشتیبانی‌شده در ماتریس سازگاری همان نسخهٔ جیرا). نصب روی ویندوز دسکتاپ فقط برای تست شخصی قابل قبول است.
• حافظه: حداقل ۸ گیگابایت رم برای محیط کوچک. ۴ گیگ کار می‌کند ولی زیر بار اول جایی است که می‌شکند.
• دیتابیس بیرونی. دیتابیس داخلی (H2) فقط برای ارزیابی است.
• جاوا همراه اینستالر می‌آید؛ لازم نیست جدا نصب کنید و بهتر است نکنید.
• یک کاربر سرویس اختصاصی — نه Administrator.

مهم‌ترین تصمیم: JIRA_HOME را از مسیر نصب جدا کنید

جیرا دو مسیر دارد و قاطی کردنشان رایج‌ترین اشتباه نصب است:

اگر JIRA_HOME را زیر مسیر نصب بگذارید، ارتقای بعدی یعنی جابه‌جایی دستی دادهٔ واقعی — و آنجاست که آدم‌ها داده از دست می‌دهند. جداشان کنید:

C:\Atlassian\Jira           <- install
D:\JiraData                 <- JIRA_HOME (روی درایو داده)

همین منطق در داکر هم صدق می‌کند و آنجا حتی صریح‌تر است: نصب جیرا با داکر.

مراحل نصب

1. دیتابیس را اول بسازید. یک دیتابیس خالی با collation درست و یک کاربر اختصاصی با دسترسی کامل به همان دیتابیس. برای PostgreSQL کدگذاری UTF8 الزامی است.
2. اینستالر را اجرا کنید و گزینهٔ Custom Install را بزنید تا بتوانید مسیرها را تعیین کنید. گزینهٔ Express هر دو مسیر را کنار هم می‌گذارد.
3. مسیر نصب و JIRA_HOME را جدا بدهید.
4. پورت را تعیین کنید. پیش‌فرض 8080 است. اگر چیز دیگری روی این پورت هست، همین‌جا عوضش کنید نه بعداً.
5. نصب به‌عنوان سرویس ویندوز را انتخاب کنید تا با ری‌استارت سرور بالا بیاید.
6. در ویزارد راه‌اندازی، گزینهٔ اتصال به دیتابیس بیرونی را بزنید و اطلاعات مرحلهٔ یک را بدهید.
7. لایسنس و کاربر ادمین را وارد کنید و راه‌اندازی را تمام کنید.

حافظه؛ جایی که نصب پیش‌فرض کم می‌آورد

مقدار پیش‌فرض heap برای هر محیط واقعی کم است. فایل تنظیمات سرویس را ویرایش کنید و مقدار کمینه و بیشینه را برابر بگذارید تا JVM وقت خودش را صرف تغییر اندازهٔ heap نکند:

JVM_MINIMUM_MEMORY=4096m
JVM_MAXIMUM_MEMORY=4096m

بعد از نصب — چهار کاری که همان روز اول باید بکنید

1. بکاپ دیتابیس را زمان‌بندی کنید. بکاپ XML داخلی جیرا برای نمونهٔ واقعی کافی نیست؛ بکاپ دیتابیس به‌علاوهٔ بکاپ JIRA_HOME لازم است.
2. Base URL را درست تنظیم کنید. اگر پشت پراکسی هستید، همین حالا — نه بعد از اینکه لینک‌ها خراب شدند.
3. HTTPS را روی یک ریورس پراکسی بگذارید، نه روی خود تامکت. نگهداری‌اش ساده‌تر است.
4. لاگ دسترسی را روشن کنید. اگر روز اول روشن نباشد، اولین باری که کسی بگوید «کند است» هیچ دیتایی ندارید.

و مهم‌تر از همه: قبل از اینکه تیم واقعی رویش کار کند، ساختار پروژه را طراحی کنید. نصب بخش آسان ماجراست؛ چیزی که شش ماه بعد شکست می‌خورد ساختار است، نه نصب. پیاده‌سازی و راه‌اندازی جیرا دقیقاً همین بخش است.