Page MenuHomestyx hydra
Files F1992709

No OneTemporary
Actions

View Options

diff --git a/src/docs/userguide/notifications.diviner b/src/docs/userguide/notifications.diviner
index f94828c541..0842cf8335 100644
--- a/src/docs/userguide/notifications.diviner
+++ b/src/docs/userguide/notifications.diviner
@@ -1,84 +1,88 @@
@title Notifications User Guide: Setup and Configuration
@group userguide
Guide to setting up notifications.
= Overview =
Phabricator can be configured to notify users when events happen in real time,
so they'll get a message in their browser window if something has happened or
the object they're looking at has been updated.
NOTE: This feature is new and still needs some work.
= Enabling Notifications =
To enable notifications, set `notification.enabled` to `true` in your
configuration. This will enable the notification menu in the menu bar, and
notifications will be published when users take actions.
NOTE: This setting will be turned on for everyone soon.
= Running the Aphlict Server =
Phabricator implements realtime notifications using a Node.js server called
"Aphlict". To run it:
- Install node.js.
- Run `bin/aphlict` (this script must be run as root).
Since the script needs `PHABRICATOR_ENV` to be defined, you may need to use
the `-E` flag to `sudo` to preserve the environment if you have
`PHABRICATOR_ENV` defined in your `.bashrc` or similar:
phabricator/ $ sudo -E ./bin/aphlict
The server must be able to listen on port **843** and port **22280** for Aphlict
to work. You can change the latter port in the `notification.client-uri` config,
but port 843 is used by Flash and can not be changed. In particular, if you're
running in EC2, you need to unblock both of these ports in the server's security
group configuration.
You may want to adjust these settings:
- `notification.client-uri` Externally-facing host and port that browsers will
connect to in order to listen for notifications.
- `notification.server-uri` Internally-facing host and port that Phabricator
will connect to in order to publish notifications.
- `notification.log` Log file location for the server.
- `notification.user` Non-root user to drop permissions to after binding to
privileged ports.
- `notification.pid` Pidfile location used to stop any running server when
aphlict is restarted.
In most cases, the defaults are appropriate, except that you should set
`notification.user` to some valid user so Aphlict isn't running as root.
== Verifying Server Status ==
Access `/notification/status/` to verify the server is operational. You should
see a table showing stats like "uptime" and connection/message counts if the
server is working. If it isn't working, you should see an error.
== Testing the Server ==
The easiest way to test the server is to open a Maniphest Task or Differential
Revision in two browser windows at the same time, then comment on it with one.
You should get a notification in the other window.
NOTE: This will stop working soon, since we'll soon stop delivering
notifications about your own actions. We'll provide an alternate way to test
operation when this stops working.
== Debugging Server Problems ==
You can run `aphlict` in the foreground to get output to your console:
phabricator/ $ ./bin/aphlict --foreground
+You can run `support/aphlict/client/aphlict_test_client.php` to connect to the
+Aphlict server from the command line. Messages the client receives will be
+printed to stdout.
+
You can set `notification.debug` in your configuration to get additional
output in your browser.
The server also generates a log, by default in `/var/log/aphlict.log`. You can
change this location by changing `notification.log` in your configuration. The
log may contain information useful in resolving issues.
\ No newline at end of file
diff --git a/support/aphlict/client/aphlict_test_client.php b/support/aphlict/client/aphlict_test_client.php
new file mode 100755
index 0000000000..7131ef4736
--- /dev/null
+++ b/support/aphlict/client/aphlict_test_client.php
@@ -0,0 +1,72 @@
+#!/usr/bin/env php
+<?php
+
+/*
+ * Copyright 2012 Facebook, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+$root = dirname(dirname(dirname(dirname(__FILE__))));
+require_once $root.'/scripts/__init_script__.php';
+
+$args = new PhutilArgumentParser($argv);
+$args->setTagline('test client for Aphlict server');
+$args->setSynopsis(<<<EOHELP
+**aphlict_test_client.php** [__options__]
+ Connect to the Aphlict server configured in the Phabricator config.
+
+EOHELP
+);
+$args->parseStandardArguments();
+$args->parse(
+ array(
+ array(
+ 'name' => 'server',
+ 'param' => 'uri',
+ 'default' => PhabricatorEnv::getEnvConfig('notification.client-uri'),
+ 'help' => 'Connect to __uri__ instead of the default server.',
+ ),
+ ));
+$console = PhutilConsole::getConsole();
+
+$errno = null;
+$errstr = null;
+
+$uri = $args->getArg('server');
+$uri = new PhutilURI($uri);
+$uri->setProtocol('tcp');
+
+$console->writeErr("Connecting...\n");
+$socket = stream_socket_client(
+ $uri,
+ $errno,
+ $errstr);
+
+if (!$socket) {
+ $console->writeErr(
+ "Unable to connect to Aphlict (at '$uri'). Error #{$errno}: {$errstr}");
+ exit(1);
+} else {
+ $console->writeErr("Connected.\n");
+}
+
+$io_channel = new PhutilSocketChannel($socket);
+$proto_channel = new PhutilJSONProtocolChannel($io_channel);
+
+$json = new PhutilJSON();
+while (true) {
+ $message = $proto_channel->waitForMessage();
+ $console->writeOut($json->encodeFormatted($message));
+}
+

File Metadata

Mime Type
text/x-diff
Expires
Tue, Dec 2, 5:16 PM (14 h, 5 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
432278
Default Alt Text
(5 KB)

Event Timeline

styx copyright 2020 sirocyl / ellie (kymkdd) / ncommander / styx contributors
Use of other names and brands is not intended to reflect a claim of, or right to, use the name or brand.
styx is an operating system using the Linux kernel and components, and "styx Linux" as a phrase does not reflect the inclusion of the Linux brand or trademark in the styx project.
Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries.
Terms and Conditions (TODO: fix this!)