Postgresql Tài liệu 8.0.26 | ||||
---|---|---|---|---|
Prev | Backward nhanh | Chương 14. Hướng dẫn kèo bóng đá c1 | Chuyển tiếp nhanh | NEXT |
Cấu hình
Bước đầu tiên của quy trình kèo bóng đá c1 là để Định cấu hình cây nguồn cho hệ thống của bạn và chọn Tùy chọn bạn muốn. Điều này được thực hiện bằng cách chạyCấu hìnhtập lệnh. Cho một mặc định kèo bóng đá c1 chỉ cần nhập
./configure
Tập lệnh này sẽ chạy một số bài kiểm tra để đoán các giá trị cho các biến phụ thuộc vào hệ thống khác nhau và phát hiện một số Quirks của hệ điều hành của kèo bóng đá c1 và cuối cùng sẽ tạo Một số tập tin trong cây xây dựng để ghi lại những gì nó tìm thấy. (kèo bóng đá c1 cũng có thể chạyCấu hìnhTrong a thư mục bên ngoài cây nguồn nếu kèo bóng đá c1 muốn giữ xây dựng thư mục riêng biệt.)
Cấu hình mặc định sẽ xây dựng máy chủ và các tiện ích, cũng như tất cả các ứng dụng khách hàng và Các giao diện chỉ yêu cầu một trình biên dịch C. Tất cả các tập tin sẽ được kèo bóng đá c1 dưới/usr/local/pgsqlTheo mặc định.
Bạn có thể tùy chỉnh quy trình xây dựng và kèo bóng đá c1 bằng cách Cung cấp một hoặc nhiều tùy chọn dòng lệnh sau đây ĐẾNCấu hình:
kèo bóng đá c1 tất cả các tệp trong thư mụctiền tốthay vì/usr/local/pgsql. Các tập tin thực tế sẽ được kèo bóng đá c1 vào các thư mục con khác nhau; KHÔNG Các tệp sẽ được kèo bóng đá c1 trực tiếp vàotiền tốThư mục.
Nếu bạn có nhu cầu đặc biệt, bạn cũng có thể tùy chỉnh các thư mục con riêng lẻ với tùy chọn. Tuy nhiên, nếu bạn để những thứ này với Mặc định, việc kèo bóng đá c1 sẽ có thể di dời, nghĩa là bạn có thể di chuyển thư mục sau kèo bóng đá c1. (Thengười đàn ôngvàdocVị trí thì không bị ảnh hưởng bởi điều này.)
Để kèo bóng đá c1 có thể chuyển vị, bạn có thể muốn sử dụngCấu hình's--Disable-RPATHTùy chọn. Ngoài ra, kèo bóng đá c1 sẽ cần cho hệ điều hành làm thế nào để tìm Thư viện được chia sẻ.
Bạn có thể kèo bóng đá c1 các tệp phụ thuộc kiến trúc dưới một tiền tố khác,Exec-Prefix, hơn những gìtiền tốĐã được đặt thành. Điều này có thể hữu ích để chia sẻ sự độc lập về kiến trúc tập tin giữa các máy chủ. Nếu kèo bóng đá c1 bỏ qua điều này, thìEXEC-PREFIXđược đặt bằngtiền tốvà cả các tệp phụ thuộc vào kiến trúc và độc lập sẽ được kèo bóng đá c1 dưới cùng một cây, đó là có lẽ là những gì bạn muốn.
Chỉ định thư mục cho các chương kèo bóng đá c1 thực thi. Mặc định làExec-Prefix/bin, mà Thông thường có nghĩa là/usr/local/pgsql/bin.
Đặt thư mục cho các tệp dữ liệu chỉ đọc được sử dụng bởi các chương trình đã kèo bóng đá c1. Mặc định làtiền tố/chia sẻ. Lưu ý rằng Điều này không liên quan gì đến nơi các tệp cơ sở dữ liệu của kèo bóng đá c1 sẽ được đặt.
Thư mục cho các tệp cấu hình khác nhau,tiền tố/etcTheo mặc định.
Vị trí để kèo bóng đá c1 thư viện và linh hoạt Các mô -đun có thể tải. Mặc định làEXEC-PREFIX/lib.
Thư mục để kèo bóng đá c1 tiêu đề C và C ++ Tệp. Mặc định làtiền tố/Bao gồm.
trang người đàn ông đi kèm vớiPostgreSQLsẽ được kèo bóng đá c1 theo thư mục này, trong tương ứng của họManxSubDirectories. Mặc định làtiền tố/Man.
Tệp tài liệu, ngoại trừ"Man"các trang, sẽ được kèo bóng đá c1 vào Thư mục này. Mặc định làtiền tố/doc. Nếu tùy chọn--without-docdirIS được chỉ định, tài liệu sẽ không được kèo bóng đá c1 bởiTạo kèo bóng đá c1. Đây là dành cho các tập lệnh đóng gói có đặc biệt các phương thức kèo bóng đá c1 tài liệu.
Lưu ý:đã được thực hiện để làm cho nó có thể để kèo bóng đá c1PostgreSQLvào các vị trí kèo bóng đá c1 được chia sẻ (chẳng hạn như/usr/local/bao gồm) mà không can thiệp với không gian tên của phần còn lại của hệ thống. Đầu tiên, chuỗi"/PostgreSQL"được tự động Được thêm vàoDatadir, sysconfdirvàDocDir, Trừ khi được mở rộng hoàn toàn Tên thư mục đã chứa chuỗi"Postgres"hoặc"PGSQL". Ví dụ, nếu kèo bóng đá c1 chọn/usr/localnhư tiền tố, Tài liệu sẽ được kèo bóng đá c1 trong/usr/local/doc/postgresql, nhưng nếu Tiền tố là/opt/postgres, sau đó nó sẽ ở trong/opt/postgres/doc. Tiêu đề công khai C Các tệp của giao diện máy khách được kèo bóng đá c1 vàoBao gồmvà là Không gian tên-Clean. Các tệp tiêu đề nội bộ và Các tệp tiêu đề máy chủ được kèo bóng đá c1 vào riêng tư thư mục dướiBao gồm. Xem tài liệu của từng giao diện để biết thông tin về cách nhận được các tập tin tiêu đề của nó. Cuối cùng, a thư mục con riêng tư cũng sẽ được tạo ra, nếu thích hợp, dướilibdircho Các mô -đun có thể tải động.
Thư mụclà a Danh sách các thư mục được phân tách đại tràng sẽ được thêm vào danh sách kèo bóng đá c1 biên dịch tìm kiếm tiêu đề Tệp. Nếu bạn có các gói tùy chọn (chẳng hạn như GNUReadline) Đã kèo bóng đá c1 Ở một vị trí không chuẩn, bạn phải sử dụng cái này tùy chọn và có lẽ cũng là tương ứng-với thư việnTùy chọn.
Ví dụ:-với in-includes =/opt/gnu/bao gồm:/usr/sup/bao gồm.
Thư mụclà a Danh sách các thư mục được phân tách đại tràng để tìm kiếm Thư viện. kèo bóng đá c1 có thể sẽ phải sử dụng tùy chọn này (và tương ứng--với phần mềmtùy chọn) Nếu bạn có các gói được kèo bóng đá c1 ở các vị trí không chuẩn.
Ví dụ:--with-libres =/opt/gnu/lib:/usr/sup/lib.
Cho phép hỗ trợ ngôn ngữ bản địa (NLS), nghĩa là khả năng hiển thị các tin nhắn của một chương kèo bóng đá c1 bằng một ngôn ngữ khác Tiếng Anh.Ngôn ngữIS một danh sách các mã được phân tách không gian kèo bóng đá c1 muốn được hỗ trợ, ví dụ--Enable-nls = 'de fr'. (The giao điểm giữa danh sách của bạn và tập hợp Trên thực tế, các bản dịch được cung cấp sẽ được tính toán tự động.) Nếu bạn không chỉ định danh sách, thì Tất cả các bản dịch có sẵn được kèo bóng đá c1.
Để sử dụng tùy chọn này, kèo bóng đá c1 sẽ cần một việc thực hiệnGetTextAPI; xem ở trên.
setSốnhư Số cổng mặc định cho máy chủ và máy khách. Các Mặc định là 5432. Cổng luôn có thể được thay đổi sau trên, nhưng nếu kèo bóng đá c1 chỉ định nó ở đây thì cả máy chủ và máy khách sẽ có cùng một mặc định được biên soạn, trong đó có thể rất thuận tiện. Thường là lý do chính đáng duy nhất Để chọn giá trị không mặc định là nếu kèo bóng đá c1 có ý định chạy nhiềuPostgreSQLMáy chủ trên cùng một máy.
Xây dựngPL/PerlNgôn ngữ phía máy chủ.
Xây dựngPL/Pythonphía máy chủ ngôn ngữ.
Xây dựngPL/TCLNgôn ngữ phía máy chủ.
TCL kèo bóng đá c1 tệpTCLCONFIG.SH, chứa thông tin cấu hình cần thiết để xây dựng các mô -đun giao tiếp với TCL. Tệp này thường được tìm thấy tự động tại một vị trí nổi tiếng, nhưng nếu kèo bóng đá c1 muốn sử dụng một phiên bản khác của TCL mà kèo bóng đá c1 có thể Chỉ định thư mục để tìm nó.
Xây dựng với sự hỗ trợ cho xác thực Kerberos. Bạn có thể sử dụng Kerberos phiên bản 4 hoặc 5, nhưng không cả hai. Trên nhiều hệ thống, hệ thống kerberos không được kèo bóng đá c1 ở một vị trí được tìm kiếm theo mặc định (ví dụ.,/usr/bao gồm, /usr/lib), vì vậy kèo bóng đá c1 phải sử dụng Các tùy chọn--với phần mềmvà-với thư việnin bổ sung cho tùy chọn này.Cấu hìnhSẽ kiểm tra các yêu cầu các tệp tiêu đề và thư viện để đảm bảo rằng kèo bóng đá c1 Kerberos là đủ trước đó tiến hành.
Tên của Hiệu trưởng dịch vụ Kerberos.Postgreslà mặc định. Có lẽ không có lý do để thay đổi điều này.
xây dựng với sự hỗ trợ choSSL(mã hóa) Kết nối. Cái này yêu cầuOpenSSLGói sẽ được kèo bóng đá c1.Cấu hìnhSẽ kiểm tra các yêu cầu các tệp tiêu đề và thư viện để đảm bảo rằng của kèo bóng đá c1OpenSSLkèo bóng đá c1 là đủ trước khi tiến hành.
Ngăn chặn việc sử dụngReadlineThư viện. Điều này vô hiệu hóa Chỉnh sửa dòng lệnh và lịch sử trongPSQL, vì vậy nó không phải là khuyến khích.
Xây dựng với hỗ trợ Rendezvous. Điều này đòi hỏi Rendezvous hỗ trợ trong hệ điều hành của kèo bóng đá c1. Được đề xuất trên Mac OS X.
Cho phép bản dựng thành công ngay cả khiPostgreSQLKhông có spinlockock CPU Hỗ trợ cho nền tảng. Việc thiếu spinlock Hỗ trợ sẽ dẫn đến hiệu suất kém; Vì vậy, Tùy chọn này chỉ nên được sử dụng nếu xây dựng phá thai và thông báo cho kèo bóng đá c1 rằng nền tảng thiếu spinlock ủng hộ. Nếu tùy chọn này được yêu cầu xây dựngPostgreSQLTrên của kèo bóng đá c1 nền tảng, vui lòng báo cáo vấn đề choPostgreSQLnhà phát triển.
Làm cho thư viện máy khách an toàn. Điều này cho phép Các luồng đồng thời tronglibpqvàECPGChương kèo bóng đá c1 kiểm soát an toàn tay cầm kết nối riêng của họ. Tùy chọn này yêu cầu hỗ trợ luồng đầy đủ trong hoạt động của bạn hệ thống.
Ngăn chặn sử dụng củazlibThư viện. Điều này vô hiệu hóa hỗ trợ cho tài liệu lưu trữ được nén trongpg_dumpvàPG_RESTORE. Cái này Tùy chọn chỉ dành cho các hệ thống hiếm Thư viện này không khả dụng.
Biên dịch tất cả các chương trình và thư viện với gỡ lỗi biểu tượng. Điều này có nghĩa là bạn có thể chạy các chương trình thông qua một trình gỡ lỗi để phân tích các vấn đề. Điều này mở rộng Kích thước của các tệp thực thi được kèo bóng đá c1 một cách đáng kể, và trên các trình biên dịch không GCC, nó cũng thường vô hiệu hóa Tối ưu hóa trình biên dịch, gây ra sự chậm lại. Tuy nhiên, Có sẵn các biểu tượng là vô cùng hữu ích cho đối phó với bất kỳ vấn đề có thể phát sinh. Hiện nay, Tùy chọn này được khuyến nghị để sản xuất Chỉ kèo bóng đá c1 chỉ khi bạn sử dụng GCC. Nhưng bạn nên luôn luôn có nó nếu bạn đang làm công việc phát triển hoặc chạy phiên bản beta.
cho phépKhẳng địnhKiểm tra trong máy chủ, thử nghiệm cho nhiều người"Không thể xảy ra"Điều kiện. Đây là vô giá cho mục đích phát triển mã, nhưng Kiểm tra mọi thứ chậm lại một chút. Ngoài ra, có Các bài kiểm tra được bật sẽ không nhất thiết phải tăng cường sự ổn định của máy chủ của kèo bóng đá c1! Kiểm tra xác nhận là không được phân loại cho mức độ nghiêm trọng, và vì vậy những gì có thể là một Lỗi tương đối vô hại vẫn sẽ dẫn đến máy chủ Khởi động lại nếu nó kích hoạt lỗi xác nhận. Hiện tại, tùy chọn này không được khuyến nghị cho Sử dụng sản xuất, nhưng kèo bóng đá c1 nên có nó cho Công việc phát triển hoặc khi chạy phiên bản beta.
Cho phép theo dõi phụ thuộc tự động. Với điều này tùy chọn, các makefiles được thiết lập để tất cả bị ảnh hưởng Các tệp đối tượng sẽ được xây dựng lại khi bất kỳ tệp tiêu đề nào là đã thay đổi. Điều này rất hữu ích nếu bạn đang phát triển công việc, nhưng chỉ lãng phí chi phí nếu bạn chỉ có ý định Để biên dịch một lần và kèo bóng đá c1. Hiện tại, tùy chọn này sẽ chỉ hoạt động nếu bạn sử dụng gcc.
Nếu bạn thích kèo bóng đá c1 biên dịch C khác với OneCấu hìnhchọn, kèo bóng đá c1 có thể đặt Biến môi trườngCCđến chương kèo bóng đá c1 của sự lựa chọn của bạn. Theo mặc định,Cấu hìnhsẽ chọnGCCNếu có sẵn, khác của nền tảng Mặc định (thường làCC). Tương tự, Bạn có thể ghi đè các cờ kèo bóng đá c1 biên dịch mặc định nếu cần với TheCFLAGSBiến.
kèo bóng đá c1 có thể chỉ định các biến môi trường trênCấu hìnhdòng lệnh, ví dụ:
./configure cc =/opt/bin/gcc cflags = ' -o2 -pipe'
Build
Để bắt đầu bản dựng, gõ
gmake
(nhớ sử dụngGNU làm.) Bản dựng có thể mất Bất cứ nơi nào từ 5 phút đến nửa giờ tùy thuộc vào Phần cứng. Dòng cuối cùng được hiển thị phải là
Tất cả PostgreSQL được thực hiện thành công. Sẵn sàng để kèo bóng đá c1.
Kiểm tra hồi quy
Nếu bạn muốn kiểm tra máy chủ mới được xây dựng trước khi bạn kèo bóng đá c1 nó, bạn có thể chạy các bài kiểm tra hồi quy tại thời điểm này. Các bài kiểm tra hồi quy là một bộ kiểm tra để xác minh rằngPostgreSQLchạy trên của kèo bóng đá c1 Máy theo cách các nhà phát triển mong đợi nó. Kiểu
Kiểm tra gmake
(Điều này sẽ không hoạt động như root; làm điều đó như một người không có đặc quyền người dùng.)Chương 26chứa Thông tin chi tiết về giải thích kết quả kiểm tra. kèo bóng đá c1 có thể lặp lại bài kiểm tra này vào bất kỳ thời điểm nào sau đó bằng cách phát hành cùng một lệnh.
kèo bóng đá c1 tệp
Lưu ý:Nếu bạn đang nâng cấp một hệ thống hiện có và sẽ kèo bóng đá c1 các tệp mới qua tệp cũ những cái, hãy chắc chắn sao lưu dữ liệu của bạn và tắt Máy chủ cũ trước khi tiến hành, như được giải thích trongPhần 14.4ở trên.
Để kèo bóng đá c1POSTGRESQLEnter
kèo bóng đá c1 GMake
Điều này sẽ kèo bóng đá c1 các tệp vào các thư mục được chỉ định trongBước 1. Hãy chắc chắn rằng kèo bóng đá c1 có quyền thích hợp để viết vào đó khu vực. Thông thường kèo bóng đá c1 cần phải thực hiện bước này như root. Ngoài ra, kèo bóng đá c1 có thể tạo các thư mục mục tiêu trong tiến và sắp xếp cho các quyền thích hợp để được giả dụ như vậy.
kèo bóng đá c1 có thể sử dụnggmake install-stripthay vìGMAKE kèo bóng đá c1để dải Các tệp và thư viện thực thi khi chúng được kèo bóng đá c1. Điều này sẽ tiết kiệm một số không gian. Nếu bạn xây dựng với gỡ lỗi Hỗ trợ, tước bỏ sẽ loại bỏ hiệu quả việc gỡ lỗi hỗ trợ, vì vậy nó chỉ nên được thực hiện nếu gỡ lỗi là không lâu hơn cần thiết.kèo bóng đá c1-Stripcố gắng để thực hiện một không gian tiết kiệm công việc hợp lý, nhưng nó không có kiến thức hoàn hảo về cách tước từng byte không cần thiết từ một tệp thực thi, vì vậy nếu kèo bóng đá c1 muốn lưu tất cả các đĩa Không gian kèo bóng đá c1 có thể, kèo bóng đá c1 sẽ phải làm thủ công công việc.
kèo bóng đá c1 tiêu chuẩn cung cấp tất cả các tệp tiêu đề cần thiết để phát triển ứng dụng khách hàng cũng như Phát triển chương trình phía máy chủ, chẳng hạn như các chức năng tùy chỉnh hoặc các loại dữ liệu được viết bằng C. (trướcPostgreSQL8.0, riêng biệtgmake install-all-meadersLệnh là cần thiết cho cái sau, nhưng bước này đã được gấp lại thành kèo bóng đá c1 tiêu chuẩn.)
kèo bóng đá c1 chỉ dành cho máy khách:Nếu bạn muốn Chỉ kèo bóng đá c1 các ứng dụng và giao diện máy khách Thư viện, sau đó bạn có thể sử dụng các lệnh này:
GMAKE -C SRC/BIN kèo bóng đá c1 gmake -c src/bao gồm kèo bóng đá c1 35128_35161 GMake -c Doc kèo bóng đá c1
Đăng kýEventLogtrênWindows:Để đăng ký AWindows EventLogThư viện với hoạt động Hệ thống, phát hành lệnh này sau khi kèo bóng đá c1:
regsvr32PGSQL_L Library_Directory/pgevent.dll
Điều này tạo ra các mục đăng ký được sử dụng bởi kèo bóng đá c1 xem sự kiện.
Chứng nhận:Để hoàn tác kèo bóng đá c1 sử dụng yêu cầuGMAKE uninstall. Tuy nhiên, điều này sẽ không xóa bất kỳ thư mục được tạo nào.
Làm sạch:Sau khi kèo bóng đá c1, bạn có thể tạo phòng bằng cách Xóa các tệp được xây dựng khỏi cây nguồn bằng lệnhGMake Clean. Điều này sẽ bảo tồn Các tệp được tạo bởiCấu hìnhChương kèo bóng đá c1, để bạn có thể xây dựng lại mọi thứ bằnggmakeSau này. Để đặt lại cây nguồn cho trạng thái được phân phối, sử dụngGmake Distclean. Nếu kèo bóng đá c1 định xây dựng cho một số nền tảng trong cùng một cây nguồn kèo bóng đá c1 phải làm điều này và cấu hình lại cho mỗi bản dựng. (Ngoài ra, sử dụng một xây dựng cây cho mỗi nền tảng, để cây nguồn vẫn còn không sửa đổi.)
Nếu kèo bóng đá c1 thực hiện bản dựng và sau đó khám phá ra rằng của kèo bóng đá c1Cấu hìnhTùy chọn đã sai hoặc nếu kèo bóng đá c1 thay đổi bất cứ điều gìCấu hìnhĐiều tra (ví dụ: nâng cấp phần mềm), thì kèo bóng đá c1 nên làmGmake DistcleanTrước khi cấu hình lại và xây dựng lại. Không có điều này, những thay đổi của kèo bóng đá c1 trong các lựa chọn cấu hình có thể không tuyên truyền ở mọi nơi họ cần.