Skip to content

Commit 13bdfc8

Browse files
authored
Update migrate-from-slack.rst to include profile pictures
Documents mattermost/mmetl#57.
1 parent 6e15e06 commit 13bdfc8

File tree

1 file changed

+8
-6
lines changed

1 file changed

+8
-6
lines changed

source/onboard/migrate-from-slack.rst

+8-6
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ When you download your Slack export zip file, some data will be missing from the
5656

5757
- User emails
5858
- Uploaded attachment contents
59+
- Profile pictures
5960

6061
We need to create a Slack app in order to gather these contents. Follow these steps to create a Slack app:
6162

@@ -73,23 +74,24 @@ We need to create a Slack app in order to gather these contents. Follow these st
7374
8. Grant the app permissions when prompted.
7475
9. Copy the **Bot User OAuth Token** and save it somewhere convenient.
7576

76-
We'll now use **Bot User OAuth Token** with the ``slack-advanced-exporter`` tool to download emails and attachments. Download the latest release of ``slack-advanced-exporter`` for your OS and architecture `here <https://github.com/grundleborg/slack-advanced-exporter/releases/>`__ and extract the executable from the download.
77+
We'll now use **Bot User OAuth Token** with the ``slack-advanced-exporter`` tool to download emails, attachments and profile pictures. Download the latest release of ``slack-advanced-exporter`` for your OS and architecture `here <https://github.com/wetneb/slack-advanced-exporter/releases/>`__ and extract the executable from the download.
7778

7879
Once you have the program downloaded locally, run the commands below to fetch the emails, and then fetch file attachments. Replace ``<SLACK TOKEN>`` with the Slack token you generated earlier and ``<SLACK EXPORT FILE>`` with the `path <https://www.geeksforgeeks.org/absolute-relative-pathnames-unix/>`__ to your export file.
7980

8081
.. code-block:: sh
8182
8283
./slack-advanced-exporter --input-archive <SLACK EXPORT FILE> --output-archive export-with-emails.zip fetch-emails --api-token <SLACK TOKEN>
83-
./slack-advanced-exporter --input-archive export-with-emails.zip --output-archive export-with-emails-and-attachments.zip fetch-attachments --api-token <SLACK TOKEN>
84+
./slack-advanced-exporter --input-archive export-with-emails.zip --output-archive export-with-profile-pictures.zip fetch-attachments --api-token <SLACK TOKEN>
85+
./slack-advanced-exporter --input-archive export-with-profile-pictures.zip --output-archive export-with-everything.zip fetch-attachments --api-token <SLACK TOKEN>
8486
8587
.. note::
8688

87-
- The first command collects all of the user emails and creates the file ``export-with-emails.zip``. The second command fetches attachments and creates the file ``export-with-emails-and-attachments.zip``, which we will use going forward.
89+
- The first command collects all of the user emails and creates the file ``export-with-emails.zip``. The second command downloads the profile pictures and creates the file `export-with-profile-pictures.zip`. The third command fetches attachments and creates the file ``export-with-everything.zip``, which we will use going forward.
8890
- The second command can take a long time if you have a large number of file uploads. If it's interrupted, delete the file generated (if any), and start again.
8991

90-
The file ``export-with-emails-and-attachments.zip`` now contains all the information necessary to be imported into Mattermost.
92+
The file ``export-with-everything.zip`` now contains all the information necessary to be imported into Mattermost.
9193

92-
It's preferable to fetch e-mails first to avoid copying large attachments around. Make sure you choose different file names at each stage, as the tool does not support in-place modifications.
94+
It's preferable to fetch attachments last to avoid copying large attachments around. Make sure you choose different file names at each stage, as the tool does not support in-place modifications.
9395

9496
.. important::
9597

@@ -98,7 +100,7 @@ It's preferable to fetch e-mails first to avoid copying large attachments around
98100
4. Convert Slack import to Mattermost's bulk export format
99101
----------------------------------------------------------
100102

101-
Now that you have a Slack export file with emails and attachments, let's convert this information into Mattermost's bulk import format using the import preparation tool ``mmetl``. Download the latest release of ``mmetl`` for your `OS and architecture <https://github.com/mattermost/mmetl/releases/>`__. Run ``mmetl help`` to learn more about using the tool.
103+
Now that you have a Slack export file with emails, profile pictures and attachments, let's convert this information into Mattermost's bulk import format using the import preparation tool ``mmetl``. Download the latest release of ``mmetl`` for your `OS and architecture <https://github.com/mattermost/mmetl/releases/>`__. Run ``mmetl help`` to learn more about using the tool.
102104

103105
Next, run the following command to create a Mattermost bulk import file. Replace ``<TEAM-NAME>`` with the name of your team in Mattermost. Note that the name needs to be one word like "my-team".
104106

0 commit comments

Comments
 (0)