|
1 | | -This pull request solves the following problems: |
2 | | - |
3 | | -* Users who wish to deploy a N2 site without public management can do so easily. You just have an internal version with the management pack installed, and an external version without the management pack. |
4 | | - |
5 | | -* Users who store their websites in Git repositories won't have the bloat of a 5+ MB N2.zip file in their history every time they update N2CMS. |
6 | | - |
7 | | - |
8 | | -# N2CMS Developer Installation Instructions |
9 | | -(to be uploaded to wiki) |
10 | | - |
11 | | -First, download the release and extract to a path such as C:\N2Packages (this example path is used below) |
12 | | - |
13 | | -Next, decide whether you want to use the ZIP or NOZIP management packs. |
14 | | - |
15 | | -### Before doing anything listed on this page |
16 | | -*Back up your project before installing or uninstalling any N2CMS nuget packages*. |
17 | | - |
18 | | -### Which management pack should I choose? |
19 | | - |
20 | | -You can choose whichever management pack is right for you. Consider the following benefits and drawbacks. |
21 | | - |
22 | | -* The benefit of the ZIP management pack is that it is a single file for the N2 Management Interface. However, if you store your website in a source control depot (e.g. Git repo), you end up with a lot of bloat as the ~5 MB N2.zip file gets upgraded over time. You also need to upload the entire N2.zip when you update it. |
23 | | - |
24 | | -* The benefit of the NOZIP management pack is that you can take advantage of Web Deploy incremental uploads, as well as more efficient source control storage as the files are installed separately (not extracted). Additionally, the Zip Virtual Path Provider is not installed, which means that less memory is used by N2CMS. |
25 | | - |
26 | | - |
27 | | -### Switching Management Packs |
28 | | -You can switch management packs (e.g. ZIP to NOZIP or visa-versa) at any time by first *uninstalling* any current management pack, and then installing the desired management pack. |
29 | | - |
30 | | -### Multiple Management Packs |
31 | | -You MUST NOT install multiple management packs on your N2 installation. This is not supported and you will likely break your N2 installation. The only supported recourse in this situation is to *start a new project*! Back up your N2 installation before installing any management packs. |
32 | | - |
33 | | -### Upgrading from N2CMS 2.5 and earlier |
34 | | - |
35 | | - |
36 | | -``` |
37 | | -Uninstall-Package n2cms.dinamico |
38 | | -Uninstall-Package n2cms |
39 | | -Uninstall-Package n2cms.management |
40 | | -``` |
41 | | - |
42 | | -## Installation Instructions |
43 | | - |
44 | | -### Example: Dinamico Template Pack |
45 | | - |
46 | | -For the NOZIP option: |
47 | | -``` |
48 | | -Install-Package -Source C:\N2Packages -Name n2cms.dinamico |
49 | | -Install-Package -Source C:\N2Packages -Name n2cms.management.nozip |
50 | | -``` |
51 | | - |
52 | | -For the ZIP option: |
53 | | -``` |
54 | | -Install-Package -Source C:\N2Packages -Name n2cms.dinamico |
55 | | -Install-Package -Source C:\N2Packages -Name n2cms.management.zip |
56 | | -``` |
57 | | - |
58 | | -## Upgrading |
59 | | -You can upgrade just the management pack. The N2CMS libraries will be updated |
60 | | -automatically if required. You can also upgrade the template packs. Run the relevant |
61 | | -Install-Package command as listed above. |
62 | | - |
63 | | -``` |
64 | | -Install-Package -Source C:\N2Packages -Name n2cms.management.nozip |
65 | | -``` |
66 | | -OR |
67 | | -``` |
68 | | -Install-Package -Source C:\N2Packages -Name n2cms.management.zip |
69 | | -``` |
| 1 | +This pull request solves the following problems: |
| 2 | +
|
| 3 | +* Users who wish to deploy a N2 site without public management can do so easily. You just have an internal version with the management pack installed, and an external version without the management pack. |
| 4 | +
|
| 5 | +* Users who store their websites in Git repositories won't have the bloat of a 5+ MB N2.zip file in their history every time they update N2CMS. |
| 6 | +
|
| 7 | +
|
| 8 | +# N2CMS Developer Installation Instructions |
| 9 | +(to be uploaded to wiki) |
| 10 | + |
| 11 | +First, download the release and extract to a path such as C:\N2Packages (this example path is used below) |
| 12 | +
|
| 13 | +Next, decide whether you want to use the ZIP or NOZIP management packs. |
| 14 | +
|
| 15 | +### Before doing anything listed on this page |
| 16 | +*Back up your project before installing or uninstalling any N2CMS nuget packages*. |
| 17 | +
|
| 18 | +### Which management pack should I choose? |
| 19 | +
|
| 20 | +You can choose whichever management pack is right for you. Consider the following benefits and drawbacks. |
| 21 | +
|
| 22 | +* The benefit of the ZIP management pack is that it is a single file for the N2 Management Interface. However, if you store your website in a source control depot (e.g. Git repo), you end up with a lot of bloat as the ~5 MB N2.zip file gets upgraded over time. You also need to upload the entire N2.zip when you update it. |
| 23 | +
|
| 24 | +* The benefit of the NOZIP management pack is that you can take advantage of Web Deploy incremental uploads, as well as more efficient source control storage as the files are installed separately (not extracted). Additionally, the Zip Virtual Path Provider is not installed, which means that less memory is used by N2CMS. |
| 25 | +
|
| 26 | +
|
| 27 | +### Switching Management Packs |
| 28 | +You can switch management packs (e.g. ZIP to NOZIP or visa-versa) at any time by first *uninstalling* any current management pack, and then installing the desired management pack. |
| 29 | +
|
| 30 | +### Multiple Management Packs |
| 31 | +You MUST NOT install multiple management packs on your N2 installation. This is not supported and you will likely break your N2 installation. The only supported recourse in this situation is to *start a new project*! Back up your N2 installation before installing any management packs. |
| 32 | +
|
| 33 | +### Upgrading from N2CMS 2.5 and earlier |
| 34 | +
|
| 35 | +
|
| 36 | +``` |
| 37 | +Uninstall-Package n2cms.dinamico |
| 38 | +Uninstall-Package n2cms |
| 39 | +Uninstall-Package n2cms.management |
| 40 | +``` |
| 41 | +
|
| 42 | +## Installation Instructions |
| 43 | +
|
| 44 | +### Example: Dinamico Template Pack |
| 45 | +
|
| 46 | +For the NOZIP option: |
| 47 | +``` |
| 48 | +Install-Package -Source C:\N2Packages -Name n2cms.dinamico |
| 49 | +Install-Package -Source C:\N2Packages -Name n2cms.management.nozip |
| 50 | +``` |
| 51 | +
|
| 52 | +For the ZIP option: |
| 53 | +``` |
| 54 | +Install-Package -Source C:\N2Packages -Name n2cms.dinamico |
| 55 | +Install-Package -Source C:\N2Packages -Name n2cms.management.zip |
| 56 | +``` |
| 57 | +
|
| 58 | +## Upgrading |
| 59 | +You can upgrade just the management pack. The N2CMS libraries will be updated |
| 60 | +automatically if required. You can also upgrade the template packs. Run the relevant |
| 61 | +Install-Package command as listed above. |
| 62 | +
|
| 63 | +``` |
| 64 | +Install-Package -Source C:\N2Packages -Name n2cms.management.nozip |
| 65 | +``` |
| 66 | +OR |
| 67 | +``` |
| 68 | +Install-Package -Source C:\N2Packages -Name n2cms.management.zip |
| 69 | +``` |
0 commit comments