Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

Table of Contents

...

1.

...

 Start the Apache

...

HTTPD service

On macOS, the Apache HTTP Service should be installed but disabled by default. You can start the webserver with the command:

...

Code Block
languagebash
titleVerify your local fork
$ pwd
/Users/guozhang/git/kafka-site 

$ git remote -v
apache	https://github.com/apache/kafka-site.git (fetch)
apache	https://github.com/apache/kafka-site.git (push)
origin	https://github.com/guozhangwang/kafka-site.git (fetch)
origin	https://github.com/guozhangwang/kafka-site.git (push)

$ git checkout asf-site
 
$ git branch
* asf-site


3. Modify the Apache HTTPD configuration to point to your local fork

Now you need to edit the HTTPD config file and make the following changes.

...

Code Block
# File: /etc/apache2/httpd.conf
#
# DocumentRoot: The directory out of which you will serve your
# documents. By default, all requests are taken from this directory, but
# symbolic links and aliases may be used to point to other locations.
#
DocumentRoot "/Users/guozhang/git/kafka-site"             # <<< THIS LINE IS CHANGED
<Directory "/Users/guozhang/git/kafka-site">              # <<< THIS LINE IS CHANGED

    # Possible values for the Options directive are "None", "All",
    # or any combination of:
    #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
    #
    # Note that "MultiViews" must be named *explicitly* --- "Options All"
    # doesn't give it to you.
    #
    # The Options directive is both complicated and important.  Please see
    # http://httpd.apache.org/docs/2.4/mod/core.html#options
    # for more information.
    #
    Options FollowSymLinks Multiviews
    MultiviewsMatch Any

    #
    # AllowOverride controls what directives may be placed in .htaccess files.
    # It can be "All", "None", or any combination of the keywords:
    #   AllowOverride FileInfo AuthConfig Limit
    #
    AllowOverride All                                     # <<< THIS LINE IS CHANGED

    # Controls who can get stuff from this server.
    #
    Require all granted

</Directory>


4. Reload the Apache

...

HTTPD configuration

Restart the webserver to make the config changes take effect:

...

Info

Important Note: Your documentation changes should most likely be made in the main Apache Kafka code repository (https://github.com/apache/kafka) instead of the kafka-site repository, and in order to publish these changes to the Apache Kafka website (https://kafka.apache.org/) you should copy the modified documentation to the kafka-site repository into the respective release folders.

5. Shutdown the Apache

...

HTTPD service

If you want to shutdown the web server, run the command:

...